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

implement-plan-preflight — скилл для Claude Code

Скилл implement-plan-preflight запускает подготовительный этап ITP: создаёт ADR в формате MADR 4.0, спецификацию архитектуры и связывает их перекрёстными ссылками.

MIT 125 установок ★ 3 обновлён 2026-10-25

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

Что делает implement-plan-preflight

Скилл автоматизирует шаг Preflight перед началом кодинга в рамках рабочего процесса /itp:go. Он заводит запись архитектурного решения (ADR) по пути /docs/adr/YYYY-MM-DD-slug.md и создаёт проектную спецификацию в каталоге /docs/design/$ADR_ID/spec.md, копируя глобальный план из ~/.claude/plans/.

Внутрь ADR добавляются метаданные из 7 полей и ровно две обязательные схемы: сравнение до/после и архитектура компонентов. Без них переход к реализации блокируется. Для проверки артефактов запускается валидатор uv run scripts/preflight_validator.py $ADR_ID.

Если в проекте нет установленной утилиты uv, автоматическая валидация чек-листа завершится сбоем.

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

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

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

  • Подготовь ADR и проектную спецификацию для новой задачи
  • Выполни preflight этап по текущему плану
  • Создай архитектурную запись в формате MADR 4.0

Как установить implement-plan-preflight

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill implement-plan-preflight -a claude-code

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

~/.claude/skills/implement-plan-preflight/SKILL.md

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

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

Вопросы об implement-plan-preflight

Как установить implement-plan-preflight в Claude Code?

Выполните команду npx skills add terrylica/cc-skills --skill implement-plan-preflight -a claude-code. Файл навыка сохранится в ~/.claude/skills/implement-plan-preflight/SKILL.md.

Что делает implement-plan-preflight?

Он разворачивает артефакты подготовки: при наличии флага -b создаёт ветку в Git, генерирует ADR с двумя схемами и переносит глобальный план в локальную спецификацию.

Что именно проверяет валидатор чекпоинта?

Скрипт uv run scripts/preflight_validator.py $ADR_ID проверяет 7 полей frontmatter, перекрёстные ссылки между файлами и наличие обеих диаграмм в разделах Context и Architecture.

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

SKILL.md · MIT
---
name: implement-plan-preflight
description: Run the Preflight phase of the ITP workflow to create ADR and design spec artifacts. Use whenever the user asks to create an ADR, write a design.
allowed-tools: Bash, Read, Write, Edit, Glob, Grep
---

# Implement Plan Preflight

Execute the Preflight phase of the `/itp:go` workflow. Creates ADR and Design Spec artifacts with proper cross-linking and verification.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## When to Use This Skill

- Invoked by `/itp:go` command during Preflight phase
- User asks to create an ADR for a feature
- User mentions "design spec" or "MADR format"
- Manual preflight verification needed

## Preflight Workflow Overview

```
P.1: Create Feature Branch (if -b flag)
         │
         ▼
P.2: Create ADR File (MADR 4.0)
         │
         ▼
P.3: Create Design Spec (from global plan)
         │
         ▼
P.4: Verify Checkpoint (MANDATORY)
```

**CRITICAL**: Do NOT proceed to Phase 1 implementation until ALL preflight steps are complete and verified.

---

## Quick Reference

### ADR ID Format

```
YYYY-MM-DD-slug
```

Example: `2025-12-01-clickhouse-aws-ohlcv-ingestion`

### File Locations

| Artifact    | Path                                 |
| ----------- | ------------------------------------ |
| ADR         | `/docs/adr/$ADR_ID.md`               |
| Design Spec | `/docs/design/$ADR_ID/spec.md`       |
| Global Plan | `~/.claude/plans/<adj-verb-noun>.md` |

### Cross-Links (MANDATORY)

**In ADR header**:

```markdown
**Design Spec**: [Implementation Spec](/docs/design/YYYY-MM-DD-slug/spec.md)
```

**In spec.md header**:

```markdown
**ADR**: [Feature Name ADR](/docs/adr/YYYY-MM-DD-slug.md)
```

---

## Execution Steps

### Step P.1: Create Feature Branch (Optional)

Only if `-b` flag specified. See [Workflow Steps](./references/workflow-steps.md) for details.

### Step P.2: Create ADR File

1. Create `/docs/adr/$ADR_ID.md`
2. Use template from [ADR Template](./references/adr-template.md)
3. Populate frontmatter from session context
4. Select perspectives from [Perspectives Taxonomy](./references/perspectives-taxonomy.md)

### Step P.3: Create Design Spec

1. Create folder: `mkdir -p docs/design/$ADR_ID`
2. Copy global plan: `cp ~/.claude/plans/<adj-verb-noun>.md docs/design/$ADR_ID/spec.md`
3. Add ADR backlink to spec header

### Step P.4: Verify Checkpoint

Run validator or manual checklist:

```bash
uv run scripts/preflight_validator.py $ADR_ID
```

**Checklist** (ALL must be true):

- [ ] ADR file exists at `/docs/adr/$ADR_ID.md`
- [ ] ADR has YAML frontmatter with all 7 required fields
- [ ] ADR has `**Design Spec**:` link in header
- [ ] **DIAGRAM CHECK 1**: ADR has **Before/After diagram** (Context section)
- [ ] **DIAGRAM CHECK 2**: ADR has **Architecture diagram** (Architecture section)
- [ ] Design spec exists at `/docs/design/$ADR_ID/spec.md`
- [ ] Design spec has `**ADR**:` backlink in header

**If any item is missing**: Create it now. Do NOT proceed to Phase 1.

---

## YAML Frontmatter Quick Reference

```yaml
---
status: proposed
date: YYYY-MM-DD
decision-maker: [User Name]
consulted: [Agent-1, Agent-2]
research-method: single-agent
clarification-iterations: N
perspectives: [Perspective1, Perspective2]
---
```

See [ADR Template](./references/adr-template.md) for full field descriptions.

---

## Diagram Requirements (2 DIAGRAMS REQUIRED)

**⛔ MANDATORY**: Every ADR must include EXACTLY 2 diagrams:

| Diagram          | Location             | Purpose                       |
| ---------------- | -------------------- | ----------------------------- |
| **Before/After** | Context section      | Shows system state change     |
| **Architecture** | Architecture section | Shows component relationships |

**BLOCKING GATE**: Do NOT proceed to design spec until BOTH diagrams are embedded in ADR.

---

## Reference Documentation

- [ADR Template](./references/adr-template.md) - Complete MADR 4.0 template
- [Perspectives Taxonomy](./references/perspectives-taxonomy.md) - 11 perspective types
- [Workflow Steps](./references/workflow-steps.md) - Detailed step-by-step guide

---

## Validation Script

```bash
# Verify preflight artifacts
uv run scripts/preflight_validator.py <adr-id>

# Example
uv run scripts/preflight_validator.py 2025-12-01-my-feature
```

---

## Troubleshooting

| Issue                 | Cause                   | Solution                                     |
| --------------------- | ----------------------- | -------------------------------------------- |
| Validator fails       | Missing ADR or spec     | Create both files before running validator   |
| Frontmatter invalid   | Missing required fields | Check all 7 ADR fields and 5 spec fields     |
| Spec phase mismatch   | Wrong phase value       | Use: preflight, phase-1, phase-2, or phase-3 |
| ADR status wrong      | Manual status edit      | Let workflow manage status transitions       |
| Design folder missing | Wrong path structure    | Use docs/design/YYYY-MM-DD-slug/spec.md      |

## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

© terrylica · MIT · terrylica/cc-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
adr-writing existential-birds Скилл adr-writing для Claude Code, который оформляет архитектурные решения в документы ADR по шаблону MADR и проверяет их полноту по чек-листу E.C.A.D.R. Работает также в Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 254установок 030-architecture-adr-general Juan Antonio Breña Moral Скилл 030-architecture-adr-general ведёт диалог с разработчиком и оформляет архитектурные решения (ADR) для Java-проектов в формате MADR. Помогает зафиксировать выбор базы данных или фреймворка. CX Codex +1 373установок adr-standards microsoft Правило adr-standards встраивает шаблон MADR v4.0.0, формулу Y-Statement и таксономию статусов в папки с архитектурными решениями, чтобы агент писал ADR по стандарту. CX Codex +1 ★ 1 627звёзд репо adr ncklrs Помогает вести записи архитектурных решений по методологии MADR и Олафа Циммермана прямо в чате с агентом. CX Codex +1 146установок adr-author microsoft Скилл adr-author для Claude Code ведёт от описания архитектурного решения до ADR: собирает контекст, сравнивает варианты и оформляет выбранный шаблон. Фиксирует причины и последствия решения. CX Codex +1 ★ 1 627звёзд репо develop-adr product-on-purpose Скилл develop-adr для Claude Code оформляет архитектурное решение по формату Майкла Нигарда: фиксирует контекст, выбор и последствия. CX Codex +1 886установок

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

Весь набор →
asciinema-converter Скилл asciinema-converter преобразует записи asciinema .cast в чистые .txt для чтения и поиска. Подходит для одиночных и пакетных конвертаций. CX Codex +1 126установок multi-agent-performance-profiling Скилл multi-agent-performance-profiling для параллельного профилирования многоуровневых систем. CX Codex +1 126установок clickhouse-cloud-management Скилл clickhouse-cloud-management помогает управлять пользователями и правами доступа в ClickHouse Cloud через SQL-запросы по HTTPS. CX Codex +1 126установок booking-notify Скилл booking-notify отправляет уведомления о новых бронированиях, отменах и переносах через Telegram и Pushover. Синхронизация каждые 6 часов, вебхук для срочных событий. CX Codex +1 125установок issues-workflow Скилл issues-workflow держит план, иерархию и статус в GitHub Issues: подзадачи под родителем, связка issue с веткой и PR, автозакрытие после мержа. CX Codex +1 124установок ml-failfast-validation Скилл ml-failfast-validation для Claude Code запускает быстрые проверки ML-экспериментов перед долгим обучением на GPU и выявляет ошибки данных и градиентов. CX Codex +1 124установок pr-gfm-validator Скилл pr-gfm-validator переписывает относительные ссылки в описании пул-реквеста в абсолютные blob-URL с вашей ветки, чтобы ревьюеры не упирались в 404. CX Codex +1 123установок pypi-doppler Скилл pypi-doppler для Claude Code и пяти других платформ: публикует Python-пакет в PyPI с токеном из Doppler — только с локальной машины. CI/CD намеренно заблокирован: скрипт проверяет окружение и останавливается при обнаружении пайплайна. CX Codex +1 123установок

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

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