Content
93%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 lean, project-specific guide that tells the agent exactly where to look, what to copy, and how to verify the result. It would be even stronger with a brief recovery note for when the visual check fails.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | "find the closest thing that already exists and copy it" assumes Claude's competence; every section carries only project-specific knowledge (component names, exact paths, commands) with no padding of concepts Claude already knows. | 5 / 5 |
Actionability | Exact paths ("packages/ui-react/src/", "web/node_modules/@gitbutler/ui-react/src/"), named tools (`docs-show`, the chromatic manifest URL) and a copy-paste command ("pnpm -F @gitbutler/lite demos") make the guidance fully executable, with a concrete fallback ("build the smallest thing that works and say so in the PR description"). | 5 / 5 |
Workflow Clarity | Sections run in workflow order (library → design pages → words → check) and end with an explicit checkpoint ("Look at the result in light and dark, and keep one screenshot"), but there is no recovery guidance if the check fails, so it falls short of the feedback-loop anchor 5. | 4 / 5 |
Progressive Disclosure | The body is an overview deferring detail to one-level-deep, well-signaled sources (library `src/`, the `DESIGN.md` index pages, Storybook) with explicit read-what-you-need guidance ("Read the pages for what you are building, not all of them"); no bundle files exist and nothing is inlined that belongs elsewhere. | 5 / 5 |
Total | 19 / 20 Passed |