[docs] Update documentation for features from 2026-05-01 by danielmeppiel · Pull Request #1095 · microsoft/apm

danielmeppiel · 2026-05-01T12:57:00Z

Documentation Updates - 2026-05-01

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

apm compile -t copilot now emits .github/copilot-instructions.md from global instructions (from fix(compile): emit and clean up copilot root instructions (#792) #1067)

Changes Made

Updated docs/src/content/docs/guides/compilation.md:
- Target auto-detection table: copilot row now shows both AGENTS.md and .github/copilot-instructions.md
- Output Files table: updated copilot entry to include .github/copilot-instructions.md
- Added explanatory note: global instructions (no applyTo) go to .github/copilot-instructions.md; per-pattern instructions continue to flow into .github/instructions/*.instructions.md; generated files carry a build-id marker for safe cleanup
- Example Output: updated the example directory tree to show the new file
- Tool Compatibility table: updated GitHub Copilot row to reflect new compile output

Merged PRs Referenced

fix(compile): emit and clean up copilot root instructions (#792) #1067 - fix(compile): emit and clean up copilot root instructions
feat(marketplace): harden apm pack output (#1061) #1063 - feat(marketplace): harden apm pack output (marketplace-authoring.md was already up to date)
test(windows): fix CLAUDE_CONFIG_DIR scope tests on Windows #1086 - test(windows): fix CLAUDE_CONFIG_DIR scope tests on Windows (test-only, no doc change needed)
fix: remove Codex-only user-visible hint on opt-in miss (vendor-neutrality) #1083 - fix: remove Codex-only user-visible hint on opt-in miss (internal behavior, no doc change needed)
docs(authors): show maintainer affiliations and link contributor graph #1090 - docs(authors): show maintainer affiliations and link contributor graph (AUTHORS file, no guide doc change needed)
docs(notice): rename NOTICE.md -> NOTICE; add CLA third-party section #1073 - docs(notice): rename NOTICE.md -> NOTICE; add CLA third-party section (legal file, no guide doc change needed)
fix: extend explicit UTF-8 encoding to 5 remaining open() call sites #1068 - fix: extend explicit UTF-8 encoding to 5 remaining open() call sites (bug fix for Windows, no doc change needed)

Notes

The marketplace-authoring.md guide was already up to date with the new fields added in #1063 (author, license, repository, keywords, pluginRoot subtraction, curator-wins override semantics). No changes were needed there.

Note

🔒 Integrity filter blocked 13 items

The following items were blocked because they don't meet the GitHub integrity level.

#1084 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#1055 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#1052 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#1048 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#1034 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#1024 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#991 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#959 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#951 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#947 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#941 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#937 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
#871 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Daily Documentation Updater · ● 1.4M · ◷

To install this agentic workflow, run
gh aw add githubnext/agentics/workflows/daily-doc-updater.md@b87234850bf9664d198f28a02df0f937d0447295
expires on May 3, 2026, 12:56 PM UTC

… compile apm compile -t copilot now synthesizes .github/copilot-instructions.md from global (no applyTo) instructions in .apm/instructions/. Update: - Target auto-detection table - Output Files table and notes - Example Output section - Tool Compatibility table Closes reference to #1067. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Updates the Starlight compilation guide to reflect the recently-merged change where apm compile -t copilot can emit .github/copilot-instructions.md from global (no-applyTo) instructions, aligning docs with current Copilot compilation behavior.

Changes:

Update target auto-detection + output tables to include .github/copilot-instructions.md for the copilot target.
Add a note explaining how global vs per-pattern instructions are routed for Copilot and how generated files are safely cleaned up.
Update the example output tree and the tool compatibility table to mention the new file.

Show a summary per file

File	Description
docs/src/content/docs/guides/compilation.md	Documents Copilot root instructions emission (`.github/copilot-instructions.md`) as part of `apm compile` output.

Copilot's findings

Files reviewed: 1/1 changed files
Comments generated: 2

Copilot · 2026-05-01T13:01:49Z

-├── AGENTS.md              # Instructions only (for Copilot, Cursor, etc.)
-└── CLAUDE.md              # Instructions only (for Claude)
+├── AGENTS.md                          # Instructions (for Copilot, Cursor, etc.)
+├── CLAUDE.md                          # Instructions (for Claude)


The example is labeled as a copilot-target compile, but it shows CLAUDE.md being generated as well. CLAUDE.md is only produced when the target includes claude (or auto-detection resolves to all). Please either remove CLAUDE.md from this tree or change the caption to reflect a multi-target/all compile.

Suggested change

├── CLAUDE.md # Instructions (for Claude)

Copilot · 2026-05-01T13:01:49Z

@@ -62,6 +62,8 @@ target: [claude, copilot]  # multiple targets -- only these are compiled

 > **Aliases**: `vscode` and `agents` are accepted as aliases for `copilot`.

+> **Note**: For the `copilot` target, instructions without an `applyTo` pattern (global instructions) are also synthesized into `.github/copilot-instructions.md`. Instructions with `applyTo` patterns continue to flow into per-pattern `.github/instructions/*.instructions.md` files. The generated `.github/copilot-instructions.md` carries a build-id marker so `apm compile` can cleanly remove it when switching to a non-Copilot target -- manually-authored files at the same path are preserved.
+


The tables/readme-style text imply .github/copilot-instructions.md is always generated for the copilot target, but the compiler only writes it when there is at least one global instruction (no applyTo); otherwise it will remove a previously-generated file. Consider annotating the table entry (and/or the note) with this condition so users don't expect the file to appear in projects that only use per-pattern instructions.

Copilot AI review requested due to automatic review settings May 1, 2026 12:57

danielmeppiel requested a review from sergio-sisternes-epam as a code owner May 1, 2026 12:57

danielmeppiel added automation Deprecated: use type/automation. Kept for issue history; will be removed in milestone 0.10.0. documentation Deprecated: use type/docs. Kept for issue history; will be removed in milestone 0.10.0. labels May 1, 2026

Copilot started reviewing on behalf of danielmeppiel May 1, 2026 12:57 View session

Copilot AI reviewed May 1, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[docs] Update documentation for features from 2026-05-01#1095

[docs] Update documentation for features from 2026-05-01#1095
danielmeppiel wants to merge 1 commit intomainfrom
docs/daily-update-2026-05-01-36a028889ed97f2a

danielmeppiel commented May 1, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI May 1, 2026

Uh oh!

Copilot AI May 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		@@ -62,6 +62,8 @@ target: [claude, copilot] # multiple targets -- only these are compiled

		> Aliases: `vscode` and `agents` are accepted as aliases for `copilot`.

		> Note: For the `copilot` target, instructions without an `applyTo` pattern (global instructions) are also synthesized into `.github/copilot-instructions.md`. Instructions with `applyTo` patterns continue to flow into per-pattern `.github/instructions/*.instructions.md` files. The generated `.github/copilot-instructions.md` carries a build-id marker so `apm compile` can cleanly remove it when switching to a non-Copilot target -- manually-authored files at the same path are preserved.

Conversation

danielmeppiel commented May 1, 2026

Documentation Updates - 2026-05-01

Features Documented

Changes Made

Merged PRs Referenced

Notes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Copilot's findings

Uh oh!

Copilot AI May 1, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI May 1, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants