Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →donchitos/architecture-review
Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix mapping every GDD technical requirement to ADRs, identifies coverage gaps, detects cross-ADR conflicts, verifies engine compatibility consistency across all decisions, and produces a PASS/CONCERNS/FAIL verdict. The architecture equivalent of /design-review.
Passed 8 of 16 test cases with the skill, and 3 of 16 without it.
and 9 more in the full report
7 fixed4 passed either way12 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
This benchmark measured an earlier version of the skill.
A newer attempt on gemini-3.8-flash on 10/19/2026 did not produce a publishable comparison (not comparable). The snapshot above is the previously measured run.
One of 7 test cases the skill fixed. Same model, same prompt, with and without the skill.
After completing the review and saving the report, we need to record session state in production/session-state/active.md. What section header and fields should be appended?
| Checked | Without skill | With skill |
|---|---|---|
| Appends a section starting with ## Session Extract — /architecture-review to production/session-state/active.md. | Missed | Passed |
| Includes fields for Verdict, Requirements counts, New TR-IDs registered, GDD revision flags, Top ADR gaps, and Report path. | Missed | Passed |
The instructions your model reads when the skill loads.
!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys automation,workflow
The architecture review validates that the complete body of architectural decisions covers all game design requirements, is internally consistent, and correctly targets the project's pinned engine version. It is the quality gate between Technical Setup and Pre-Production.
Argument modes:
full: Full review — all phasescoverage: Traceability only — which GDD requirements have no ADRconsistency: Cross-ADR conflict detection onlyengine: Engine compatibility audit onlysingle-gdd [path]: Review architecture coverage for one specific GDDrtm: Requirements Traceability Matrix — extends the standard matrix
to include story file paths and test file paths; outputs
docs/architecture/requirements-traceability.md with the full
GDD requirement → ADR → Story → Test chain. Use in Production phase when
stories and tests exist.Every AskUserQuestion call follows .claude/docs/automation-modes.md
(collaborative asks always · guided major-only · autonomous logs and proceeds;
automation_always_ask categories always prompt).
workflow (see .claude/docs/workflow-modes.md):
full — full traceability matrix across all GDDs and all ADRs.standard — reduced scope: architecture doc + critical ADRs only.minimal — not applicable (no architecture doc required).Read references/1-load.md now and follow it — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase.
Read references/2-extract-requirements.md now and follow it — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase.
test cases passed, vs 3 / 16 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.