triples-agentic 2.4.0

package/src/templates/prd.md

@@ -0,0 +1,109 @@
+# Product Requirements Document: [Feature / Product Name]
+
+**Author:** JiWoo (Senior PM)
+**Status:** Draft | Under Review | Approved
+**Date:** YYYY-MM-DD
+**Version:** 1.0
+
+---
+
+## Problem Statement
+
+> One paragraph. What specific user problem are we solving? Who experiences it? Why does it matter now?
+
+---
+
+## User Personas
+
+### Primary Persona: [Persona Name]
+- **Role:** [Job title or user type]
+- **Goals:** [What they are trying to accomplish]
+- **Frustrations:** [What currently gets in their way]
+- **Context:** [When and how they interact with this product]
+
+### Secondary Persona (if applicable): [Persona Name]
+- **Role:**
+- **Goals:**
+- **Context:**
+
+---
+
+## Feature Scope
+
+### In Scope
+- [Feature or capability included in this release]
+- [Feature or capability included in this release]
+- [Feature or capability included in this release]
+
+### Out of Scope
+- [Feature or capability explicitly excluded — with brief reason]
+- [Feature or capability explicitly excluded]
+
+---
+
+## User Stories
+
+| ID | As a... | I want to... | So that... | Priority |
+|----|---------|-------------|------------|---------|
+| US-01 | [persona] | [goal] | [benefit] | P0/P1/P2 |
+| US-02 | [persona] | [goal] | [benefit] | P0/P1/P2 |
+| US-03 | [persona] | [goal] | [benefit] | P0/P1/P2 |
+
+---
+
+## Acceptance Criteria
+
+### US-01: [Story Title]
+- [ ] **Given** [context], **When** [action], **Then** [specific measurable outcome]
+- [ ] **Given** [context], **When** [action], **Then** [specific measurable outcome]
+
+### US-02: [Story Title]
+- [ ] **Given** [context], **When** [action], **Then** [specific measurable outcome]
+
+---
+
+## Success Metrics
+
+| Metric | Baseline | Target | Measurement Method |
+|--------|----------|--------|-------------------|
+| [Metric name] | [Current value] | [Target value] | [How to measure] |
+| [Metric name] | [Current value] | [Target value] | [How to measure] |
+
+---
+
+## Non-Functional Requirements
+
+- **Performance:** [e.g., page load < 2s on 3G; API response < 200ms p95]
+- **Security:** [e.g., all data encrypted at rest and in transit]
+- **Accessibility:** WCAG 2.1 AA compliance required
+- **Internationalization:** [supported locales, RTL if applicable]
+- **Browser/Platform Support:** [e.g., last 2 versions of Chrome, Firefox, Safari]
+
+---
+
+## Dependencies & Risks
+
+### Dependencies
+- [System, team, or data source this depends on]
+- [Third-party service required]
+
+### Risks
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+| [Risk description] | High/Med/Low | High/Med/Low | [How to mitigate] |
+
+---
+
+## Open Questions
+
+| # | Question | Owner | Due Date |
+|---|----------|-------|---------|
+| 1 | [Unanswered question] | [Person responsible] | [Date] |
+
+---
+
+## Update History
+
+| Version | Date | Changed By | Summary |
+|---------|------|------------|---------|
+| 1.0 | YYYY-MM-DD | JiWoo | Initial draft |

package/src/templates/rfc.md

@@ -0,0 +1,156 @@
+# RFC: [Feature / System Name]
+
+**Author:** YooYeon (Staff Engineer)
+**Status:** Draft | Under Review | Approved | Superseded
+**Date:** YYYY-MM-DD
+**Version:** 1.0
+**Related PRD:** workspace/PRD.md
+
+---
+
+## Summary
+
+> One paragraph: what is being built, using what approach, and the key trade-off explicitly accepted.
+
+---
+
+## Motivation
+
+Why is this being built now? What problem does it solve that current systems cannot address? Reference the PRD problem statement.
+
+---
+
+## Technical Proposal
+
+### Architecture Overview
+
+```
+[ASCII diagram or description of how components interact]
+
+Client → API Gateway → [Service A] → [Database]
+                    ↘ [Service B] → [Cache]
+```
+
+### Data Model
+
+```sql
+-- Key tables / schemas / collections
+
+CREATE TABLE users (
+  id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  email       TEXT NOT NULL UNIQUE,
+  created_at  TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at  TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- [Additional entities...]
+```
+
+### API Contracts
+
+```
+POST /api/v1/[resource]
+Authorization: Bearer <token>
+Content-Type: application/json
+
+Request:
+{
+  "field": "value"
+}
+
+Response 201:
+{
+  "data": {
+    "id": "uuid",
+    "field": "value",
+    "createdAt": "2024-01-01T00:00:00Z"
+  }
+}
+
+Response 400:
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "field is required",
+    "field": "field"
+  }
+}
+```
+
+### Key Algorithms / Business Logic
+
+> Describe any non-trivial logic that needs design attention: pricing calculations, state machines, rate limiting, etc.
+
+### Infrastructure & Deployment
+
+- **Hosting:** [Cloud provider, region, service type]
+- **Scaling:** [How does this scale under load?]
+- **Observability:** [Logs, metrics, traces — what is instrumented?]
+- **Environment config:** [Environment variables required]
+
+---
+
+## Alternatives Considered
+
+### Alternative 1: [Name]
+**Description:** What was this approach?
+**Rejected because:** [Specific reason — not just "worse"]
+
+### Alternative 2: [Name]
+**Description:** What was this approach?
+**Rejected because:** [Specific reason]
+
+---
+
+## Trade-offs & Risks
+
+| Trade-off / Risk | Impact | Mitigation |
+|-----------------|--------|------------|
+| [What we give up or what could go wrong] | High/Med/Low | [How we mitigate] |
+| [Trade-off] | High/Med/Low | [Mitigation] |
+
+---
+
+## Migration Plan
+
+> If this changes existing behavior or data: how do existing users/data get migrated?
+
+1. [Migration step]
+2. [Migration step]
+3. [Verification step]
+
+---
+
+## Rollout Plan
+
+- **Feature flag:** [flag name — yes/no and rollout strategy]
+- **Phased rollout:** [e.g., 1% → 10% → 100% with monitoring gates]
+- **Rollback procedure:** [How to undo this change if it goes wrong]
+- **Go-live checklist:**
+  - [ ] Database migration run and verified
+  - [ ] Feature flag configured
+  - [ ] Monitoring dashboards set up
+  - [ ] Runbook updated
+
+---
+
+## Open Questions
+
+| # | Question | Owner | Due Date |
+|---|----------|-------|---------|
+| 1 | [Unresolved technical question] | [Person] | [Date] |
+
+---
+
+## References
+
+- [Link to PRD: workspace/PRD.md]
+- [External documentation, standards, or prior RFCs]
+
+---
+
+## Update History
+
+| Version | Date | Changed By | Summary |
+|---------|------|------------|---------|
+| 1.0 | YYYY-MM-DD | YooYeon | Initial draft |

package/src/templates/task-breakdown.md

@@ -0,0 +1,172 @@
+# Task Breakdown: [Feature / Sprint Name]
+
+**Author:** NaKyoung (TPM)
+**Date:** YYYY-MM-DD
+**Related PRD:** workspace/PRD.md
+**Related RFC:** workspace/RFC.md
+**Sprint:** [Sprint N] | **Duration:** [X weeks]
+**Total Story Points:** [sum]
+**Estimated Timeline:** [X–Y weeks]
+
+---
+
+## Team Allocation
+
+| Agent | Role | Platforms |
+|-------|------|-----------|
+| YuBin | Frontend Web | Web |
+| Kaede | Backend | API / Server |
+| YeonJi | Android | Android Native |
+| SoHyun | iOS | iOS Native |
+| Kotone | Flutter | Android + iOS + Web |
+
+*Only activate agents for platforms confirmed in PRD/RFC.*
+
+---
+
+## Epic: [Epic Name]
+
+> Brief description of what this epic delivers and why.
+
+---
+
+### Story: US-01 — [User Story Title]
+
+> As a [persona], I want [goal] so that [benefit].
+
+---
+
+#### TASK-001: [Short imperative title]
+
+**Story Points:** 3
+**Estimated Hours:** 4–8h
+**Assignee:** [YuBin / Kaede / YeonJi / SoHyun / Kotone]
+**Platform:** [Web / Android / iOS / Flutter / Backend]
+**Dependencies:** none / TASK-XXX
+
+**Description:**
+One paragraph of what needs to be done and why.
+
+**Acceptance Criteria:**
+- [ ] [Specific, binary pass/fail criterion]
+- [ ] [Specific, binary pass/fail criterion]
+- [ ] [Specific, binary pass/fail criterion]
+
+**Technical Notes:**
+[Any non-obvious constraints, API endpoints to call, or design assets to reference]
+
+**Definition of Done:**
+- [ ] Code written, reviewed, and merged
+- [ ] Unit/component tests written and passing
+- [ ] Integrated and verified in dev environment
+- [ ] No regressions in existing functionality
+
+---
+
+#### TASK-002: [Short imperative title]
+
+**Story Points:** 5
+**Estimated Hours:** 1–2 days
+**Assignee:** [Agent]
+**Platform:** [Platform]
+**Dependencies:** TASK-001
+
+**Description:**
+[Description]
+
+**Acceptance Criteria:**
+- [ ] [Criterion]
+- [ ] [Criterion]
+
+**Technical Notes:**
+[Notes]
+
+**Definition of Done:**
+- [ ] Code written, reviewed, and merged
+- [ ] Tests written and passing
+- [ ] Verified in dev environment
+
+---
+
+### Story: US-02 — [User Story Title]
+
+---
+
+#### TASK-003: [Short imperative title]
+
+**Story Points:** 2
+**Estimated Hours:** 2–4h
+**Assignee:** [Agent]
+**Platform:** Backend
+**Dependencies:** none
+
+**Description:**
+[Description]
+
+**Acceptance Criteria:**
+- [ ] [Criterion]
+
+**Technical Notes:**
+[Notes]
+
+**Definition of Done:**
+- [ ] Code written, reviewed, and merged
+- [ ] Integration test passing
+- [ ] API documented
+
+---
+
+## Infrastructure / Setup Tasks
+
+> Technical tasks required by the RFC that don't map to user stories.
+
+#### TASK-I01: [Infrastructure task title]
+
+**Story Points:** 3
+**Estimated Hours:** 4–8h
+**Assignee:** Kaede (Backend)
+**Platform:** Backend / DevOps
+**Dependencies:** none
+
+**Description:**
+[e.g., Configure PostgreSQL schema and run initial migration]
+
+**Acceptance Criteria:**
+- [ ] Migration runs successfully in dev environment
+- [ ] Rollback migration also tested
+
+---
+
+## Dependency Map
+
+```
+TASK-I01 (DB setup)
+    └── TASK-001 (API endpoint)
+            └── TASK-002 (Frontend integration)
+                    └── TASK-003 (UI polish)
+```
+
+---
+
+## Timeline Estimate
+
+| Week | Focus | Tasks |
+|------|-------|-------|
+| Week 1 | Setup + Core API | TASK-I01, TASK-003 |
+| Week 2 | Core Features | TASK-001, TASK-002 |
+| Week 3 | Polish + QA | Remaining tasks + QA gate |
+
+**Buffer:** Add 20% to account for reviews, bug fixes, and unplanned complexity.
+
+---
+
+## Story Point Summary
+
+| Agent | Tasks | Points | Est. Time |
+|-------|-------|--------|-----------|
+| YuBin | [N] tasks | [X] pts | [X days] |
+| Kaede | [N] tasks | [X] pts | [X days] |
+| YeonJi | [N] tasks | [X] pts | [X days] |
+| SoHyun | [N] tasks | [X] pts | [X days] |
+| Kotone | [N] tasks | [X] pts | [X days] |
+| **Total** | | **[X] pts** | **[X–Y weeks]** |

package/src/templates/test-case.md

@@ -0,0 +1,157 @@
+# Test Cases: [Feature Name]
+
+**Author:** Lynn (QA Lead)
+**Date:** YYYY-MM-DD
+**Related PRD:** workspace/PRD.md
+**Related RFC:** workspace/RFC.md
+**Total Test Cases:** [N]
+**Smoke Suite (P0):** [N] cases
+
+---
+
+## Test Data Requirements
+
+Before executing, ensure the following test data is in place:
+
+| Data | Description | Where to Create |
+|------|-------------|----------------|
+| Standard user | Active account, no special permissions | [Setup instructions] |
+| Admin user | Account with admin role | [Setup instructions] |
+| [Other fixture] | [Description] | [Setup instructions] |
+
+---
+
+## Test Suite: [Feature / User Story Name]
+
+### TC-001: [Short descriptive title — happy path]
+
+**Priority:** P0
+**Type:** Positive / Happy Path
+**Platform:** Web / Android / iOS / Flutter / All
+**Related:** US-01
+
+**Preconditions:**
+- User is logged in with a standard account
+- [Other preconditions — precise system state]
+
+**Test Steps:**
+1. Navigate to [screen or URL]
+2. [Action on specific element]
+3. [Enter specific data: use concrete values, not "valid input"]
+4. [Click/tap specific button]
+
+**Expected Result:**
+- [Specific, observable outcome — not "works correctly"]
+- [System state change — e.g., "Record appears in the list"]
+- [Performance expectation if applicable — e.g., "Response within 2 seconds"]
+
+**Test Data:**
+- Email: `test@example.com`
+- Password: `TestPassword123!`
+
+---
+
+### TC-002: [Error path title]
+
+**Priority:** P1
+**Type:** Negative / Error Path
+**Platform:** Web / All
+
+**Preconditions:**
+- [System state]
+
+**Test Steps:**
+1. [Step]
+2. [Step — with invalid input: e.g., "Enter `invalid-email` in the Email field"]
+3. [Step]
+
+**Expected Result:**
+- [Specific error message displayed verbatim if possible]
+- [System should NOT do X]
+- [User remains on the same screen]
+
+---
+
+### TC-003: [Edge case title]
+
+**Priority:** P2
+**Type:** Edge Case / Boundary
+**Platform:** All
+
+**Preconditions:**
+- [Precise state — e.g., "User has exactly 0 items in cart"]
+
+**Test Steps:**
+1. [Step]
+2. [Step with boundary value — e.g., "Enter 255 characters in the Name field (maximum allowed)"]
+3. [Step]
+
+**Expected Result:**
+- [Expected boundary behavior]
+
+---
+
+### TC-004: [Platform-specific title]
+
+**Priority:** P1
+**Type:** Platform-Specific
+**Platform:** Android
+
+**Preconditions:**
+- [Android-specific state — e.g., "Device is in portrait orientation"]
+
+**Test Steps:**
+1. [Step]
+2. [Android-specific action — e.g., "Rotate device to landscape"]
+3. [Step]
+
+**Expected Result:**
+- [Platform-specific expected behavior]
+
+---
+
+### TC-005: [Regression scenario]
+
+**Priority:** P1
+**Type:** Regression
+**Platform:** Web
+
+**Preconditions:**
+- [State]
+
+**Test Steps:**
+1. [Existing flow that should still work]
+2. [Step]
+
+**Expected Result:**
+- [Existing behavior preserved — confirm no regression]
+
+---
+
+## Automation Candidates
+
+Test cases recommended for automation (P0 and P1):
+
+| TC ID | Title | Framework | Priority |
+|-------|-------|-----------|---------|
+| TC-001 | [Title] | Playwright / XCUITest / Espresso | P0 |
+| TC-002 | [Title] | Playwright | P1 |
+
+---
+
+## Exploratory Testing Notes
+
+Areas for unscripted manual exploration:
+- [Area 1: e.g., "Test with slow network connection (DevTools throttling)"]
+- [Area 2: e.g., "Test with very long user-generated content"]
+- [Area 3: e.g., "Test concurrent actions from two browser tabs"]
+
+---
+
+## Traceability Matrix
+
+| Test Case | User Story | Acceptance Criterion |
+|-----------|-----------|---------------------|
+| TC-001 | US-01 | AC-01.1 |
+| TC-002 | US-01 | AC-01.2 (error state) |
+| TC-003 | US-02 | AC-02.1 |