Content
71%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.
A well-structured operational skill with concrete commands, explicit validation gates, and strong error-recovery guidance; its main weaknesses are a muddled, example-less entry-point step and a Templates section whose links are broken in the actual bundle. Most dimensions land at 4, with progressive disclosure pulled to 3 by the dead template paths.
Suggestions
Ship the templates directory in the bundle (or repoint the Templates section to files that exist), since `templates/task_plan.md`, `templates/findings.md`, and `templates/progress.md` are all dead links in the current bundle.
Add a concrete example invocation for `scripts/resolve-plan-dir.sh`/`.ps1` with `PLAN_ID` and `PWF_PLAN_ROOT` — it is the first commanded step but the only helper with no shown command.
Tighten the redundancy between 'The Core Pattern', 'File Purposes', and the '5-Question Reboot Test', which restate the same persistence philosophy three times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven ('File Purposes', 'Read vs Write Decision Matrix', 'Anti-Patterns') with almost no explanation of concepts Claude already knows, though 'The Core Pattern' RAM/disk metaphor and the '5-Question Reboot Test' overlap enough with the File Purposes table that they could be trimmed. This sits at 'efficient; minor instances of over-explanation', not 5, because a few sections restate the same persistence philosophy three ways. | 4 / 5 |
Actionability | Mostly executable guidance: copy-paste-ready invocations are given for `session-catchup.py --metadata` (bash and PowerShell), `init-session.sh`, `check-complete.sh --validate`, and `set-active-plan.sh --list`, plus exact format rules ('Keep each phase as `### Phase N: Name` with exactly one `**Status:**` line'). It falls short of 5 because the very first instructed action — 'Use the installed `scripts/resolve-plan-dir.sh` (or `.ps1`) with the host's `PLAN_ID` and `PWF_PLAN_ROOT`' — never shows a concrete example command, leaving the entry-point step as high-level direction. | 4 / 5 |
Workflow Clarity | The Quick Start sequence (restore before create, preserve markers, re-read before decisions, one plan owner), the creation contract with 'Validation must succeed before substantive work and after changing phase structure', the 3-Strike escalation protocol, and error-logging rules give a clear sequence with most checkpoints present. Not 5 because the FIRST section — the actual entry point — packs plan resolution, catchup, parallel-host pinning, and orchestrator/worker roles into one paragraph with implicit checkpoints, and the destructive archive operation's guard ('Never archive on age or completion alone') relies on prose rather than an explicit validate step. | 4 / 5 |
Progressive Disclosure | The section structure is good and references are one level deep and clearly signaled ('Manus Principles: See references/reference.md', 'Real Examples: See references/examples.md', plan-inventory.md), and all three referenced `references/` files exist in the bundle. But scored against the actual bundle, the Templates section's links to `templates/task_plan.md`, `templates/findings.md`, and `templates/progress.md` are dead — no `templates/` directory ships in the bundle — so half of the body's file references point at nonexistent paths while the text says 'Copy these templates to start'. That is more than the 'minor organization gaps' of anchor 4; not 2 because the in-body content is well placed and the existing references are properly signaled. | 3 / 5 |
Total | 15 / 20 Passed |