Claude-skill-registry implement-plan-preflight

Execute Preflight phase for /itp:go workflow. TRIGGERS - ADR creation, design spec, MADR format, preflight verification.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/implement-plan-preflight" ~/.claude/skills/majiayu000-claude-skill-registry-implement-plan-preflight && rm -rf "$T"

manifest: skills/data/implement-plan-preflight/SKILL.md

Implement Plan Preflight

Execute the Preflight phase of the

/itp:go

workflow. Creates ADR and Design Spec artifacts with proper cross-linking and verification.

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:

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

In spec.md header:

**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 for details.

Step P.2: Create ADR File

Create
```
/docs/adr/$ADR_ID.md
```
Use template from ADR Template
Populate frontmatter from session context
Select perspectives from Perspectives Taxonomy
Use Skill tool to invoke
```
adr-graph-easy-architect
```
for diagrams

Step P.3: Create Design Spec

Create folder:
```
mkdir -p docs/design/$ADR_ID
```

Copy global plan:

cp ~/.claude/plans/<adj-verb-noun>.md docs/design/$ADR_ID/spec.md

Add ADR backlink to spec header

Step P.4: Verify Checkpoint

Run validator or manual checklist:

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

---
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 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

SKILL INVOCATION: Invoke

adr-graph-easy-architect

skill NOW to create BOTH diagrams.

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

Reference Documentation

ADR Template - Complete MADR 4.0 template
Perspectives Taxonomy - 11 perspective types
Workflow Steps - Detailed step-by-step guide

Validation Script

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

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