architecture-review SKILL.md skillA

architecture-review from mickeyyaya/evolve-loop is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mickeyyaya/evolve-loop/architecture-review@git:20261007.f16bf48

Pins git:20261007.f16bf48 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mickeyyaya/evolve-loop
Path
skills/architecture-review/SKILL.md
Versions recorded
1
Latest version
git:20261007.f16bf48, committed Oct 7, 2026
Size
10,758 bytes
Repository stars
6
License
Apache-2.0

Use when reviewing the structure of a code change read-only — single sources and duplicated beliefs, dependency direction, design-pattern fit with its forces, the three-book audit (test-driven, clean code, design patterns) and mutation probes — and writing the findings, each with a suggested fix, into a report. The code-review phase's structural rubric; also usable standalone after any structural change.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Architecture Review — how a change is shaped

> Backward-looking on a diff: you judge the structure that was just built, as the engineer who will
> inherit it and build twenty features on top of it. You never edit the repository and you never
> propose new features. Converted from `.claude/agents/architecture-reviewer.md` for the
> `code-review` phase ([plan](../../docs/plans/code-review-phase-2026-10.md)); the rubric is the same.

## Your lane

Your lane is how the change is **shaped**: boundaries, dependencies, duplication, the level of
abstraction and pattern fit. It is also what that shape costs the next maintainer, and whether the
change was built the way this project builds code: test-first, to *Clean Code* and to
*Design Patterns*.

The project applies those three books' rules in ONE place, and you judge against it without
restating it:
- `skills/engineering-craft/SKILL.md` and its `references/tdd-craft.md`, `clean-code.md` and
  `design-patterns.md`;
- `docs/conventions/code-comments.md` for comments.

In the code-review phase you run beside `code-review-simplify`, in review mode. Do not duplicate it:

| Belongs to `code-review-simplify` | Belongs to you |
|---|---|
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mickeyyaya/evolve-loop/architecture-review@sha256:019f47cb158d9fe9

The line at the top of this page pins the label git:20261007.f16bf48, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_pvqx2ra6o6hqpedj.svg)](https://markdownregistry.com/a/art_pvqx2ra6o6hqpedj)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 7, 2026.

versioncommittedcommitsizeaudit
git:20261007.f16bf48 latest2026-10-07 f16bf48 10,758 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10758 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

mickeyyaya/evolve-loop · 6 stars · license Apache-2.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pvqx2ra6o6hqpedj
GET https://markdownregistry.com/api/v1/resolve?ref=mickeyyaya/evolve-loop/architecture-review
GET https://markdownregistry.com/api/v1/blob/019f47cb158d9fe927821bce65b2753e01770af1d5d359852abce029bce333d8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mickeyyaya/evolve-loop

AGENTS.md@.evolve/profiles AGENTS.md file
mickeyyaya/evolve-loop · .evolve/profiles/AGENTS.md
git:20261008.0936a73 · audit A · 6 stars
AGENTS.md AGENTS.md file
mickeyyaya/evolve-loop · AGENTS.md
git:20261017.4e43d2a · audit A · 6 stars
CLAUDE.md CLAUDE.md file
mickeyyaya/evolve-loop · CLAUDE.md
git:20261021.07e8099 · audit A · 6 stars
AGENTS.md@agents AGENTS.md file
mickeyyaya/evolve-loop · agents/AGENTS.md
git:20260524.69626c6 · audit A · 6 stars
llms.txt@landing/shared llms.txt file
mickeyyaya/evolve-loop · landing/shared/llms.txt
git:20261008.46aa746 · audit B · 6 stars
adversarial-testing SKILL.md skill
mickeyyaya/evolve-loop · skills/adversarial-testing/SKILL.md · Use when authoring evals/predicates (Scout, TDD-Engineer), framing an audit (Auditor), or justifying which phases run…
git:20260914.80b348e · audit A · 6 stars
audit SKILL.md skill
mickeyyaya/evolve-loop · skills/audit/SKILL.md · Use after build has produced build-report.md. Validates the build with one adversarial auditor agent and produces the…
git:20261020.f4ba3ee · audit A · 6 stars
code-review-simplify SKILL.md skill
mickeyyaya/evolve-loop · skills/code-review-simplify/SKILL.md · Use when reviewing code changes for quality, security, performance, or maintainability issues and identifying…
git:20261007.e134ff4 · audit A · 6 stars
commit SKILL.md skill
mickeyyaya/evolve-loop · skills/commit/SKILL.md · Use when the user asks to commit changes (interactively, not inside an autonomous cycle). Runs code-simplifier + one…
git:20261020.bec061a · audit A · 6 stars
diff-review SKILL.md skill
mickeyyaya/evolve-loop · skills/diff-review/SKILL.md · Budget-capped adversarial review + simplification pass over a STAGED DIFF only — one agent, two lenses, findings-first…
git:20260810.d909098 · audit A · 6 stars
docs-review SKILL.md skill
mickeyyaya/evolve-loop · skills/docs-review/SKILL.md · Use when a change touches only documents (every changed path ends in .md) — research dossiers, plans, ADRs…
git:20261020.bec061a · audit A · 6 stars
docs-write SKILL.md skill
mickeyyaya/evolve-loop · skills/docs-write/SKILL.md · Use when you write or change any document for people to read — research dossiers, plans, ADRs, architecture specs…
git:20261020.33db5c7 · audit A · 6 stars

Every file in mickeyyaya/evolve-loop

Other files named architecture-review

architecture-review SKILL.md skill
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/architecture-review/SKILL.md · Review repository architecture using Ontoly Software Graph and MCP capabilities.
git:20260921.9164115 · audit A · 48,329 stars
architecture-review SKILL.md skill
decebals/claude-code-java · skills/architecture-review/SKILL.md · Analyze Java project architecture at macro level - package structure, module boundaries, dependency direction, and…
git:20260828.702770a · audit A · 759 stars
architecture-review SKILL.md skill
athola/claude-night-market · plugins/pensive/skills/architecture-review/SKILL.md · Assesses architecture decisions, ADR compliance, and coupling. Use when evaluating design changes or validating…
git:20260921.ad5ceb4 · audit A · 342 stars
architecture-review SKILL.md skill
striderza/opencodegamestudios · .agents/modules/architecture/skills/architecture-review/SKILL.md · Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix…
git:20260622.695134d · audit A · 99 stars
architecture-review SKILL.md skill
striderza/opencodegamestudios · .opencode/modules/architecture/skills/architecture-review/SKILL.md · Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix…
git:20260622.695134d · audit A · 99 stars
architecture-review SKILL.md skill
striderza/opencodegamestudios · .agents/skills/architecture-review/SKILL.md · Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix…
git:20260622.695134d · audit A · 99 stars
architecture-review SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/architecture-review/SKILL.md · Review repository architecture using Ontoly Software Graph and MCP capabilities.
git:20261015.fac8b7e · audit A · 87 stars
architecture-review SKILL.md skill
codenamev/ai-software-architect · skills/architecture-review/SKILL.md · Conducts a comprehensive multi-perspective architecture review using ALL architecture team members. Use when the user…
git:20261016.d9d47b2 · audit A · 79 stars

Browse by kind, by grade A, or by owner.