Content
100%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 a model of progressive disclosure: an intent routing table, a lean quick-spine for the most common path with concrete detach/wait commands and an explicit input-validation gate, targeted gotchas (scope fallback semantics, outcome vs. completion), and clearly signaled one-level-deep references. It teaches only what is Archon-specific and assumes competence elsewhere.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | 98 lines covering five capabilities with zero explanation of concepts Claude already knows — it never defines what a workflow, CLI, or worktree is. Every section carries archon-specific commands, flags, or behavioral rules (e.g., "treat `descriptionTruncated: true` as an explicit signal"); the few rhetorical flourishes ("at full price") are attached to hard rules and justify them rather than pad. This matches the lean/assumes-competence anchor, not the 4-anchor's trimmable over-explanation. | 5 / 5 |
Actionability | Fully executable commands with flags for the dominant case: "archon workflow run <workflow> --branch <branch-name> \"<the work, as a clear message>\" --detach", plus "archon workflow list --json", "archon workflow list <name> --full", "archon workflow runs --json", "archon workflow wait <run-id> --json", "archon workflow get <run-id> --json". Copy-paste ready with specific guidance on when each applies ("wait" as a background task, "get" for on-demand state, not a polling loop). | 5 / 5 |
Workflow Clarity | The quick spine is a clear six-step sequence with an explicit pre-launch validation checkpoint ("Check the input before spending anything... If any is missing, say which, propose a corrected input, and get the user's agreement before launching. Do not silently improve it, and do not launch anyway") and a post-run verification step ("A completed run does not mean the work succeeded. Use `workflow get <run-id> --json` for the normalized `outcome`"). Validation is present, so no cap applies; the error-recovery loop (propose corrected input → user agreement) satisfies the 5-anchor. | 5 / 5 |
Progressive Disclosure | A routing table up front maps all five intents to one-level-deep reference files ("running-workflows/running-workflows.md", "manage-run/manage-runs.md", "setup-and-config/setup-and-config.md", "authoring-workflows/authoring-workflows.md", "prompting-mistakes/prompting-mistakes.md"), reinforced by a Resources section annotating each file's purpose — matching the clear-overview/well-signaled anchor. No bundle files were provided to verify, and the only nit is that authoring's "node-reference.md" appears in the routing table but not in the Resources list, which is too small to drop to the 4-anchor's "minor organization gaps". | 5 / 5 |
Total | 20 / 20 Passed |