Defame1297
54d7bd80ba
Closes the second open design decision on PR #103. The `/compact` finding was recorded as a false positive needing an allowlist or a suppression mechanism. It is neither: the routing universe is the apm marketplace, so a target either resolves to a skill or an agent or it does not resolve, and `/compact`, `/clear` and `/init` are Claude Code slash commands with no counterpart in Copilot CLI or Codex. `.apm/` source compiles for all three, so a vendor-neutral description routing to one is a portability defect and the hard FAIL is a true positive. An allowlist was rejected for a concrete reason, not a stylistic one: it answers a different question ("does this exist on some host?"), it cannot answer that portably from a single source file, and it goes stale the next time a host ships a command — reintroducing the same-commit-two-verdicts failure ADR-0020 already closed for deployed trees. Nothing is blocked today: zero of the 43 descriptions name a host built-in, and an author who needs to mention one writes it un-slashed, which is not route notation and carries no routing claim. Recorded in ADR-0020 and in both author-facing contract references, so the next agent reads the decision rather than "fixing" the gate. ADR: 0020 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
source_keys
| source_keys |
|---|
references/
create.md
The create flow, loaded from SKILL.md Step 1 when no agent file exists at the target path.
Covers: prerequisites, the scaffold script and its scope walk-up, what to fill in at every scope,
and populating or deleting the package-root sources.md.
improve.md
The improve flow, loaded from SKILL.md Step 1 when a file exists and at least one improvement signal is present. Covers: signal verification, partial-pair recovery, root-cause grouping, generalizing rather than patching, delegation over growth, and the ADR-0020 retrofit rule.
contract.md
The description and body contract, loaded from SKILL.md Step 3 before any description is written or any body restructured. Covers: the three-part description shape, banned description content, boundary-target resolution, the 250/400 length tiers, the body role-instruction pattern, the delegation rule that replaces a body word gate, and the invocation axis.
plugin-scope.md
Field rules and the pre-audit checklist for the single vendor-neutral .apm/agents/<name>.agent.md
file. Loaded from SKILL.md Step 2 when the scaffold resolves plugin/APM scope.
project-user-scope.md
Field rules and the pre-audit checklist for the Claude Code .md + Copilot .agent.md pair,
including the two distinct Copilot formats. Loaded from SKILL.md Step 2 when the scaffold resolves
project or user scope.
deployment-modes.md
Scope hierarchy and precedence, scoped identifiers for plugin subdirectory agents, cache isolation behaviour, and Copilot CLI path conventions. Loaded from SKILL.md Step 2 when precedence, paths or cache isolation matter to the run.
scripts.md
Conventions for the new-agent.sh scaffold script, the templates it copies, and any future script
in this skill. Loaded from create.md Step 1 when the script or a template has to change. Covers:
the no-interactive-prompts rule, structured output, idempotency, template variables, file
placement, error messages, and the no-restated-field-roster rule that tests/new-agent.bats
enforces.
sources.md
Research provenance record for this skill. Lists the upstream research sources
(claude-code-plugins and github-copilot-plugins research docs) that informed SKILL.md and the
reference files. Used by skill-audit to validate the provenance chain.