popilot 0.2.0

package/scaffold/.context/templates/guardrail.md

@@ -0,0 +1,94 @@
+# Guard Rail Inspection Template
+
+> 📊 Side-effect monitoring template used by Vicky
+
+## Guard Rail Inspection Report
+
+### Inspection Information
+- **Inspection date**: [Date]
+- **Inspection period**: [Start date] ~ [End date]
+- **Related sprint**: Sprint [N]
+- **Related feature**: [Feature name]
+
+---
+
+## Guard Rail Metric Status
+
+### Core Guard Rail
+| Metric | Threshold | Before | After | Change | Status |
+|--------|-----------|--------|-------|--------|--------|
+| [Metric 1] | ≤ [Value] | [Value] | [Value] | [+/-]% | 🟢/🟡/🔴 |
+| [Metric 2] | ≥ [Value] | [Value] | [Value] | [+/-]% | 🟢/🟡/🔴 |
+| [Metric 3] | ≤ [Value] | [Value] | [Value] | [+/-]% | 🟢/🟡/🔴 |
+
+### Status Definitions
+- 🟢 **Normal**: Threshold met, stable
+- 🟡 **Caution**: Near threshold (±10%), monitoring needed
+- 🔴 **Warning**: Threshold exceeded, immediate action required
+
+---
+
+## Detailed Analysis
+
+### 🟢 Normal Metrics
+| Metric | Status | Notes |
+|--------|--------|-------|
+| [Metric] | Within threshold | [Additional comment] |
+
+### 🟡 Caution Metrics
+| Metric | Current Value | Threshold | Trend | Recommended Action |
+|--------|--------------|-----------|-------|-------------------|
+| [Metric] | [Value] | [Threshold] | ↑/↓/→ | [Action] |
+
+### 🔴 Warning Metrics
+| Metric | Current Value | Threshold | Excess | Immediate Action |
+|--------|--------------|-----------|--------|-----------------|
+| [Metric] | [Value] | [Threshold] | [+/-]% | [Action] |
+
+---
+
+## Warning Details
+
+### [Warning Metric Name]
+
+**Situation**
+- Current value: [Value]
+- Threshold: [Threshold]
+- Excess: [%]
+
+**Root Cause Analysis**
+- [Suspected cause 1]
+- [Suspected cause 2]
+
+**Immediate Actions**
+- [ ] [Action 1]
+- [ ] [Action 2]
+
+**Monitoring Plan**
+- Next inspection: [Date]
+- Responsible: [Owner]
+
+---
+
+## Recommendations
+
+### Immediate Execution
+- [ ] [Action 1]
+
+### Verify at Next Inspection
+- [ ] [Verification item]
+
+### Long-term Improvement
+- [ ] [Improvement item]
+
+---
+
+## Next Inspection
+
+- **Scheduled date**: [Date]
+- **Focus area**: [Metric]
+
+---
+
+*Written by: 📊 Vicky*
+*Written date: [Date]*

package/scaffold/.context/templates/handoff-checklist.md

@@ -0,0 +1,197 @@
+# Handoff Quality Verification Checklist
+
+> 📋 Pre-handoff story quality verification used by Penny (BMAD-METHOD based)
+
+---
+
+## Verification Target
+
+| Item | Value |
+|------|-------|
+| **Story ID** | [E-N-S-M] |
+| **Story Title** | [Title] |
+| **Reviewer** | [Penny / Person name] |
+| **Review Date** | [YYYY-MM-DD] |
+
+---
+
+## Phase 1: Context & Requirements Verification
+
+### User Story Verification
+- [ ] Is the **Role** clearly defined?
+- [ ] Is the **Feature (Want)** specifically described?
+- [ ] Is the **Value (So that)** connected to business goals?
+
+### Acceptance Criteria Verification
+- [ ] Are all acceptance criteria **testable**?
+- [ ] Is the **Given-When-Then** format complete?
+- [ ] Is there **consistency** with PRD/Epic?
+- [ ] Are **edge cases** included?
+
+### Task Breakdown Verification
+- [ ] Are tasks **mapped** to acceptance criteria?
+- [ ] Are subtasks **specific** enough?
+- [ ] Is the estimated workload **realistic**?
+
+---
+
+## Phase 2: Disaster Prevention Analysis
+
+### Feature Duplication Check
+- [ ] Confirmed whether **similar functionality** exists in current code?
+- [ ] Identified **reusable components**?
+- [ ] Is there an **integration plan** if duplicated?
+
+**Duplicates Found**:
+```
+[None / Detail if found]
+```
+
+### Technical Error Check
+- [ ] Are **library versions** compatible?
+- [ ] Analyzed **API contract** change impact?
+- [ ] Are **type definitions** consistent?
+
+**Technical Cautions**:
+```
+[None / Detail if found]
+```
+
+### File Structure Check
+- [ ] Does file creation location follow **project conventions**?
+- [ ] No impact on **build process**?
+- [ ] Are **import paths** correct?
+
+### Regression Check
+- [ ] Do **existing tests** pass?
+- [ ] Created list of **affected features**?
+- [ ] Reviewed **side effect** possibilities?
+
+**Affected Features**:
+```
+[None / Detail if found]
+```
+
+### Implementation Ambiguity Check
+- [ ] Are all **edge cases** defined?
+- [ ] Are **error handling methods** specified?
+- [ ] Is **null/undefined handling** defined?
+- [ ] Is **concurrency/race condition** considered?
+
+**Ambiguous Areas**:
+```
+[None / Detail with resolution plan if found]
+```
+
+---
+
+## Phase 2.5: Screen Spec Verification (For UI Epics)
+
+> Applies only to Epics with UI. N/A for backend-only Epics
+
+### Screen Spec Completeness
+
+- [ ] **Level 1~2** (IA/Main screen): Is the overall structure and layout expressed in ASCII?
+- [ ] **Level 3** (Components): Are all state variants defined?
+- [ ] **Level 4** (Modals): Are validation and save behavior defined?
+- [ ] **Level 5** (External integration): Are connections with existing screens defined?
+- [ ] **Level 6** (State-based UI): Are loading/empty/error states defined?
+- [ ] **Level 7** (Policies): Are all policies organized in tables?
+
+### Screen Spec Quality
+
+- [ ] Are **specs (size, color, behavior)** specified for all UI elements?
+- [ ] Are **ASCII diagrams** at a level developers can understand?
+- [ ] Is the Epic Spec **business logic** reflected in the screen spec?
+- [ ] Are **edge case UIs** defined?
+
+### Story Linkage
+
+- [ ] Is the screen spec **link added** to References in all related Stories?
+- [ ] Are Story tasks **mapped** to screen spec Levels?
+
+**Screen spec file**:
+```
+sprints/s{N}/design/{Epic-ID}-screen-spec.md
+```
+
+### spec-site Verification
+- [ ] Does the interactive mockup match the ACs?
+- [ ] Are all scenarios defined?
+- [ ] Are empty/error states included in the mockup?
+
+---
+
+## Phase 3: AI Agent Optimization Verification
+
+### Dev Notes Verification
+- [ ] Is the **architecture pattern** specified?
+- [ ] Is the **reference implementation** provided with accurate paths?
+- [ ] Are **things to avoid** specified?
+
+### Source Tree Verification
+- [ ] Is the **affected file list** complete?
+- [ ] Are **new files** marked?
+- [ ] Are **change summaries** present?
+
+### References Verification
+- [ ] Is the PRD link **valid**?
+- [ ] Is the design link **up to date**?
+- [ ] Are reference implementation paths **accurate**?
+
+### Conflict Detection Verification
+- [ ] Are all conflict items in **✅ None** status?
+- [ ] Are there resolution plans for **⚠️ Caution** items?
+
+---
+
+## Phase 4: Final Check
+
+### Meta Information
+- [ ] Is the **Story ID** correct?
+- [ ] Is the **Epic connection** established?
+- [ ] Is the **priority** set?
+- [ ] Is the **size** estimated?
+
+### Event Logging
+- [ ] Are **required events** defined?
+- [ ] Are **parameters** specified?
+- [ ] Is **GA4 status** indicated?
+
+### Status
+- [ ] Is the status set to **`ready-for-dev`**?
+
+---
+
+## Verification Result
+
+### Overall Assessment
+
+| Phase | Result |
+|-------|--------|
+| Phase 1: Context & Requirements | ✅ PASS / ❌ FAIL |
+| Phase 2: Disaster Prevention | ✅ PASS / ❌ FAIL |
+| Phase 2.5: Screen Spec | ✅ PASS / ❌ FAIL / ⏭️ N/A |
+| Phase 3: AI Agent Optimization | ✅ PASS / ❌ FAIL |
+| Phase 4: Final Check | ✅ PASS / ❌ FAIL |
+
+### Final Verdict
+
+**✅ PASS** - Ready for handoff
+
+or
+
+**❌ FAIL** - Modifications required
+
+### Required Modifications (If FAIL)
+
+| Priority | Item | Description |
+|----------|------|-------------|
+| Required | [Item] | [Modification needed] |
+| Recommended | [Item] | [Modification needed] |
+
+---
+
+**Reviewer**: [Name]
+**Review Date**: [YYYY-MM-DD]
+**Signature**: ✓

package/scaffold/.context/templates/prd.md

@@ -0,0 +1,80 @@
+# PRD Template
+
+> 🎯 PRD writing template used by Simon
+
+## [Feature/Sprint Name]
+
+### One Question
+[The single question this sprint must answer]
+
+---
+
+### Background
+#### Problem Definition
+[What problem are we trying to solve?]
+
+#### Current State
+[Before - Current metrics/situation]
+
+#### Expected Outcome
+[After - Anticipated improvements]
+
+---
+
+### Hypothesis
+> [IF] we do ______,
+> [THEN] ______ will improve.
+> [BECAUSE] ______.
+
+**Falsifiability**: [How would we know if the hypothesis is wrong?]
+
+---
+
+### OMTM (One Metric That Matters)
+| Metric | Before | Target | Measurement Method |
+|--------|--------|--------|-------------------|
+| [Key metric] | [Current value] | [Target value] | [GA4 event, etc.] |
+
+---
+
+### Validation Method
+- **Measurement period**: [Start date] ~ [End date]
+- **Sample**: [Target user group]
+- **Success criteria**: [Quantitative criteria]
+- **Failure criteria**: [When do we abandon?]
+
+---
+
+### Guard Rail
+| Metric | Current | Acceptable Range | Monitoring |
+|--------|---------|-----------------|------------|
+| [Side-effect metric 1] | [Value] | ≤ [Threshold] | [Method] |
+| [Side-effect metric 2] | [Value] | ≤ [Threshold] | [Method] |
+
+---
+
+### Scope
+#### In Scope
+- [ ] Included item 1
+- [ ] Included item 2
+
+#### Out of Scope
+- Excluded item 1
+- Excluded item 2
+
+---
+
+### References
+- Related PRD: [Link]
+- Competitive analysis: [Link]
+- User research: [Link]
+
+---
+
+## Checklist
+- [ ] Is the One Question clear?
+- [ ] Is the hypothesis falsifiable?
+- [ ] Is the OMTM quantified?
+- [ ] Is the validation method realistic?
+- [ ] Is the Guard Rail set?
+- [ ] Is the scope clear?

package/scaffold/.context/templates/retrospective.md

@@ -0,0 +1,78 @@
+# Sprint Retrospective Template
+
+> 📋 Penny + 📊 Vicky collaborative template
+
+## Sprint [N] Retrospective
+
+### Sprint Information
+- **Period**: [Start date] ~ [End date]
+- **Goal**: [Sprint goal]
+
+---
+
+## Results Summary (📊 Vicky)
+
+### KR Achievement Status
+| KR | Target | Result | Achievement Rate | Verdict |
+|----|--------|--------|-----------------|---------|
+| KR1 | [Target] | [Result] | [%] | ✅/❌ |
+| KR2 | [Target] | [Result] | [%] | ✅/❌ |
+| KR3 | [Target] | [Result] | [%] | ✅/❌ |
+
+### Guard Rail
+| Metric | Threshold | Result | Status |
+|--------|-----------|--------|--------|
+| [Metric 1] | ≤ [Value] | [Value] | 🟢/🟡/🔴 |
+
+### Key Findings
+- [Insight discovered from data]
+
+---
+
+## Retrospective (📋 Penny)
+
+### What Went Well (Liked)
+- [Good thing 1]
+- [Good thing 2]
+
+### What We Learned (Learned)
+- [Learning 1]
+- [Learning 2]
+
+### What Was Lacking (Lacked)
+- [Shortcoming 1]
+- [Shortcoming 2]
+
+### What We Wished For (Longed for)
+- [Wish 1]
+- [Wish 2]
+
+---
+
+## Action Items
+
+### Apply to Next Sprint
+| Action | Type | Owner | Priority |
+|--------|------|-------|----------|
+| [Action 1] | Start | [Owner] | P0/P1/P2 |
+| [Action 2] | Stop | [Owner] | P0/P1/P2 |
+| [Action 3] | Continue | [Owner] | P0/P1/P2 |
+
+### Add to Backlog
+- [ ] [Backlog item]
+
+---
+
+## Team Health
+
+| Item | Score (1-5) | Comment |
+|------|-------------|---------|
+| Goal clarity | [Score] | [Comment] |
+| Communication | [Score] | [Comment] |
+| Execution | [Score] | [Comment] |
+| Learning | [Score] | [Comment] |
+
+---
+
+*Retrospective date: [Date]*
+*Participants: [Participants]*