skills.rest
terrylica
terrylicaCOMMUNITY
Explore all skills by this author →
GitHub

implement-plan-preflight

Generate MADR 4.0 ADRs and Design Specs with cross-links and diagrams.

62|10|Updated Dec 4, 2025
Search Tags:#automation#architecture#documentation#validation#ADR#preflight#design spec
One-click install
npx skills add https://github.com/terrylica/cc-skills --skill implement-plan-preflight
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: implement-plan-preflight
Source: https://github.com/terrylica/cc-skills/tree/main/plugins/itp/skills/implement-plan-preflight
Command: npx skills add https://github.com/terrylica/cc-skills --skill implement-plan-preflight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill eliminates the tedious manual work of creating Architecture Decision Records (ADRs) and Design Specifications, which are often error-prone and lead to lost decisions, especially with ephemeral AI planning outputs. It standardizes and automates the critical "Preflight" phase of project planning.

Core Features & Use Cases

  • Automated ADR & Design Spec Creation: Generates MADR 4.0 compliant ADRs and design specifications from global plans, ensuring consistency.
  • Mandatory Cross-Linking & Verification: Automatically ensures ADRs and specs are correctly linked and all required sections (including diagrams) are present before implementation.
  • Decision Traceability: Captures ephemeral AI planning decisions (e.g., from AskUserQuestion flows) into version-controlled artifacts, preventing loss of critical context.
  • Use Case: When starting a new feature, use this skill to ensure all architectural decisions and design details are formally documented, linked, and validated, preventing costly rework and ensuring alignment before any code is written.

Quick Start

Execute the Preflight phase for the current feature plan. Ensure all ADRs and design specs are created and verified.

Frequently Asked Questions about implement-plan-preflight

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate ADR and design specification creation from project plans?▼

Automate ADR and design spec creation by running the preflight phase, which generates MADR 4.0–compliant documents from your global plan with mandatory cross-linking, YAML frontmatter population, and required Before/After and Architecture diagrams embedded as graph-easy blocks.

What is an ADR and why should I use one for architectural decisions?▼

An Architecture Decision Record (ADR) captures architectural choices, trade-offs, and context in a standardized format. MADR 4.0 compliance ensures decisions are traceable, version-controlled, and prevent loss of ephemeral AI planning context that leads to costly rework.

How do I ensure design specifications and ADRs are linked and complete before implementation?▼

The preflight validator automatically enforces cross-linking between ADRs and design specs, verifies all mandatory sections including diagrams are present, and gates implementation until artifacts pass checkpoint verification, stored at /docs/adr and /docs/design.

Can I generate ADRs and design specs for individual features, or only full projects?▼

Generate artifacts for individual features using feature ADRs and design-spec derivations during the preflight phase. The skill applies to feature-scoped planning, manual preflight checks, and MADR-formatted plans within the /itp:go workflow.

What diagrams are required in automated ADRs and design specifications?▼

Two mandatory diagrams are enforced: a Before/After diagram showing the current and proposed state, and an Architecture diagram depicting system components and relationships, both rendered as graph-easy blocks with proper cross-links.

Do I need to manually populate YAML frontmatter in generated ADRs and design specs?▼

No. The skill automatically populates required YAML frontmatter fields during generation, eliminating manual setup and ensuring consistency across all artifacts in the preflight phase.

Related Skills

Explore More Software Engineering Skills→
pradyumnasagarpradyumnasagar
6

agent-handoff

Automate inter-skill data transfer and provenance capture via JSON Material Passports.

Community
Advanced
nathanvalenathanvale

plan-expert

Convert planning documents into executable VTM tasks with dependency validation.

Community
Intermediate
terrylicaterrylica
62

adr-graph-easy-architect

Create ASCII architecture diagrams for ADRs using Graph-Easy syntax.

Community
Advanced
pradyumnasagarpradyumnasagar
6

cross-reference-mapper

Generate and validate cross-references between ORS skills.

Community
Intermediate