Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable body with a clear sequenced workflow and validation checkpoints; its only real weakness is progressive disclosure, where the repeatedly-referenced RECIPES.md bundle file is missing.
Suggestions
Add the missing RECIPES.md bundle file (or remove the RECIPES.md links and inline the promised CI-gate, multi-turn-driver, diff-review, and structured-output patterns), so the signaled one-level-deep references actually resolve.
Remove the duplicated stream-capture tip (it appears in both Quick start and Output contract) to save tokens without losing clarity.
Tighten the 'When to reach for it' section, whose example prompts and trigger framing largely restate the frontmatter description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout — install check, preflight, quick-start command, an output-contract table, and a flags list — assuming Claude's competence and avoiding explanations of concepts Claude already knows. Minor repetition of the stream-capture tip and some value-prop prose keeps it just at level-3 rather than the padded level-1 or loosely-tightened level-2. | 3 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands — the install one-liner, `fractal -p "..." --workspace /path`, `docker info`, `fractal config status`, `git diff | fractal -p "review this diff"`, and concrete flag syntax — matching the level-3 'fully executable, copy-paste ready' anchor. | 3 / 3 |
Workflow Clarity | Sections form a clear sequence (Install → Preflight → Quick start → Output contract → Flags → Tips) with explicit validation checkpoints in Preflight ('docker info >/dev/null || echo ...', 'fractal config status') and exit-code semantics as a feedback loop; operations are not destructive/batch so the level-2 cap does not apply. | 3 / 3 |
Progressive Disclosure | The body is well-organized and defers detail to a one-level-deep, clearly signaled `[RECIPES.md](RECIPES.md)` reference, but RECIPES.md is not present in the bundle, so the signaled navigation is broken — landing it at level-2 ('references present but ... could be better organized') rather than the clean level-3 'easy navigation' anchor. | 2 / 3 |
Total | 11 / 12 Passed |