How does it handle visual designs?

It integrates with the mermaid-collab plugin to reference and verify code against architecture and wireframe diagrams directly within the task structure.

Does it support Test-Driven Development (TDD)?

Yes, every task explicitly includes steps for writing failing tests, minimal implementation, and verification to ensure robust code quality.

What is the primary benefit of the Writing Plans skill?

It ensures complex tasks are broken down into manageable, testable steps, reducing errors and technical debt while providing a clear roadmap for implementation.

Can this skill be used for automated execution?

Yes, once a plan is generated, it offers a handoff to subagent-driven development or parallel execution sessions to complete the tasks automatically.

Where are the implementation plans saved?

Plans are automatically saved as standardized Markdown files in your project's docs/plans/ directory, following a date-stamped naming convention for easy tracking.

Implementation Architect & Planner

Name: Implementation Architect & Planner
Author: ben-mad-jlp

byben-mad-jlp

0•

Productivity & Workflow

Generates granular, TDD-focused implementation plans to guide complex software development tasks with precision.

The Writing Plans skill transforms high-level requirements into actionable, step-by-step technical blueprints. Designed for developers and AI agents alike, it enforces best practices such as Test-Driven Development (TDD), DRY, and YAGNI. By documenting exact file paths, pseudo-code, and verification commands, this skill ensures that implementation is predictable, traceable, and aligned with architectural designs. It bridges the gap between brainstorming and coding by creating a structured roadmap that supports both manual execution and automated subagent handoffs.

Key Features

01Integrates with Mermaid diagrams for visual design alignment

02Standardizes plan documentation in organized Markdown formats

03Supports seamless handoff to subagents for automated execution

04Enforces TDD workflows with explicit failing/passing test steps

050 GitHub stars

06Generates atomic, 2-5 minute tasks for rapid development cycles

Use Cases

01Breaking down a complex feature spec into small, committable tasks

02Creating a clear technical handoff for AI subagents to execute autonomously

03Ensuring consistent TDD practices across a development team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ben-mad-jlp/claude-mermaid-collab writing-plans

For use in Claude.ai and ChatGPT

Download Skill