architecture

architecture is a skill for Claude Code, Codex from greglas75/zuvo. It costs 67 tokens per session (5,332 once invoked), scanned A, original, MIT.

A guide for reviewing a codebase’s architecture, recording Architecture Decision Records (written explanations of important technical choices), or designing a new system from requirements. It uses CodeSift to discover modules, dependencies, and structural metrics.

In plain words
What is it for?
Use it to audit an existing project’s structure, document a technical decision, or create a system design.
Why use it?
It gives architecture work a defined scope and requires setup and compatibility files to be checked before work begins. This helps separate system-level design from individual-file code review or testing review.

Skill for Claude CodeCodex

Part of the zuvo plugin — 34 skills, 21 agents, 5 hooks shipped together

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.

agentmods
npx agentmods add skills/greglas75/zuvo/architecture
Any agent
npx skills add greglas75/zuvo --skill architecture
Clone the repo
git clone --depth 1 https://github.com/greglas75/zuvo

Made for: Claude Code, Codex.

Or install zuvo, the plugin that ships this one along with the rest of its 34 skills, 21 agents, 5 hooks.

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

README.md
[![agentmods](https://agentmods.dev/badge/skills/greglas75/zuvo/architecture.svg)](https://agentmods.dev/skills/greglas75/zuvo/architecture)
Your own site
<a href="https://agentmods.dev/skills/greglas75/zuvo/architecture"><img src="https://agentmods.dev/badge/skills/greglas75/zuvo/architecture.svg" alt="Measured on agentmods" height="20"></a>
Per session 67 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,332 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found 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 $0.00067 $0.05332
Opus 5 $0.00034 $0.02666
Sonnet 5 $0.00013 $0.01066
Haiku 4.5 $0.00007 $0.00533

Measured 4d ago against content hash 10b6d97248a5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

architecture 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 4d 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.

skills/architecture/SKILL.md · 556 lines

How it starts

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

zuvo:architecture — Review, ADR & System Design

Three modes for architecture work: audit an existing codebase structure, document a technical decision, or design a new system from requirements.

Scope: Architecture health assessment, technical decision documentation, system design from specifications. Out of scope: Per-file code quality (zuvo:code-audit), structural metrics without context (zuvo:structure-audit), test quality (zuvo:test-audit), individual file refactoring (zuvo:refactor).

Mandatory File Loading

Read these files before any work begins:

  1. ../../shared/includes/codesift-setup.md -- CodeSift discovery and tool selection
  2. ../../shared/includes/env-compat.md -- Agent dispatch and environment adaptation

Print the checklist:

CORE FILES LOADED:
  1. codesift-setup.md   -- [READ | MISSING -> STOP]
  2. env-compat.md       -- [READ | MISSING -> STOP]
  3. ../../shared/includes/run-logger.md -- [READ | MISSING -> STOP]
  4. ../../shared/includes/retrospective.md -- [READ | MISSING -> STOP]

If any file is missing, STOP.

Environment Compatibility

Read ../../shared/includes/env-compat.md for agent dispatch patterns, path resolution, and progress tracking across all supported platforms.

CodeSift Integration

Read ../../shared/includes/codesift-setup.md for the full initialization sequence.

Dispatch is already authorized — do not ask, do not downgrade. Invoking this skill IS the request for every agent and gate it mandates, so a session rule about unprompted Agent use does not apply here. Only a harness with NO dispatch capability takes the documented single-agent fallback, and it still runs every gate inline — see ../../shared/includes/env-compat.md. Skipping a mandated agent and self-scoring the result is a substituted gate, not a degraded run.

Mode 1 (review) CodeSift advantages:

  • get_knowledge_map(repo, depth=2) -- module relationships in one call
  • detect_communities(repo, focus="src") -- architectural boundary discovery
  • find_references(repo, symbol_name) -- precise fan-in/fan-out per module
  • impact_analysis(repo, since="HEAD~10", depth=2) -- coupling patterns from recent changes
  • analyze_hotspots(repo, since_days=90) -- churn hotspots
  • trace_call_chain(repo, symbol_name, direction="callers", depth=3) -- dependency chains

Read the full file on GitHub · 556 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. 4d ago First seen · 556 lines · 67 tokens per session scan A 10b6d97248a5

Subscribe to this mod's changes

architecture is a skill published in the GitHub repository greglas75/zuvo (6 stars, last pushed yesterday), licensed MIT. It adds 67 tokens to every session and 5,332 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

debt-ops-init

Write or refresh a "Tech debt operations" section in the project's AGENTS.md so the team shares one source of truth for debt-ops disciplines. Run ONLY when the user explicitly asks to set up, install, or initialize debt-ops disciplines — never auto-invoke. Idempotent; only the managed section changes, other sections…

bcanfield/agentic-tech-debt · 76 tokens

init

Write or refresh the ## Tech debt operations section in CLAUDE.md so a team shares one source of truth for debt-ops disciplines and cached quality commands. Idempotent. Only the managed section changes; other sections are untouched. Invoked explicitly via /debt-ops:init (solo users get the same content from the…

bcanfield/agentic-tech-debt · 74 tokens

review

Audit the debt registry, rank survivors by churn × Fowler quadrant, surface a top-N list, then walk paydown on user follow-up. Use when the user asks to review debt, see what to pay down, work through entries, or invokes /debt-ops:review. Stale entries drop with drop A,B,C.

bcanfield/agentic-tech-debt · 70 tokens

debt-ops-metrics

Print a debt-ops health summary from the metrics log, covering registration rate, feedback action rate, ADR creation, and AI-authored share. Use when the user asks for "debt-ops metrics", "debt health", "registry stats", or a tech-debt health summary. Read-only, never writes the log.

bcanfield/agentic-tech-debt · 74 tokens

add

Register a deferred decision in the debt registry. Trigger by judgment, not a marker scan, whenever a future reader would ask "why this way?": an unmade decision, stub, loosened type, bypassed check, swallowed error, a default picked "for now", or a TODO/FIXME/HACK/XXX marker. Trigger immediately whenever you defer…

bcanfield/agentic-tech-debt · 110 tokens

metrics

Print a debt-ops health summary from the metrics log, covering registration rate, hook feedback action rate, ADR creation, and AI-authored share. Use when the user asks for "debt-ops metrics", "debt health", "registry stats", or invokes /debt-ops:metrics. Read-only, never writes the log.

bcanfield/agentic-tech-debt · 72 tokens