pdca-framework

What problem does it solve?

AI code generation, while powerful, often leads to increased technical debt, duplicated code, and decreased delivery stability. This Skill provides a human-supervised PDCA (Plan-Do-Check-Act) framework that addresses these challenges by enforcing structured development, strict Test-Driven Development (TDD), and continuous human oversight. It ensures that AI-generated code maintains high quality, reduces rework, and keeps developers actively engaged and accountable.

Core Features & Use Cases

• Structured PDCA Workflow: Guides AI through systematic Plan, Do, Check, and Act phases for every coding task, ensuring thorough analysis, disciplined implementation, rigorous validation, and continuous improvement.
• Strict TDD Enforcement: Integrates mandatory Test-Driven Development, requiring the AI to write failing tests first, then minimal code to pass them, significantly reducing bugs and improving code quality.
• Active Human Oversight & Intervention: Empowers developers to act as "process police," intervening immediately when the AI deviates from established working agreements or TDD discipline, maintaining control and accountability.
• Use Case: A software team needs to integrate a complex new feature. They use this Skill to guide their AI assistant through each PDCA phase, from initial architectural analysis and detailed planning to test-driven implementation and final validation. This ensures the AI produces high-quality, well-tested code that aligns with existing patterns and minimizes technical debt.

Quick Start

To begin a new development task, instruct Claude to analyze the problem using the PDCA framework. For example: Analyze implementing a new user authentication module using the PDCA framework. Search the codebase for existing patterns before proposing an approach.