mad-plan

Generate technical implementation plans from feature specifications with data models and API contracts.

Updated May 7, 2026
One-click install
npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill mad-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mad-plan
Source: https://github.com/tmalcolm-0607/mad-council-claw/tree/main/.claude/skills/mad-plan
Command: npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill mad-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the tedious and error-prone manual work of creating implementation plans from feature specifications, ensuring consistency, completeness, and adherence to architectural standards across development teams.

Core Features & Use Cases

  • Automated Plan Generation: Transforms technology-agnostic specifications into detailed technical implementation plans with research, data models, API contracts, and verification specs.
  • Governance Enforcement: Automatically validates plans against constitutional constraints, pattern compliance rules, and coverage requirements before implementation begins.
  • Use Case: A product manager defines a new feature in a spec file. Use this skill to automatically generate the implementation plan, research documentation, data models, and API contracts that engineering needs to start building.

Quick Start

Use the mad-plan skill to generate a complete implementation plan from the feature specification in specs/003-user-auth/spec.md.

Frequently Asked Questions about mad-plan

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

FAQPage Schema
How do I generate a technical implementation plan from a feature specification?

To generate a technical implementation plan from a feature specification, provide the specification and a project constitution to produce phase-gated plans with research documentation, data models, API contracts, and verification specifications.

What is architecture governance validation for implementation plans?

Architecture governance validation is the process of checking implementation plans against constitutional constraints and pattern compliance rules, ensuring coverage requirements are met before development teams begin building.

How do I create API contracts and data models from specifications?

You can create API contracts and data models from specifications by transforming technology-agnostic feature specs into comprehensive technical implementation plans that automatically generate these artifacts alongside architecture diagrams.

Do I need a project constitution to generate implementation plans?

Yes, a project constitution is required to generate implementation plans, as it provides the constitutional constraints and architectural standards used to enforce governance and validate pattern compliance during plan generation.

What's the best way to enforce pattern compliance across development teams?

The best way to enforce pattern compliance across development teams is to validate generated implementation plans against constitutional constraints and coverage requirements before implementation begins, ensuring consistency and architectural adherence.

Can I include review gates and coverage verification in implementation planning?

Yes, implementation planning can include review gates and coverage verification by generating phase-gated plans with agent context updates, ensuring implementation teams have verified specifications before building features.