Where are the design plans stored?

Plans are automatically saved to the docs/design-plans/ directory using a standardized YYYY-MM-DD-topic.md naming convention for easy tracking in Git.

Why is there a limit of 8 implementation phases?

Limiting a design to 8 phases prevents overwhelming the context window during implementation and encourages modular project scoping, ensuring tasks remain manageable for AI-assisted execution.

What is the difference between a design plan and an implementation plan?

Design plans are archival and directional, focusing on 'what' is being built and where components live. Implementation plans are tactical and just-in-time, focusing on 'how' to write the specific code and function bodies.

Does this skill include actual implementation code?

No. Design plans define boundaries and interfaces (contracts). Implementation code, such as specific function logic and step-by-step instructions, is reserved for the implementation planning phase.

Design Plan Architect

Name: Design Plan Architect
Author: ed3dai

byed3dai

•

Productivity & Workflow

Generates structured, production-ready design documents with discrete implementation phases from brainstormed technical concepts.

The Design Plan Architect skill formalizes technical designs by appending validated brainstorming output to standardized templates within your repository's documentation. It enforces a critical distinction between high-level architectural design and tactical implementation, ensuring that contracts, component boundaries, and verification criteria are documented for long-term archival. By organizing complex work into discrete phases with specialized HTML markers, it creates a seamless, machine-readable bridge between abstract ideas and executable code tasks.

Key Features

01Phase-specific verification criteria mapping acceptance criteria to testable outcomes.

02Automated generation of executive summaries and technical glossaries for document legibility.

035 GitHub stars

04Strict separation between architectural design (contracts/boundaries) and implementation logic.

05Standardized Markdown generation for docs/design-plans/ with automated naming conventions.

06Enforcement of discrete implementation phases (limit of 8) for manageable project scoping.

Use Cases

01Converting exploratory brainstorming sessions into permanent, version-controlled technical documentation.

02Decomposing large architectural migrations into verifiable, sequential phases for team review.

03Defining rigid inter-service contracts and API signatures before beginning active development.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ed3dai/ed3d-plugins-testing writing-design-plans

For use in Claude.ai and ChatGPT

Download Skill