pdca

PDCA Skill

Unified Skill for managing PDCA cycle. Supports the entire Plan → Design → Do → Check → Act flow.

Arguments

Argument	Description	Example
plan [feature]	Create Plan document	/pdca plan user-auth
design [feature]	Create Design document	/pdca design user-auth
do [feature]	Do phase guide (start implementation)	/pdca do user-auth
analyze [feature]	Run Gap analysis (Check phase)	/pdca analyze user-auth
iterate [feature]	Auto improvement iteration (Act phase)	/pdca iterate user-auth
report [feature]	Generate completion report	/pdca report user-auth
archive [feature]	Archive completed PDCA documents	/pdca archive user-auth
status	Show current PDCA status	/pdca status
next	Guide to next phase	/pdca next

Action Details

Output Path: docs/01-plan/features/{feature}.plan.md

Product thinking checkpoint (Gstack office-hours)

Before finalizing the plan, the agent must:

• Challenge the premises of the request.
• Ask the user at least one "Taste Decision" question.
• Consider the "10-star version" vs the "shameful MVP".

design (Design Phase)

1. Verify Plan document exists (required - suggest running plan first if missing)
2. Create docs/02-design/features/{feature}.design.md
3. Use design.template.md structure + reference Plan content
4. Create Task: [Design] {feature} (blockedBy: Plan task)
5. Update .bkit-memory.json: phase = "design"

Output Path: docs/02-design/features/{feature}.design.md

do (Do Phase)

1. Verify Design document exists (required)
2. Provide implementation guide based on do.template.md
3. Reference implementation order from Design document
4. Create Task: [Do] {feature} (blockedBy: Design task)
5. Update .bkit-memory.json: phase = "do"

Guide Provided:

• Implementation order checklist
• Key files/components list
• Dependency installation commands

analyze (Check Phase)

1. Verify Do completion status (implementation code exists)
2. Call gap-detector Agent
3. Compare Design document vs implementation code
4. Calculate Match Rate and generate Gap list
5. Create Task: [Check] {feature} (blockedBy: Do task)
6. Update .bkit-memory.json: phase = "check", matchRate

Output Path: docs/03-analysis/{feature}.analysis.md

iterate (Act Phase)

1. Check results (when matchRate < 90%)
2. Call pdca-iterator Agent
3. Auto-fix code based on Gap list
4. Auto re-run Check after fixes
5. Create Task: [Act-N] {feature} (N = iteration count)
6. Stop when >= 90% reached or max iterations (5) hit

Iteration Rules:

• Max iterations: 5 (adjustable via bkit.config.json)
• Stop conditions: matchRate >= 90% or maxIterations reached

report (Completion Report)

1. Verify Check >= 90% (warn if below)
2. Call report-generator Agent
3. Integrated report of Plan, Design, Implementation, Analysis
4. Create Task: [Report] {feature}
5. Update .bkit-memory.json: phase = "completed"

Output Path: docs/04-report/{feature}.report.md

archive (Archive Phase)

1. Verify Report completion status (phase = "completed" or matchRate >= 90%)
2. Verify PDCA documents exist (plan, design, analysis, report)
3. Create docs/archive/YYYY-MM/{feature}/ folder
4. Move documents (delete from original location)
5. Update Archive Index (docs/archive/YYYY-MM/_INDEX.md)
6. Update .pdca-status.json: phase = "archived", record archivedTo path
7. Remove feature from activeFeatures

Output Path: docs/archive/YYYY-MM/{feature}/

Documents to Archive:

• docs/01-plan/features/{feature}.plan.md
• docs/02-design/features/{feature}.design.md
• docs/03-analysis/{feature}.analysis.md
• docs/04-report/features/{feature}.report.md

Important Notes:

• Cannot archive before Report completion
• Documents are deleted from original location after move (irreversible)
• Feature name must match exactly

status (Status Check)

1. Read .bkit-memory.json
2. Display current feature, PDCA phase, Task status
3. Visualize progress

Output Example:

📊 PDCA Status
─────────────────────────────
Feature: user-authentication
Phase: Check (Gap Analysis)
Match Rate: 85%
Iteration: 2/5
─────────────────────────────
[Plan] ✅ → [Design] ✅ → [Do] ✅ → [Check] 🔄 → [Act] ⏳

next (Next Phase)

1. Check current PDCA phase
2. Suggest next phase guide and commands
3. Confirm with user via AskUserQuestion

Phase Guide:

Current	Next	Suggestion
None	plan	/pdca plan [feature]
plan	design	/pdca design [feature]
design	do	Implementation start guide
do	check	/pdca analyze [feature]
check (<90%)	act	/pdca iterate [feature]
check (>=90%)	report	/pdca report [feature]
report	archive	/pdca archive [feature]

Template References

Templates loaded from imports are used when executing each action:

Action	Template	Purpose
plan	plan.template.md	Plan document structure
design	design.template.md	Design document structure
do	do.template.md	Implementation guide structure
analyze	analysis.template.md	Analysis report structure
report	report.template.md	Completion report structure

Task Integration

Each PDCA phase automatically integrates with Task System:

Task Creation Pattern:
┌────────────────────────────────────────┐
│ [Plan] {feature}                       │
│   ↓ (blockedBy)                        │
│ [Design] {feature}                     │
│   ↓ (blockedBy)                        │
│ [Do] {feature}                         │
│   ↓ (blockedBy)                        │
│ [Check] {feature}                      │
│   ↓ (blockedBy, Check < 90%)           │
│ [Act-1] {feature}                      │
│   ↓ (on iteration)                     │
│ [Act-N] {feature}                      │
│   ↓ (Check >= 90%)                     │
│ [Report] {feature}                     │
│   ↓ (after Report completion)          │
│ [Archive] {feature}                    │
└────────────────────────────────────────┘

Agent Integration

Action	Agent	Role
analyze	gap-detector	Compare Design vs Implementation
iterate	pdca-iterator	Auto code fix and re-verification
report	report-generator	Generate completion report

Usage Examples

# Start new feature
/pdca plan user-authentication

# Create design document
/pdca design user-authentication

# Implementation guide
/pdca do user-authentication

# Gap analysis after implementation
/pdca analyze user-authentication

# Auto improvement (if needed)
/pdca iterate user-authentication

# Completion report
/pdca report user-authentication

# Check current status
/pdca status

# Guide to next phase
/pdca next

Legacy Commands Mapping

Legacy Command	PDCA Skill
/pdca-plan	/pdca plan
/pdca-design	/pdca design
/pdca-analyze	/pdca analyze
/pdca-iterate	/pdca iterate
/pdca-report	/pdca report
/pdca-status	/pdca status
/pdca-next	/pdca next
/archive	/pdca archive

Auto Triggers

Auto-suggest related action when detecting these keywords:

Keyword	Suggested Action
"plan", "planning", "roadmap"	plan
"design", "architecture", "spec"	design
"implement", "develop", "build"	do
"verify", "analyze", "check"	analyze
"improve", "iterate", "fix"	iterate
"complete", "report", "summary"	report
"archive", "cleanup", "store"	archive

⚡ Optimization Integration

When using this skill for critical tasks, please run it within a /native-trace context to capture performance data for self-improvement via /aioptimize.