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 concrete code, commands, APIs, and a sequenced workflow with verification, but it is weakened by restated rules and by broken detailed-reference links — the core rules/*.md files it repeatedly points to are absent from the bundle.
Suggestions
Create the missing ./rules/creation-flow.md, ./rules/typing.md, and ./rules/composition.md files (or remove the references and inline the essential content), since three of the four detailed-reference links the body promises currently resolve to nothing.
Consolidate the Slate-first directive and KEYS guidance, which are restated across Principles, Critical Rules, Hard Law, and Do Not Copy, into one authoritative location to tighten token efficiency.
Verify each link target against the actual bundle before finalizing, so the 'Detailed References' section only lists files that exist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | It assumes Claude's intelligence with no concept-explanation padding, but the Slate-first directive and KEYS guidance are restated across Principles, Critical Rules, Hard Law, and Do Not Copy, so it could be tightened; this fits 'mostly efficient but could be tightened' rather than 'every token earns its place'. | 2 / 3 |
Actionability | Provides copy-paste-ready TS patterns (e.g. `createTSlatePlugin<BaseCommentConfig>({ key: KEYS.comment }).extendApi(...)`), concrete commands (`pnpm brl`), specific APIs (`toPlatePlugin`, `configurePlugin`, `inject.nodeProps.transformProps`), and exact file paths (`packages/utils/src/lib/plate-keys.ts`). | 3 / 3 |
Workflow Clarity | A 7-step numbered Workflow ends in an explicit verification step ('Verify the smallest honest surface: package tests, type tests, React tests'), and the barrel rule supplies a feedback loop ('If pnpm brl produces a broken barrel, fix the barrel generator/config or file placement'), plus a derived checklist. | 3 / 3 |
Progressive Disclosure | Structure and signaling are good (one-level-deep links under 'Creation Flow →', 'Typing & Context →', 'Composition & API Shape →', 'Detailed References'), but three of the four referenced detail files (./rules/creation-flow.md, ./rules/typing.md, ./rules/composition.md) do not exist in the bundle, so the navigation is broken and cannot score 3. | 2 / 3 |
Total | 10 / 12 Passed |