docs: add GitHub Copilot App harness and restructure harnesses#143
Open
GeekTrainer wants to merge 1 commit into
Open
docs: add GitHub Copilot App harness and restructure harnesses#143GeekTrainer wants to merge 1 commit into
GeekTrainer wants to merge 1 commit into
Conversation
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
docs/Astro + Starlight wrapper).github/copilot-instructions.md, instructions, agents, skills)Verification
cd docs && rm -rf dist && npm run buildsucceeds (37 pages; page-count invariant holds at 36 routable mdx + 1 redirect)lint_partials.py,sync_partial_metadata.py --check)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 sharedprereqs.mdxbecomes 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 (gitrename-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:
_images/app-*.pngset replaces an earlier orphaned set; 21 now-unused images were deleted in the same change.github-samples/tailspin-toys@geektrainer/reimagined-goggles(static Astro 7 + Drizzle/libSQL). This PR is content-only and adds no application code.