feat(apm): add APM spotlight and learning references#33
Open
feat(apm): add APM spotlight and learning references#33
Conversation
added 2 commits
March 12, 2026 13:02
Highlight APM as an emerging packaging layer for agent primitives and connect it to the existing skills, agents, and MCP tutorials. This makes the site more useful for teams evaluating how to distribute and version agent configuration beyond individual files.
Keep the homepage focused on primitives by replacing the full APM section with a compact hero callout. Add a dedicated /apm page so the packaging story has room to explain how APM relates to skills, instructions, and MCP without pushing the core homepage content too far down.
There was a problem hiding this comment.
Pull request overview
Adds first-class Agent Package Manager (APM) coverage to the static site while keeping AI primitives as the primary homepage story, and extends generated LLM docs + e2e coverage accordingly.
Changes:
- Adds a dedicated
/apmpage (new Vite multi-page entry + new Preact page/component + APM tutorial data). - Updates homepage hero/navigation to surface APM as a top-level destination.
- Regenerates LLM-facing docs (
llms*.txt,apm.md) and expands Playwright navigation/accessibility coverage for the new page.
Reviewed changes
Copilot reviewed 24 out of 24 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| site/vite.config.ts | Adds apm/index.html as a new multi-page build entry. |
| site/apm/index.html | New static entry HTML for the /apm/ page (SEO/meta + module entry). |
| site/src/pages/apm.tsx | New Preact entrypoint that renders ApmPage. |
| site/src/components/ApmPage/ApmPage.tsx | Implements the new APM guide page layout/content blocks. |
| site/src/data/apmTutorial.ts | Adds TOC items, code samples, and further-reading data for APM. |
| site/src/components/Navigation/Navigation.tsx | Adds APM as a top-level nav item. |
| site/src/components/Hero/Hero.tsx | Adds a compact hero callout linking to the APM guide. |
| site/src/data/pages.ts | Registers the APM page for LLM doc generation and renumbers parts. |
| .github/skills/generate-llms/scripts/generate-llms-full.ts | Extends LLM doc generation to import/include and emit apm.md + APM section in llms-full.txt. |
| site/tests/e2e/navigation.spec.ts | Adds nav visibility + navigation test coverage for /apm/ and mobile menu. |
| site/tests/e2e/accessibility.spec.ts | Adds Axe scan coverage for the /apm/ page. |
| site/tests/e2e/app.spec.ts | Updates homepage expectations to include the new “Explore APM” hero link. |
| site/tests/e2e/fileTree.spec.ts | Aligns copy-button assertion with the button’s accessible name. |
| site/src/data/skillsTutorial.ts + site/public/skills.md | Adds “Packaging and Distribution” section tying skills to APM. |
| site/src/data/mcpTutorial.ts + site/public/mcp.md | Adds APM to MCP further-reading references. |
| site/src/data/agentsTutorial.ts + site/public/agents.md | Adds APM to Agents further-reading references. |
| site/public/llms.txt / site/public/llms-full.txt / site/public/apm.md | Regenerated LLM documentation to include APM page and content. |
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
/apmpageWhat Changed
llms.txt+llms-full.txt, generateapm.md, and add navigation/accessibility coverage for/apmTesting