К основному содержанию
скилл CX Codex

architecture-survey — скилл Claude Code: что делает, как установить

Скилл architecture-survey для Claude Code анализирует граф модулей репозитория и выявляет поверхностную изоляцию и лишние швы. Находит места, из-за которых правки затрагивают слишком много файлов.

MIT 201 установок ★ 40 997 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Yeachan-Heo/oh-my-claudecode --skill architecture-survey -a claude-code
Открыть на GitHub

Что делает architecture-survey

Скилл анализирует связи между модулями и выявляет три типа проблем: поверхностные модули с раздутым интерфейсом, гипотетические швы с единственным адаптером и бизнес-логику, вынесенную за неподходящую границу. Для проверки каждого кандидата запускается тест на снос: если при ликвидации модуля сложность растворится, он признаётся фиктивным швом. Анализ опирается на историю коммитов, чтобы уделить больше внимания часто изменяемым файлам.

В итоговый отчёт попадают ранжированные кандидаты с указанием строк кода, описанием риска и конкретным действием по углублению интерфейса. Оценки носят эвристический характер. Скилл только формирует отчёт для разработчика и принципиально не вносит правки в кодовую базу сам.

Какие задачи решает

  • найти фиктивные интерфейсы с единственным вызовом
  • обнаружить поверхностные модули с тонкой реализацией
  • выявить логику, оказавшуюся не за той границей модуля
  • оценить сложность изменений в активных зонах кодовой базы

Примеры запросов агенту

  • Проведи архитектурный аудит всего проекта
  • /architecture-survey src/core
  • Запусти architecture-survey для каталога payments

Как установить architecture-survey

1Через Skills CLI (Vercel)

npx skills add Yeachan-Heo/oh-my-claudecode --skill architecture-survey -a claude-code

2Вручную: положить файлы

~/.claude/skills/architecture-survey/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/architecture-survey/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об architecture-survey

Как установить architecture-survey в Claude Code?

Выполните команду npx skills add Yeachan-Heo/oh-my-claudecode --skill architecture-survey -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/architecture-survey/SKILL.md.

Изменяет ли architecture-survey исходный код?

Нет, скилл только исследует кодовую базу и формирует отчёт с ранжированными кандидатами. Все решения об изменениях и сам рефакторинг остаются за разработчиком.

Можно ли ограничить проверку одной директорией?

Да, скилл принимает необязательный аргумент с путём к нужной папке. Без него анализ охватит весь репозиторий с фокусом на часто меняющиеся участки.

Исходный текст

SKILL.md · MIT
---
name: architecture-survey
description: "Periodic architecture survey — walks the module graph and reports ranked deepening candidates (shallow modules, hypothetical seams, logic behind the wrong seam). Survey, not rescue: it finds candidates and hands them to the captain; it never refactors on its own."
argument-hint: "[optional directory or area to survey]"
level: 3
disable-model-invocation: true
---

**A surveyor charts the reef; the captain decides whether to dredge.** The survey reads the water, reports what it found with evidence, and stops. It is the maintenance twin of the loft: where the loft answers one design question before building, the survey answers "where is this repo getting harder to change, and what would deepen it" after building.

## When to survey

- Periodically — every few days of active building, or after a batch of tickets lands.
- Out of turn, when the repo starts feeling harder to change than it was last week: edits touching more files than they should, interfaces growing to satisfy one caller, tests that must be updated in lockstep for unrelated reasons.

Optional argument narrows the survey to a directory or area; with no argument, survey the whole repo.

## The survey

1. Read the repo's architecture principles (CLAUDE.md, ADRs) and the seeded seam vocabulary in `docs/standards/architecture.md` — the definitions of seam and deep module.
2. Walk the module graph of the target area — and when no direction was given, weight the walk toward the yard's busy water: read a good stretch of the commit history first and let the areas that keep coming up pull the survey, because deepening pays off where future edits will land. A scattered history with no hot spot widens the net.
3. Look for three finding classes:
   - **Shallow modules** — wide interface, thin behavior; callers know more than the module hides.
   - **Hypothetical seams** — a boundary crossed by exactly one adapter with no second caller; checkable by counting callers.
   - **Logic behind the wrong seam** — behavior living on the far side of a boundary that does not own its data.

Apply the **demolition test** to every suspect: if the module were removed, would its complexity vanish (a pass-through wearing a uniform) or reappear across its callers (load-bearing)? Only load-bearing shallowness is a finding.

## The report

Rank candidates by leverage against risk. Each candidate carries:

- **Evidence** — file:line for the interface, its callers, and the behavior.
- **The deepening move** — what to deepen, merge, or move, in one sentence.
- **The risk note** — what the move touches and what could break.

Every candidate states the yard's shared findings vocabulary — **severity** (how much friction the shallowness causes), **confidence** (a survey finding is heuristic-class and therefore low by construction; the mechanically checkable end of the scale belongs to the drydock `--check` audit), and **actionable** (whether the deepening move is specific enough to start from the report alone). End the report with the **top recommendation**: the one candidate to deepen first, and why — the captain reads one card, not the whole reef.

**Logbook conflicts.** A candidate that contradicts an existing ADR is nominated only when the friction is real: the card names the ADR and why the water has changed. Theoretical conflicts stay off the report — the logbook's rejections are not re-litigated by default.

The report may be rendered visually with the repo's diagram skill when the yard has one; the prose report stays the source of truth either way.

## Handoff

The report is decision input, not work. Candidates feed the mission brief (launch Phase 1) or grilling material for the next effort. Survey proposes; the captain disposes.

**Grill the top candidate on the spot.** When the captain wants to act on the survey immediately rather than filing it, the report's top recommendation becomes the first question of a design-tree interview in the same session — launch Phase 1's frontier protocol, run right here: what would deepening this candidate involve, what does it cost, what does it unblock. The evidence is fresh and the captain is present; a finding worked now is a decided effort, not a report waiting to go stale. The survey still makes no edits — the interview decides, and delivery goes through launch's own gates.

A candidate the captain declines with a load-bearing reason is offered as an ADR — the same ADR test launch applies (hard to reverse, surprising without context, a real tradeoff) — so the next survey does not re-nominate the same reef. Declined without one, it simply sinks.

## Non-goals

- **No code edits.** The survey never refactors, not even "while it's fresh."
- **Not a gate.** Nothing blocks on the report.
- **Not merged into the drydock drift audit.** `--check` stays strictly mechanically checkable — high-confidence findings only. Architecture judgment is a low-confidence heuristic; mixing it in dilutes the contract.

## Completion definition

The survey is done when the report exists with evidence, rankings, and risk notes for every finding — and no file was modified.

© Yeachan-Heo · MIT · Yeachan-Heo/oh-my-claudecode

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
clean-architecture pproenca Скилл clean-architecture с 42 правилами из книги Роберта Мартина: подсказывает агенту, куда направлять зависимости и где проводить границы слоёв. CX Codex +1 2 100установок architecture-review davila7 Команда architecture-review для Claude Code, которая разбирает структуру проекта и предлагает конкретные улучшения. Запускается на любом этапе, когда нужно понять, как устроен код и что в нём менять. CX Codex +1 3 419установок guarding-architecture riekelt Скилл guarding-architecture защищает архитектурные границы проекта и превращает правила в автоматические тесты сборки. Пригодится при сквозных правках модулей или случайных импортах. CX Codex +1 25 600установок architecture-compass stark-ai-de Скилл architecture-compass для Claude Code и Codex помогает управлять архитектурными решениями и проверять, как код им соответствует. Запускает аудит, настраивает ADR или ведёт ограниченный рефакторинг. CX Codex +1 2 700установок code-architecture-review omer-metin Скилл code-architecture-review проверяет структуру кодовой базы на зависимости и связность модулей. Помогает поймать проблемы до того, как они станут техдолгом. CX Codex +1 270установок architecture-critic официальный Anthropic Субагент architecture-critic проводит скептический аудит новой архитектуры и переписанного кода. Находит оверинжиниринг, лишние микросервисы и скрытые сбои. CX Codex ★ 47 914звёзд репо

Из того же набора48

Весь набор →
launch Скилл launch для организации полного цикла доставки: от постановки задачи к выпуску проверенного кода. Разделяет работу между агентом (всё, что можно автоматизировать и проверить) и человеком (решения без однозначного ответа). CX Codex +1 272установок tdd Задаёт строгий цикл TDD: агент пишет один падающий тест по согласованному шву, даёт минимальный зелёный код и откладывает рефакторинг на ревью. CX Codex +1 244установок harbor Скилл harbor разбирает входящие issue и PR, проверяет каждое утверждение и отдаёт мейнтейнеру только те решения, которые правда требуют его подписи. CX Codex +1 241установок minimal-prose-discipline Скилл minimal-prose-discipline для Claude Code сокращает ответы агента, сохраняя команды и ошибки без изменений и убирая служебную болтовню. Делает рабочие сообщения яснее. CX Codex +1 204установок agent-doc-discipline Скилл agent-doc-discipline задаёт правила оформления инструкций, спецификаций и файлов навыков для ИИ-агентов. Пригодится при составлении CLAUDE.md, чтобы агент понимал задачу с первого раза без истории чата. CX Codex +1 196установок diagram Скилл diagram для Claude Code выбирает компактный способ показать структуру кода — от дерева вызовов до Mermaid-схемы. Показывает связи наглядно, когда их трудно удержать в текстовом описании. CX Codex +1 194установок ask-navigator Скилл ask-navigator, который превращает неясную задачу в карту решений на issue-трекере репозитория. Работает с открытым фронтом по одному тикету за сессию, пока маршрут не прояснится. CX Codex +1 191установок loft Скилл loft разрешает спорные вопросы архитектуры и дизайна с помощью одноразового прототипа, который не попадает в main. CX Codex +1 189установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой