Pier_v1/.hmcmkit/knowledge/templates/TEMPLATE-GUIDE.md

hmcmkit Template Selection Guide

Quick reference for choosing the right template for your task

---

Template Selection Flowchart

What are you doing?
│
├─► Starting a new feature?
│   │
│   ├─► Using 9-phase Pipeline? ──► Use Pipeline Templates
│   │   (Phase 1 → 2 → 3 → ... → 9)
│   │
│   └─► Using PDCA only? ──► Use PDCA Templates
│       (Plan → Design → Do → Check → Act)
│
├─► Analyzing implementation?
│   └─► analysis.template.md
│
├─► Writing completion report?
│   └─► report.template.md
│
└─► Setting up new project?
    └─► agents.template.md

---

PDCA Templates (Core)

Template	Phase	When to Use
plan.template.md	Plan	Starting a new feature, defining requirements
design.template.md	Design	Technical design for Dynamic level projects
design-starter.template.md	Design	Simple projects (static sites, portfolios)
design-enterprise.template.md	Design	Complex systems (microservices, k8s)
analysis.template.md	Check	Gap analysis, code review, performance check
report.template.md	Act	Completion report, retrospective

Level-Based Design Template Selection

Project Complexity?
│
├─► Simple (HTML/CSS, static site) ──► design-starter.template.md
│
├─► Medium (Web app, SaaS MVP) ──► design.template.md (default)
│
└─► Complex (Enterprise, MSA) ──► design-enterprise.template.md

---

Pipeline Templates (9-Phase)

Phase	Template	Purpose
1	pipeline/phase-1-schema.template.md	Terminology & data model
2	pipeline/phase-2-convention.template.md	Coding rules & architecture
3	pipeline/phase-3-mockup.template.md	UI prototypes
4	pipeline/phase-4-api.template.md	API specification
5	pipeline/phase-5-design-system.template.md	Component library
6	pipeline/phase-6-ui.template.md	UI implementation
7	pipeline/phase-7-seo-security.template.md	SEO & security
8	pipeline/phase-8-review.template.md	Architecture/convention review
9	pipeline/phase-9-deployment.template.md	Deployment config

Pipeline vs PDCA

Scenario	Use Pipeline	Use PDCA
New project from scratch	✅	⚠️
Adding feature to existing project	⚠️	✅
Quick fix / bug fix	❌	⚠️
Enterprise-grade development	✅	✅

---

Other Templates

Template	Purpose
agents.template.md	Generate agents.md for new projects
iteration-report.template.md	Evaluator-Optimizer iteration report
_INDEX.template.md	Folder document index

---

Template Features Comparison

Clean Architecture Support

Template	Layer Definition	Dependency Rules	Import Order
design.template.md	✅	✅	✅
design-starter.template.md	❌	❌	❌
design-enterprise.template.md	✅	✅	✅
phase-2-convention.template.md	✅	✅	✅
phase-8-review.template.md	✅	✅	✅

Convention Compliance Support

Template	Naming	Folder Structure	Env Variables
design.template.md	✅	✅	✅
analysis.template.md	✅	✅	✅
phase-2-convention.template.md	✅	✅	✅
phase-8-review.template.md	✅	✅	✅

---

Quick Commands

# PDCA Commands
/pdca-plan {feature}      # Create plan document
/pdca-design {feature}    # Create design document
/pdca-analyze {feature}   # Run gap analysis
/pdca-report {feature}    # Create completion report

# Pipeline Commands
/pipeline-start           # Start 9-phase pipeline
/pipeline-status          # Check current phase
/pipeline-next            # Go to next phase

# Project Setup
/setup-ai-agent-code        # Generate agents.md
/init-starter             # Initialize Starter level project
/init-dynamic             # Initialize Dynamic level project
/init-enterprise          # Initialize Enterprise level project

---

Cross-Reference Guide

PDCA ↔ Pipeline Integration

When using both PDCA and Pipeline:

1. Plan Phase: Reference Phase 1 (Schema) and Phase 2 (Convention) outputs
2. Design Phase: Reference Phase 3 (Mockup) and Phase 4 (API) outputs
3. Check Phase: Use Phase 8 (Review) checklist for verification

Document Location Convention

docs/
├── 01-plan/
│   ├── features/          # PDCA Plan documents
│   ├── schema.md          # Pipeline Phase 1
│   └── conventions.md     # Pipeline Phase 2
├── 02-design/
│   ├── features/          # PDCA Design documents
│   ├── mockup/            # Pipeline Phase 3
│   └── api/               # Pipeline Phase 4
├── 03-analysis/           # PDCA Check documents
└── 04-report/             # PDCA Act documents

---

Version: 1.0.0 Last Updated: 2026-01-20