Content
92%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.
The content is highly actionable and well-structured, with a clear phased workflow, mandatory gates, validation checkpoints, and a clean progressive-disclosure layout pointing to five real reference files. The only weakness is mild verbosity and some redundancy between the inline summary tables and the reference files.
Suggestions
Tighten the inline Complementary Tools, Bias Awareness, and Problem Decomposition tables to a single reference line each, since each already has a dedicated reference file, to reduce redundancy and token cost.
Trim the 'How to identify axioms' and axiom-definition prose, which explains concepts Claude already understands, in favor of the concrete gate criteria.
Consider moving the Trellis Integration section into a reference file, as it is project-specific and inflates the body for users not on a Trellis-managed project.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient prose with actionable structure, but at roughly 400 lines it includes some redundancy (e.g., Complementary Tools, Bias, and Decomposition tables that summarize material also covered in the reference files) and light over-explanation of concepts like what an axiom is. | 4 / 5 |
Actionability | Provides copy-paste-ready templates (axiom block, assumption table, reasoning chain, full output format) with concrete examples and explicit minimum-depth requirements per phase, leaving no ambiguity about what to produce. | 5 / 5 |
Workflow Clarity | A clearly sequenced 6-phase process with mandatory phase gates, a phase-artifact table, an anti-drift progress tracker, and an explicit validation checkpoint (3 questions plus a stress-test) that forms a feedback loop ensuring no phase is skipped. | 5 / 5 |
Progressive Disclosure | The body acts as an overview that is well-organized into labeled sections and signals one-level-deep references (e.g., '> Deep methodology: references/axiom-based-reasoning.md'); all five referenced files exist on disk and are indexed in a closing reference table, making navigation easy. | 5 / 5 |
Total | 19 / 20 Passed |