Skip to content

feat(apm): add APM spotlight and learning references#33

Open
jonmagic wants to merge 2 commits intomainfrom
feat/apm-spotlight
Open

feat(apm): add APM spotlight and learning references#33
jonmagic wants to merge 2 commits intomainfrom
feat/apm-spotlight

Conversation

@jonmagic
Copy link
Copy Markdown
Collaborator

@jonmagic jonmagic commented Mar 12, 2026

Summary

  • add APM coverage to the site while keeping AI primitives as the primary homepage story
  • replace the original full-width homepage spotlight with a compact hero callout and a dedicated /apm page
  • extend navigation, generated llms docs, and e2e coverage to include the new APM page and flow
CleanShot 2026-03-12 at 15 20 11@2x

What Changed

  • homepage: remove the standalone APM section so primitives stay first, then add a lighter hero-level APM teaser
  • apm page: add a dedicated guide covering what APM is, why it matters, how it relates to primitives, and when to use it
  • docs/tests: regenerate llms.txt + llms-full.txt, generate apm.md, and add navigation/accessibility coverage for /apm
CleanShot 2026-03-12 at 15 20 24@2x

Testing

  • bun run lint
  • bun run typecheck
  • bun run build
  • bun run test

GitHub Copilot 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.
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 /apm page (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.

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.

2 participants