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

repo-orchestration — скилл для Claude Code

Скилл repo-orchestration для Claude Code проектирует целевое состояние системы и собирает план внедрения. Включается при запросах спланировать задачи или подготовить архитектурный дизайн.

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

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

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

Скилл формирует архитектурные решения (ADR), документ дизайна и реестр задач в формате Markdown. Каждый ADR рассматривает не менее двух вариантов с оценкой плюсов и минусов. Документ дизайна привязывает каждое изменение к существующим компонентам с точными ссылками на строки кода.

Для запуска требуются артефакты текущего состояния репозитория — срез архитектуры и анализ влияния изменений, а также сформулированная цель. План оформляется в .reposkillopt/plan/task-ledger.md в виде таблицы с зависимостями и топологическим порядком.

Скилл только планирует изменения и проверяет структуру через встроенные проверки check_adr и check_task_ledger. Сам код он не пишет и задачи не выполняет.

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

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

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

  • Спроектируй целевое состояние для перехода на PostgreSQL
  • Разбей задачу рефакторинга модуля авторизации на независимые шаги
  • Подготовь план внедрения и ADR для интеграции нового платёжного шлюза

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о repo-orchestration

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

Для установки выполните команду npx skills add objectivlabs/reposkillopt --skill repo-orchestration -a claude-code.

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

Создаёт ADR с выбором решений, дизайн-документ и таблицу задач с проверками приёмки и графом зависимостей.

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

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

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

SKILL.md · Apache-2.0
---
name: repo-orchestration
description: Evidence-grounded to-be design (ADRs + design doc) and an implementation orchestration plan (a machine-readable task ledger). Activates when the user asks to design a target state, plan the work, or produce a task plan for a goal.
version: 0.1.0
---

# RepoSkillOpt — To-Be Design & Implementation Orchestration (Canonical Skill)

## Purpose

This skill consumes the **as-is artifacts** (Architecture View + Change-Impact Analysis) and a
stated **goal**, and produces (a) a reviewable target-state design — **ADRs** + a concise **Design
Doc** grounded in the as-is evidence — and (b) an **implementation orchestration plan**: a
machine-readable **Task Ledger** decomposed into small, independent, individually acceptance-tested
sub-tasks with declared dependencies and a topological order. The plan is an **artifact, not an
executor** — any orchestrator can drive it; this skill never executes the implementation.
Vendor-neutral: no dependency on any particular coding-agent runtime.

## Trigger Conditions

Activate when the user asks to **design a target state / to-be**, **plan the work / decompose into
tasks**, or **produce an implementation plan for goal X** — or recognizable equivalents. Do **not**
activate for unrelated requests, and do **not** execute the resulting plan.

## Prerequisite

The as-is artifacts (Architecture View, Change-Impact Analysis) and a stated goal. If the as-is is
missing, point the user to the as-is architecture skill first; do not design against an ungrounded
picture of the current system.

## Operating Principles

- **Ground the design in the as-is.** Every design claim is traceable to as-is evidence (`file:line`
  via the cited as-is artifacts). Mark inference as `**[inference]**`, unknowns as `**[unknown]**`.
- **Decide explicitly.** Contested choices become ADRs that weigh ≥2 options — no silent defaults.
- **Plan, don't execute.** The Task Ledger is a portable artifact; this skill writes it and stops.
- **Independent, acceptance-tested tasks.** Each sub-task is small enough to be executed and
  reviewer-verified on its own, with declared dependencies; if a task isn't independently
  acceptance-testable, split it.
- **Repository facts stay repository-scoped.** Only candidate-for-generic patterns enter convergence.

## Workflow

(a) **Read the as-is artifacts + the goal.** Identify constraints and the affected blast-radius.

(b) **ADRs** (`.reposkillopt/decisions/ADR-NNN-<slug>.md`, per `templates/adr.md`): one decision
each — Context, **Options considered (≥2, pros/cons)**, Decision, Consequences. A goal that conflicts
with an as-is constraint is recorded as an ADR trade-off, not papered over.

(c) **Design Doc** (`.reposkillopt/design/design-doc.md`, per `templates/design-doc.md`): Goal,
Target-state overview, **How it maps onto the as-is** (each change tied to the current
component/flow it touches, cited), Risks & trade-offs (link the ADRs), Out of scope.

(d) **Task Ledger** (`.reposkillopt/plan/task-ledger.md`, per `templates/task-ledger.md`): the work
as a table — `id | goal | acceptance | depends_on` — each task independent + individually
acceptance-tested, dependencies declared, the dependency graph **acyclic**, and the front-matter
`topological_order` listing every id with each dependency before its dependent.

(e) **Deterministic gate.** The artifacts MUST pass the deterministic checks (`check_adr`,
`check_task_ledger`): ≥2 options per ADR; every task has a goal + acceptance; deps exist; graph
acyclic; topological order valid.

## Output Discipline

Same R10 labels and citation forms as the as-is skill; design claims cite the as-is artifacts they
rest on. Trivial recitations need no label.

## Human Feedback Loop

Corrections to a decision or to the task decomposition are recorded as **Feedback Items**
(`templates/human-feedback.md`) under `.reposkillopt/feedback/` and applied to the artifact in place.

## Skill Convergence Loop

Recurrent **candidate-for-generic** feedback (≥3 related items) becomes a **Skill Edit Proposal**
(`templates/skill-edit-proposal.md`), accepted **only** after the validation gate
(`rubric/validation-gate.md`): regenerate artifacts for a disjoint held-out set with **no
per-dimension rubric regression** (see `rubric/tobe-orchestration-rubric.md`) and deterministic
checks still passing. Nothing is silently promoted; acceptance bumps the version + CHANGELOG and is
mirrored into the four adapters.

© objectivlabs · Apache-2.0 · objectivlabs/reposkillopt

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
grill-with-docs akillness Скилл grill-with-docs для Claude Code проводит разбор плана или дизайна и создаёт ADR с записями глоссария. Запускается фразами про разбор и документирование. CX Codex +1 366установок edge-ai-tasks официальный Awesome Copilot Community Плагин edge-ai-tasks для GitHub Copilot исследует проект и планирует задачи реализации. Он предназначен для работы с крупными кодовыми базами и рассчитан на пользователей среднего и экспертного уровня. ★ 41 430звёзд репо Orchestration Planner daffy0208 Скилл Orchestration Planner раскладывает крупную цель на цепочку задач, проверяет возможности проекта и предлагает основной план с альтернативами. CX Codex +1 134установок w-architecture blockmatic-icebox Скилл w-architecture для Claude Code помогает спланировать структуру реализации. Он сверяет изменения с архитектурными документами и ADR проекта. CX Codex +1 647установок upfront-design prathamdby Скилл upfront-design для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode ведёт структурированное проектирование до написания кода. CX Codex +1 321установок implement-plan-preflight terrylica Скилл implement-plan-preflight запускает подготовительный этап ITP: создаёт ADR в формате MADR 4.0, спецификацию архитектуры и связывает их перекрёстными ссылками. CX Codex +1 125установок

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

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

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