Content
88%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is an exemplary lean orchestration skill: a clearly numbered workflow with explicit user-approval checkpoints, concrete file-system deliverables, and well-signaled deferral of methodology detail to external guides. Its only weaknesses are that the planning substance lives entirely in the referenced guides and that reference paths are templated placeholders, leaving slight dependence on content outside this file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and instruction-dense: every paragraph carries directives ("Read these files in full", "Create `.apm/bus/<agent-slug>/`", "Keep each approval gate"), and the APM methodology background ("Workers do not read the Spec or Plan") is novel context Claude cannot know, not padding. This matches anchor 5 (lean, assumes competence, every token earns its place) rather than 4 because there is no over-explanation to trim. | 5 / 5 |
Actionability | Guidance is mostly executable: exact bus file structure ("empty `task.md`, `report.md` and `handoff.md`, and `.apm/bus/manager/` with only an empty `handoff.md`"), a named next skill ("invoking `apm-2-initiate-manager`"), and a concrete survey checklist (Git status, branches, `.apm/archives/`, `AGENTS.md`). It is anchor 4 rather than 5 because the planning substance itself is deferred to the external guides, so common-case coverage is not fully contained in this file. | 4 / 5 |
Workflow Clarity | The five numbered sections sequence Initiation → Workspace Survey → Planning → Completion → Subagents, with explicit stop-and-wait checkpoints at every phase transition ("end your message and wait for the reply", "wait for the User to approve each one before you start the next", "Keep each approval gate unless the User explicitly asks to skip it"). These approval gates are the explicit validation steps of anchor 5; no destructive or batch operation applies a cap. | 5 / 5 |
Progressive Disclosure | The file is a well-organized overview with purpose-annotated, one-level-deep references ("`{GUIDE_PATH:context-gathering}`: how to explore the workspace and question the User") and scoped reading guidance ("Read other APM files only when these files point you to them"). It is anchor 4 rather than 5 because the reference targets are unresolved template placeholders rather than verifiable paths, and reading chains through the guides; no bundle files are present to verify the structure against. | 4 / 5 |
Total | 18 / 20 Passed |