ahnyongjooandClaude Sonnet 5.5
964a841de1
- Code\rebar_pipeline, review_pipeline, pier-program을 정션에서 실제 폴더로 전환 - Code\rhino_mcp 및 CLAUDE_rhino배경.md 추가, .mcp.json은 PYTHONPATH로 새 위치 사용 - pier-program 내부 .git 제거(이력은 backup\pier-program_20261028.bundle에 보관) - worktree 가이드 반영(CLAUDE.local.md, HANDOFF.md) - D:\Rhino-MCP 경로 참조를 새 위치로 치환 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
168 lines
5.3 KiB
Markdown
168 lines
5.3 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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
|