architecture-review

architecture-review is a skill for Claude Code from visionTw/godot-ai-harness. It costs 71 tokens per session (5,924 once invoked), scanned A, a copy of architecture-review, MIT.

A review of whether a game's technical decisions cover its design requirements and agree with one another. It also checks that the decisions fit the project's chosen game-engine version.

In plain words
What is it for?
Building a map from game-design requirements to technical decisions, checking conflicts or engine compatibility, reviewing one design document, and extending the map to stories and tests.
Why use it?
It exposes requirements with no technical plan, conflicts between decisions, and compatibility risks before development depends on them.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: model in frontmatter; names the AskUserQuestion tool.

Good fit Building a map from game-design requirements to technical decisions, checking conflicts or engine compatibility, reviewing one design document, and extending the map to stories and tests.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/visiontw/godot-ai-harness/architecture-review
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add visionTw/godot-ai-harness --skill architecture-review
Clone the repo
git clone --depth 1 https://github.com/visionTw/godot-ai-harness

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for architecture-review

README.md
[![agentmods](https://agentmods.dev/badge/skills/visiontw/godot-ai-harness/architecture-review/github.svg)](https://agentmods.dev/skills/visiontw/godot-ai-harness/architecture-review)
Your own site
<a href="https://agentmods.dev/skills/visiontw/godot-ai-harness/architecture-review"><img src="https://agentmods.dev/badge/skills/visiontw/godot-ai-harness/architecture-review/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for architecture-review

Your own site · 80×15
<a href="https://agentmods.dev/skills/visiontw/godot-ai-harness/architecture-review"><img src="https://agentmods.dev/badge/skills/visiontw/godot-ai-harness/architecture-review.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 71 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,924 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 86% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00071 $0.05924
Opus 5 $0.00036 $0.02962
Sonnet 5 $0.00014 $0.01185
Haiku 4.5 $0.00007 $0.00592

Measured 11d ago against content hash b5980b7d91bf, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

architecture-review scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

86% identical to architecture-review — 60 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

core/skills/architecture-review/SKILL.md · 640 lines

How it starts

The opening of the file, as written. The whole thing — 640 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Architecture Review

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:

  • No argument / full: Full review — all phases
  • coverage: Traceability only — which GDD requirements have no ADR
  • consistency: Cross-ADR conflict detection only
  • engine: Engine compatibility audit only
  • single-gdd [path]: Review architecture coverage for one specific GDD
  • rtm: 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.

Phase 1: Load Everything

Phase 1a — L0: Summary Scan (fast, low tokens)

Before reading any full document, use Grep to extract ## Summary sections from all GDDs and ADRs:

Grep pattern="## Summary" glob="design/gdd/*.md" output_mode="content" -A 4
Grep pattern="## Summary" glob="docs/architecture/adr-*.md" output_mode="content" -A 3

For single-gdd [path] mode: use the target GDD's summary to identify which ADRs reference the same system (Grep ADRs for the system name), then full-read only those ADRs. Skip full-reading unrelated GDDs entirely.

For engine mode: only full-read ADRs — GDDs are not needed for engine checks.

For coverage or full mode: proceed to full-read everything below.

Phase 1b — L1/L2: Full Document Load

Read all inputs appropriate to the mode:

Design Documents

  • All in-scope GDDs in design/gdd/ — read every file completely
  • design/gdd/systems-index.md — the authoritative list of systems

Architecture Documents

  • All in-scope ADRs in docs/architecture/ — read every file completely
  • docs/architecture/architecture.md if it exists

Read the full file on GitHub · 640 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 640 lines · 71 tokens per session scan A b5980b7d91bf

Subscribe to this mod's changes

architecture-review is a skill published in the GitHub repository visionTw/godot-ai-harness (2 stars, last pushed 24d ago), licensed MIT. It adds 71 tokens to every session and 5,924 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. It is 86% identical to architecture-review, differing in 60 lines, and is treated as a copy.

Related

Other skills, from other repositories

animation-review

Reviews Godot Animation implementation for known pitfalls. Triggers AFTER implementation, when code involves AnimationPlayer, AnimationTree, AnimatedSprite2D, SpriteFrames, AnimationNodeStateMachine, BlendSpace, OneShot, callbackmodeprocess, or animation playback control (play/travel/start). Do NOT use this skill for…

valkor-ai/loom · 75 tokens

tilemap-review

Reviews Godot TileMap implementation for known pitfalls. Triggers AFTER implementation, when code involves TileMapLayer, TileSet, TileSetAtlasSource, TileSetScenesCollectionSource, terrain painting, setcell, erasecell, getcelltiledata, collision polygons on tiles, or NavigationRegion2D with tile-based navigation. Do…

valkor-ai/loom · 85 tokens

godot-code-review

Use when reviewing GDScript or C# Godot code — checklist of best practices, common anti-patterns, and Godot-specific pitfalls.

jame581/GodotPrompter · 33 tokens

hz-unity-code-review

Reviews Unity code targeting Meta Quest and Horizon OS for performance issues, rendering best practices, and common VR pitfalls. Use during code review or when diagnosing Quest performance problems in Unity projects.

meta-quest/agentic-tools · 42 tokens

unity-reviewer

Use when reviewing Unity C# code changes — checks for runtime-breaking bugs, performance anti-patterns, and maintainability issues. Provides severity-tiered review organized as Critical, Performance, and Style.

TheArcForge/Hades · 39 tokens

design-lenses

Structured game-design critique: review a game through Schell's design lenses, Wright's systems-and-emergence lenses, and the MDA framework, producing severity-ranked findings with concrete fixes. Use when the user asks 'is my game fun?', 'review my game design', 'why is it boring?', 'critique this game', 'what's…

kyh/vibedgames · 118 tokens