Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable commands, explicit validation checkpoints, and a well-sequenced multi-step workflow with feedback loops. Its main weakness is conciseness/progressive disclosure: a long monolithic file with some repeated constraints that could be tightened and split into reference files.
Suggestions
Consolidate the repeated planning-mode constraints spread across 'Hard Rules', 'Start Gates', 'Completion Gates', and per-command 'must not' lists into a single source of truth to reduce length and redundancy.
Extract the detailed per-command references (status, apply, dashboard, review) into one-level-deep bundle files (e.g. references/status.md, references/apply.md) signaled from the overview, turning the monolith into a navigable overview-plus-references structure.
Replace the absolute local filesystem links to autogoal and task skills with relative bundle paths so the skill's cross-references are portable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and policy-heavy without concept-teaching padding (no 'what a PDF is' style explanation), but at ~1200 lines it repeats the same constraints across 'Hard Rules', 'Start Gates', 'Completion Gates', and per-command 'may/must not' lists, which could be tightened. It is not a 1 because it does not explain known concepts or pad with fluff, and not a 3 because the redundancy and length exceed a lean every-token-earns-its-place standard. | 2 / 3 |
Actionability | Provides concrete, copy-paste-ready bash/node commands throughout (status JSON reads, ref resolution, run-dir creation, capped git diff/log commands, create-goal-scratchpad.mjs and check-complete.mjs invocations) plus explicit payload and plan-template shapes. Matches the 'fully executable code/commands; specific examples; copy-paste ready' anchor, so it is not a 2. | 3 / 3 |
Workflow Clarity | A clearly numbered 7-step process with explicit validation checkpoints ('prove ancestry', 'Only proceed when valid', Start/Completion Gates, check-complete.mjs) and feedback loops (review staleness verdicts, fix-and-revalidate, plan-then-stop-for-user-review boundary). Matches the 'clear sequence with explicit validation steps; feedback loops for error recovery' anchor, so it is not a 2. | 3 / 3 |
Progressive Disclosure | Sections are well-organized with clear navigation (Commands, Scoped Planning, per-command sections, Hard Rules, Gates, steps 1-7, Output) and there are no 2+-level nested reference chains, but no bundle files exist and the body is a single ~1200-line monolith whose detailed per-command sections could be split into one-level-deep reference files. It is not a 1 because organization and navigation are present, and not a 3 because content is not split across well-signaled one-level-deep files. | 2 / 3 |
Total | 10 / 12 Passed |