Content
100%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 body is a dense, expert-level reference: every line carries a footgun, an exact value, or a validated command, and it explicitly avoids teaching what the model already knows. Multi-step XML editing and verification workflows include explicit validation checkpoints and repair loops, and all referenced bundle scripts exist exactly at the stated paths. No verbosity, pseudocode, or nested-reference issues were found.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body states 'The model knows the API; these are the footguns' and delivers exactly that — only non-obvious knowledge (DXA width values, 'ShadingType.CLEAR, never SOLID', '<w:delText>, not <w:t>', pdftoppm zero-padding) with zero filler across ~90 lines. Matches the 5 anchor ('every token earns its place'); the 4 anchor's 'minor instances of over-explanation' is not met. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: the complete edit pipeline ('unzip -q doc.docx -d unpacked/' … 'zip -Xr ../out.docx .', 'python scripts/merge_runs.py unpacked/'), the verification commands, and exact API values ('WidthType.DXA', 'LevelFormat.BULLET', 'PositionalTabAlignment.RIGHT'). Matches the 5 anchor. | 5 / 5 |
Workflow Clarity | A task-routing table sends each task type down a workflow with explicit validation and feedback loops: 'Verify the output' renders to PDF and reads page images for creation, and the edit pipeline embeds 'validate.py out.docx --original' with '--auto-repair fixes common issues' and a '--author' redline check for tracked changes. Matches the 5 anchor ('explicit validation steps; feedback loops for error recovery') — the XML-manipulation feedback-loop requirement is satisfied. | 5 / 5 |
Progressive Disclosure | The body is a lean overview that defers machinery to real, verified, one-level-deep bundle scripts (scripts/merge_runs.py, scripts/accept_changes.py, scripts/comment.py, scripts/office/soffice.py, scripts/office/validate.py all exist), with OOXML schemas and validators kept entirely out of the body. Matches the 5 anchor ('well-signaled one-level-deep references; content appropriately split'). | 5 / 5 |
Total | 20 / 20 Passed |