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

repo-architecture — скилл для Claude Code: анализ архитектуры

Скилл repo-architecture для Claude Code строит карту текущей архитектуры репозитория и оценивает последствия изменений. Запускается по просьбе разобрать зависимости, связи между модулями или безопасность правки.

Apache-2.0 437 установок ★ 8 обновлён 2026-07-24

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

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

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

Результат включает архитектурную карту с уровнями Context, Containers и Components, ключевые последовательности и граф зависимостей. Отдельный анализ перечисляет затронутые модули, тесты, контракты и места вызова с оценкой уверенности. Перед завершением проверки подтверждают, что компоненты, связи и строки анализа снабжены разрешимыми ссылками.

Нужен файл .reposkillopt/specs/repository-specification.md. Без него скилл не строит архитектуру по беглому осмотру: сначала требуется подготовить спецификацию репозитория.

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

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

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

  • Составь карту архитектуры этого репозитория.
  • Оцени зависимости между модулями и укажи связанные файлы.
  • Что изменится, если мы поменяем этот интерфейс?

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

1Через Skills CLI (Vercel)

npx skills add objectivlabs/reposkillopt --skill repo-architecture -a claude-code

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

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

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

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

Вопросы о repo-architecture

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

Выполни npx skills add objectivlabs/reposkillopt --skill repo-architecture -a claude-code. Файл скилла появится по пути ~/.claude/skills/repo-architecture/SKILL.md.

Что делает repo-architecture?

Строит подтверждённую ссылками карту архитектуры репозитория и анализирует последствия конкретного изменения: затронутые модули, тесты, контракты и места вызова.

Что нужно для работы repo-architecture?

Нужен файл .reposkillopt/specs/repository-specification.md. Скилл сверяет его с исходным кодом, конфигурациями и местами вызова.

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

SKILL.md · Apache-2.0
---
name: repo-architecture
description: Evidence-grounded as-is architecture analysis and change-impact (blast-radius). Activates when the user asks to map the architecture, assess dependencies or coupling, or evaluate "what would change if we…".
version: 0.1.0
---

# RepoSkillOpt — As-Is Architecture Analysis (Canonical Skill)

## Purpose

This is the **repo-specializing analysis layer** of RepoSkillOpt. The generic understanding skill
(`repo-skillopt`) is unchanged — it produces the repo-neutral **Repository Specification**. This skill
*specializes on a specific repository*: it deepens that Repository Specification into an
evidence-grounded view of the *current* architecture and answers "what would a change ripple into?"
— before anything is touched. It produces an **Architecture View** and a **Change-Impact
(blast-radius) Analysis**, and is the *analyze as-is* stage the *plan to-be* skill (`repo-orchestration`)
consumes. The skill's own content is vendor-neutral (no coding-agent runtime dependency); its
*output* is repo-specific.

## Trigger Conditions

Activate when the user asks to **map the architecture**, **assess dependencies/coupling/layering**,
or **evaluate "what would change if we… / is it safe to change X"** — or recognizable equivalents.
Do **not** activate for unrelated requests.

## Prerequisite

A Repository Specification (`.reposkillopt/specs/repository-specification.md`). If absent, state the
prerequisite and point the user to the repository-understanding skill; do **not** fabricate an
architecture from shallow inspection.

## Operating Principles

- **Build on the spec, corroborate against code.** The Repository Specification is the starting
  evidence; verify every architectural claim against the actual files, configs, and call sites.
- **Ground every major claim.** Each carries exactly one label — `**[fact]**`, `**[inference]**`,
  `**[unknown]**`, `**[human]**`; `**[fact]**` MUST carry a resolvable `file:line`/symbol citation.
- **No silent omission.** Unresolvable structure or impact is `**[unknown]**` with the reason, never dropped.
- **Do not overclaim.** Do not describe layers or flows you have not traced; mark inference as inference.
- **Repository facts stay repository-scoped.** Only patterns explicitly marked candidate-for-generic
  may enter the skill-convergence loop.

## Workflow

(a) **Read the Repository Specification** and the entrypoints, manifests, and core modules it cites.

(b) **Architecture View** (`.reposkillopt/architecture/architecture-view.md`, per
`templates/architecture-view.md`): C4-style levels — **Context** (system + external actors),
**Containers** (runtime/deployable units), **Components** (modules within containers) — plus **Key
sequences** (end-to-end flows, cited at each hop) and a **Dependency graph** (cited internal edges).
Every component and edge cites a real `file:line`. Diagrams (`graph`, `sequenceDiagram`) are visual
aids and carry no citations; every node/edge they show also appears as a cited line.

(c) **Change-Impact Analysis** (`.reposkillopt/impact/change-impact-analysis.md`, per
`templates/change-impact-analysis.md`): for the named target/change, the affected **modules, tests,
contracts, and call sites** — each row with a **confidence** label (high|medium|low) tied to evidence
strength (direct cited call site = high; name-resolution/inference = medium; dynamic/unresolved = low
and `**[unknown]**`) and a citation. Locate impact with a fast scanner (`rg`/`grep`) and read only the
matched lines you cite.

(d) **Deterministic completeness gate.** Before finishing, the artifacts MUST pass the deterministic
checks (`check_architecture_view`, `check_impact_analysis`): every component/edge cited and
resolvable; every impact row carries a citation and a confidence label.

## Output Discipline

Labels: `**[fact]**` (verified; cited), `**[inference]**` (state the basis), `**[unknown]**` (also
listed as such), `**[human]**` (cite the Feedback Item id). Citations use `path:line`,
`path:start-end`, `path:Symbol[:line]`, or `cmd:`/`output:`. Trivial recitations need no label.

## Human Feedback Loop

Corrections are recorded as **Feedback Items** (`templates/human-feedback.md`) under
`.reposkillopt/feedback/` and applied to the artifact in place. Repository-specific corrections stay
repository-scoped.

## Skill Convergence Loop

When recurrent feedback (≥3 related items) marked **candidate-for-generic** reveals a weakness in
*this* skill, draft a **Skill Edit Proposal** (`templates/skill-edit-proposal.md`). It may be
accepted **only** after passing the validation gate (`rubric/validation-gate.md`): regenerate the
artifacts for a disjoint held-out reference set with **no per-dimension rubric regression** (see
`rubric/asis-architecture-rubric.md`) and the deterministic checks still passing. Nothing is silently
promoted; acceptance bumps the version + adds a CHANGELOG entry. Mirror every accepted edit into the
four adapters (adapter-equivalence).

© objectivlabs · Apache-2.0 · objectivlabs/reposkillopt

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

Каталог скиллов SKILL.md →
repo-intake-and-plan lllllllama Скилл repo-intake-and-plan сканирует репозиторий по README, собирает команды и предлагает минимальный план воспроизведения. Нужен до запуска экспериментов. CX Codex +1 502 400установок make-repo-contribution официальный github Скилл make-repo-contribution проверяет правила репозитория перед issue, веткой, коммитом или PR и помогает пройти процесс контрибьюции без пропуска обязательных шагов. CX Codex +1 11 073установок repo-story-time официальный github Скилл repo-story-time для GitHub Copilot анализирует кодовую базу и историю Git, создавая техническую сводку и рассказ о развитии проекта. Разбирает незнакомый репозиторий. CX Codex +1 8 900установок repo-scan affaan-m Скилл repo-scan для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который сканирует репозиторий и классифицирует каждый файл как собственный код, стороннюю библиотеку или артефакт сборки. CX Codex +1 6 200установок ghost-repo-context ghostsecurity Скилл ghost-repo-context сканирует кодовую базу, находит проекты и записывает карту архитектуры в repo.md. Нужен перед анализом безопасности или знакомством с новым репозиторием. CX Codex +1 4 200установок om-verify-in-repo open-mercato Скилл om-verify-in-repo для Claude Code проверяет задачи трекера перед запуском цепочки автоисправления. Оценивает репорт в режиме чтения и останавливает процесс токеном NO_ACTION_NEEDED при отсутствии бага. CX Codex +1 3 500установок

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

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

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