Skip to content

docs: add GitHub Copilot App harness and restructure harnesses#143

Open
GeekTrainer wants to merge 1 commit into
refactor/relocate-content-and-author-docsfrom
geektrainer/copilot-app-course-plan
Open

docs: add GitHub Copilot App harness and restructure harnesses#143
GeekTrainer wants to merge 1 commit into
refactor/relocate-content-and-author-docsfrom
geektrainer/copilot-app-course-plan

Conversation

@GeekTrainer

Copy link
Copy Markdown
Collaborator

Summary

Adds a new GitHub Copilot App learning path (9 lessons) and restructures the existing harnesses so each opens with its own prerequisites lesson. The App path mirrors the Copilot CLI flow a learner already knows, then layers in the features unique to the app so beginners can follow a familiar arc.

Type of change

  • Workshop content (lesson MDX, partials, images)
  • Site shell (docs/ Astro + Starlight wrapper)
  • Copilot configuration (.github/copilot-instructions.md, instructions, agents, skills)
  • Repo housekeeping (CI, dependabot, README, license)
  • Other:

Verification

  • cd docs && rm -rf dist && npm run build succeeds (37 pages; page-count invariant holds at 36 routable mdx + 1 redirect)
  • Lychee link check passes (0 errors)
  • Partial guardrails pass (lint_partials.py, sync_partial_metadata.py --check)
  • External GitHub URLs that I changed have been clicked manually (lychee runs offline)

Screenshots

The App lessons reference 11 captured screenshots under docs/src/content/docs/_images/app-*.png (template creation, session start, review panel, terminal, new-session-from-issue, Plan mode, change selection, enable Agent merge, and the Agent merge dropdown).

Notes for reviewers

What's new — the App harness (Ex 0-8): Prerequisites (install Node.js, create the repo from the template), install the app and start a session against the repo, add a star rating, guide Copilot with custom instructions from the seeded issue, build category/publisher filtering from the feature-request issue (running tests via the agent skill), manually test with the Playwright MCP server, merge with Agent Merge, plan with a shared Kanban canvas, and a closing review. The flow deliberately tracks the CLI path so the app-specific concepts (sessions-from-issues, Plan/Autopilot modes, Agent Merge, canvases) are the only new surface area.

Restructure: Every harness now opens with its own 0-prerequisites.mdx; the old shared prereqs.mdx becomes a full-HTML redirect (src/pages/shared/0-prereqs.astro) so the legacy URL still resolves and stays Pagefind-indexable. CLI and VS Code lessons were renumbered (git rename-tracked) to match. The Playwright MCP exercise is shared across paths, and the landing pages/sidebar were updated to surface each harness's core landing page first.

Surprising bits worth a look:

  • The app _images/app-*.png set replaces an earlier orphaned set; 21 now-unused images were deleted in the same change.
  • One unverified assumption: the seeded issue titles referenced in the App lessons (custom-instructions and filtering) were aligned to the backlog wording in Lesson 1. I could not confirm them against a freshly seeded template repo, since seeding happens via an external/org action rather than a workflow in the template. Worth a spot-check.
  • The demo app the App lessons target lives on github-samples/tailspin-toys@geektrainer/reimagined-goggles (static Astro 7 + Drizzle/libSQL). This PR is content-only and adds no application code.

Add a new GitHub Copilot App learning path (9 lessons, Ex 0-8) that mirrors
the Copilot CLI flow while introducing app-specific features: sessions from
issues, Plan/Autopilot modes, Playwright MCP manual testing, the agent skill
for running tests, Agent Merge, and canvases.

Restructure all harnesses to use per-harness prerequisites (each opens with
its own 0-prerequisites lesson) and rename CLI/VS Code lessons so numbering
matches the new flow. Replace the shared prereqs page with a redirect, refresh
shared partials and landing pages, and align the Playwright MCP exercise across
paths. Update authoring docs, skills, and instruction files to match, and prune
unused images.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant