Files
Pier_v1/.hmcmkit/knowledge/templates/report.template.md
T
ahnyongjooandClaude Sonnet 5.5 964a841de1 chore(rebar): Pier_T_rebar 작업 폴더 초기 구성 및 외부 의존 파일 통합
- 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>
2026-10-28 11:20:18 +09:00

241 lines
6.4 KiB
Markdown

---
template: report
version: 1.1
description: PDCA Act phase document template (completion report)
variables:
- feature: Feature name
- date: Creation date (YYYY-MM-DD)
- author: Author
- project: Project name (from package.json or agents.md)
- version: Project version (from package.json)
---
# {feature} Completion Report
> **Status**: Complete / Partial / Cancelled
>
> **Project**: {project}
> **Version**: {version}
> **Author**: {author}
> **Completion Date**: {date}
> **PDCA Cycle**: #{cycle_number}
---
## Executive Summary
### 1.1 Project Overview
| Item | Content |
|------|---------|
| Feature | {feature} |
| Start Date | {start_date} |
| End Date | {date} |
| Duration | {duration} |
### 1.2 Results Summary
```
┌─────────────────────────────────────────────┐
│ Completion Rate: 95% │
├─────────────────────────────────────────────┤
│ ✅ Complete: 19 / 20 items │
│ ⏳ In Progress: 1 / 20 items │
│ ❌ Cancelled: 0 / 20 items │
└─────────────────────────────────────────────┘
```
### 1.3 Value Delivered
| Perspective | Content |
|-------------|---------|
| **Problem** | {Core problem that was solved} |
| **Solution** | {Solution approach that was applied} |
| **Function/UX Effect** | {Actual achieved functional/UX impact with metrics} |
| **Core Value** | {Validated core value} |
---
## 1.4 Success Criteria Final Status
> From Plan document — final evaluation of each criterion.
| # | Criteria | Status | Evidence |
|---|---------|:------:|----------|
| SC-1 | {criteria text} | ✅ Met | {file:line, test result, or metric} |
| SC-2 | {criteria text} | ✅ Met | {file:line, test result, or metric} |
**Success Rate**: {X}/{Y} criteria met ({percentage}%)
## 1.5 Decision Record Summary
> Key decisions from PRD→Plan→Design chain and their outcomes.
| Source | Decision | Followed? | Outcome |
|--------|----------|:---------:|---------|
| [PRD] | {decision} | ✅ | {actual outcome} |
| [Plan] | {decision} | ✅ | {actual outcome} |
| [Design] | {decision} | ✅ | {actual outcome} |
---
## 2. Related Documents
| Phase | Document | Status |
|-------|----------|--------|
| Plan | [{feature}.plan.md](../01-plan/features/{feature}.plan.md) | ✅ Finalized |
| Design | [{feature}.design.md](../02-design/features/{feature}.design.md) | ✅ Finalized |
| Check | [{feature}.analysis.md](../03-analysis/{feature}.analysis.md) | ✅ Complete |
| Act | Current document | 🔄 Writing |
---
## 3. Completed Items
### 3.1 Functional Requirements
| ID | Requirement | Status | Notes |
|----|-------------|--------|-------|
| FR-01 | {Requirement 1} | ✅ Complete | |
| FR-02 | {Requirement 2} | ✅ Complete | |
| FR-03 | {Requirement 3} | ✅ Complete | Scope reduced |
| FR-04 | {Requirement 4} | ⏳ Next cycle | Time constraint |
### 3.2 Non-Functional Requirements
| Item | Target | Achieved | Status |
|------|--------|----------|--------|
| Performance | < 200ms | 150ms | ✅ |
| Test Coverage | 80% | 82% | ✅ |
| Accessibility | WCAG 2.1 AA | AA compliant | ✅ |
### 3.3 Deliverables
| Deliverable | Location | Status |
|-------------|----------|--------|
| Components | src/features/{feature}/components/ | ✅ |
| API | src/features/{feature}/api/ | ✅ |
| Tests | src/features/{feature}/__tests__/ | ✅ |
| Documentation | docs/ | ✅ |
---
## 4. Incomplete Items
### 4.1 Carried Over to Next Cycle
| Item | Reason | Priority | Estimated Effort |
|------|--------|----------|------------------|
| FR-04 | Time constraint | High | 2 days |
| Performance optimization | Out of scope | Medium | 1 day |
### 4.2 Cancelled/On Hold Items
| Item | Reason | Alternative |
|------|--------|-------------|
| - | - | - |
---
## 5. Quality Metrics
### 5.1 Final Analysis Results
| Metric | Target | Final | Change |
|--------|--------|-------|--------|
| Design Match Rate | 90% | 95% | +20% |
| Code Quality Score | 70 | 85 | +15 |
| Test Coverage | 80% | 82% | +12% |
| Security Issues | 0 Critical | 0 | ✅ |
### 5.2 Resolved Issues
| Issue | Resolution | Result |
|-------|------------|--------|
| Hardcoded secret | Moved to env var | ✅ Resolved |
| N+1 query | Eager Loading | ✅ Resolved |
| Missing input validation | Added Zod schema | ✅ Resolved |
---
## 6. Lessons Learned & Retrospective
### 6.1 What Went Well (Keep)
- {Positive 1: e.g., Design documentation improved implementation efficiency}
- {Positive 2: e.g., Early code review caught bugs proactively}
- {Positive 3}
### 6.2 What Needs Improvement (Problem)
- {Improvement 1: e.g., Initial scope estimation was inaccurate}
- {Improvement 2: e.g., Test cases written too late}
- {Improvement 3}
### 6.3 What to Try Next (Try)
- {Try 1: e.g., Adopt TDD approach}
- {Try 2: e.g., Smaller PR units}
- {Try 3}
---
## 7. Process Improvement Suggestions
### 7.1 PDCA Process
| Phase | Current | Improvement Suggestion |
|-------|---------|------------------------|
| Plan | Insufficient requirement gathering | Add user interviews |
| Design | - | - |
| Do | Poor design reference | Introduce design checklist |
| Check | Manual analysis | Introduce automation tools |
### 7.2 Tools/Environment
| Area | Improvement Suggestion | Expected Benefit |
|------|------------------------|------------------|
| CI/CD | Auto deployment | Reduced deployment time |
| Testing | Add E2E tests | Quality improvement |
---
## 8. Next Steps
### 8.1 Immediate
- [ ] Production deployment
- [ ] Monitoring setup
- [ ] User guide creation
### 8.2 Next PDCA Cycle
| Item | Priority | Expected Start |
|------|----------|----------------|
| {Next feature 1} | High | {date} |
| {Next feature 2} | Medium | {date} |
---
## 9. Changelog
### v1.0.0 ({date})
**Added:**
- {Added feature 1}
- {Added feature 2}
**Changed:**
- {Changed item}
**Fixed:**
- {Fixed bug}
---
## Version History
| Version | Date | Changes | Author |
|---------|------|---------|--------|
| 1.0 | {date} | Completion report created | {author} |