From d79df25e39d4321b137a5bcf5b5421438fefbd4b Mon Sep 17 00:00:00 2001 From: GitHub Copilot Date: Sat, 11 Apr 2026 03:36:41 +0000 Subject: [PATCH] docs: clarify that dependency packages are scanned for both .apm/ and .github/ layouts during compile Update the compilation guide's 'How It Works' section to explicitly document that apm compile scans each installed package for primitives in both .apm/instructions/ and .github/instructions/ (and other subdirs), so package authors know both layouts are supported. Triggered by #642 fix: apm compile --target claude was silently skipping dependency instructions stored in .github/instructions/ before this PR. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/src/content/docs/guides/compilation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/content/docs/guides/compilation.md b/docs/src/content/docs/guides/compilation.md index 23de213bf..86b0a5412 100644 --- a/docs/src/content/docs/guides/compilation.md +++ b/docs/src/content/docs/guides/compilation.md @@ -57,7 +57,7 @@ target: copilot # or vscode, claude, codex, or all ### How It Works 1. **Primitives Discovery**: Scans `.apm/` and `.github/` directories for instructions, prompts, and agents -2. **Dependency Merging**: Incorporates primitives from installed packages in `apm_modules/` +2. **Dependency Merging**: Incorporates primitives from installed packages in `apm_modules/`; each package is scanned for both `.apm/` and `.github/` layouts (e.g. `.apm/instructions/` and `.github/instructions/` are both discovered) 3. **Optimization**: Applies mathematical context optimization (see below) 4. **Format Generation**: Outputs native files for each target agent format