Content
88%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, highly actionable orchestration procedure with concrete commands, spawn templates, and a well-validated multi-case workflow including feedback loops and escalation paths. The main improvement areas are de-duplicating the repeated self-fix cap rules and clarifying where the sub-auditor category and gate definitions live.
Suggestions
State the self-fix iteration cap once (e.g. in the Self-fix policy table) and reference it from Step 3 and the Anti-patterns list instead of repeating it three times.
Point to the actual location of the sub-auditor definitions (e.g. .claude/agents/auditor-{be,fe,agentic}.md) or the gate category catalogs so 'Score against your N categories' is resolvable.
Move or link the 'Self-fix policy detallada' section adjacent to Step 3 Caso C, where the self-fix decision is made, rather than after Step 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and procedural with tables, bare commands, and no explanation of concepts Claude already knows, but the self-fix iteration cap is stated three times (Step 3 Caso C, 'Cap absoluto: 2 self-fix iter por ticket', and the Anti-patterns list) and the self-fix policy is split across two sections. This is efficient content with minor redundancy that could be trimmed — the 4 anchor, not the lean-every-token-counts 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: concrete bootstrap commands (git log, git diff HEAD~1 HEAD --stat), self-fix commands (ruff format, ruff check --fix, git add/commit/push), YAML ticket-state update snippets, and complete Agent spawn templates with prompts. Specific examples cover the common audit cases, matching the 5 anchor rather than the minor-gaps 4. | 5 / 5 |
Workflow Clarity | Steps 1-5 are clearly sequenced with explicit validation and feedback loops throughout: verdict processing split into four cases with iteration caps and escalation, a self-fix loop ('Re-correr quality gates → Si verde → APPROVED / Si falla → CHANGES_REQUESTED'), a dev fix → push → re-audit loop, and mandatory end-to-end verification before merge, plus an anti-patterns checklist. This matches the 5 anchor's explicit validation steps with error-recovery feedback loops. | 5 / 5 |
Progressive Disclosure | A well-sectioned single file with clear headers, no nested references, and detail appropriately delegated to sub-agent definitions. It falls short of the 5 anchor because the sub-auditor category catalogs ('11 categorías DDD/tenant/migrations/etc', '13 gates /test-backend') are only gestured at without pointing to where they are defined, and the 'Self-fix policy detallada' section is placed after Step 5 rather than near the Step 3 case it governs — minor organization gaps matching the 4 anchor. | 4 / 5 |
Total | 18 / 20 Passed |