agentic-sdlc 1.0.0

package/.agent/templates/Master-Documentation-Template.md

@@ -0,0 +1,269 @@
+# Master Documentation - [Project Name]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| Project | [Project Name] |
+| Version | [Current Version] |
+| Last Updated | [YYYY-MM-DD] |
+| Maintained By | @REPORTER |
+| Status | Active / Complete / Archived |
+
+---
+
+## 📋 Table of Contents
+1. [Project Overview](#project-overview)
+2. [Project Timeline](#project-timeline)
+3. [Architecture](#architecture)
+4. [Key Decisions](#key-decisions)
+5. [Artifacts Index](#artifacts-index)
+6. [Team & Roles](#team--roles)
+7. [Current Status](#current-status)
+8. [Known Issues](#known-issues)
+9. [Future Roadmap](#future-roadmap)
+
+---
+
+## 1. Project Overview
+
+### Business Context
+**Business Goals:**
+- [Goal 1]
+- [Goal 2]
+
+**Target Users:**
+- [User type 1]: [Description]
+- [User type 2]: [Description]
+
+**Success Criteria:**
+- [Criterion 1]
+- [Criterion 2]
+
+### Technical Summary
+| Aspect | Details |
+|--------|---------|
+| Platform | [Web/Mobile/Desktop/Embedded/CLI/API/Library] |
+| Tech Stack | [Technologies used] |
+| Deployment | [Deployment target] |
+| Repository | [Git URL] |
+| Documentation | [Docs URL] |
+
+---
+
+## 2. Project Timeline
+
+### Milestones
+| Phase | Start Date | End Date | Status | Key Deliverables |
+|-------|------------|----------|--------|------------------|
+| Planning | [Date] | [Date] | ✅ Complete | Project Plan v1 |
+| Design | [Date] | [Date] | ✅ Complete | System Design, UI/UX Design |
+| Development | [Date] | [Date] | 🔄 In Progress | Implementation |
+| Testing | [Date] | [Date] | ⏳ Pending | Test Reports |
+| Deployment | [Date] | [Date] | ⏳ Pending | Production Release |
+
+### Sprint Summary
+| Sprint | Focus | Completed | Status |
+|--------|-------|-----------|--------|
+| Sprint 1 | [Focus area] | [X/Y items] | ✅ Complete |
+| Sprint 2 | [Focus area] | [X/Y items] | 🔄 Active |
+
+---
+
+## 3. Architecture
+
+### High-Level Architecture
+```
+┌─────────────────────────────────────────────────────────┐
+│                    [System Name]                         │
+│  ┌──────────┐    ┌──────────┐    ┌──────────┐          │
+│  │Component │───▶│Component │───▶│Component │          │
+│  │    A     │    │    B     │    │    C     │          │
+│  └──────────┘    └──────────┘    └──────────┘          │
+└─────────────────────────────────────────────────────────┘
+```
+
+### Technology Stack
+| Layer | Technology | Version | Purpose |
+|-------|------------|---------|---------|
+| [Layer] | [Tech] | [Version] | [Purpose] |
+
+### Key Components
+| Component | Responsibility | Status |
+|-----------|----------------|--------|
+| [Component 1] | [Description] | ✅ Implemented |
+| [Component 2] | [Description] | 🔄 In Progress |
+
+---
+
+## 4. Key Decisions
+
+### Technical Decisions
+| Date | Decision | Rationale | Impact |
+|------|----------|-----------|--------|
+| [Date] | [Decision] | [Why] | [Impact] |
+
+### Design Decisions
+| Date | Decision | Rationale | Impact |
+|------|----------|-----------|--------|
+| [Date] | [Decision] | [Why] | [Impact] |
+
+### Scope Changes
+| Date | Change | Reason | Approved By |
+|------|--------|--------|-------------|
+| [Date] | [Change] | [Reason] | @PM + User |
+
+---
+
+## 5. Artifacts Index
+
+### Planning Documents
+| Document | Version | Date | Location | Status |
+|----------|---------|------|----------|--------|
+| Project Plan | v[X] | [Date] | `docs/sprints/sprint-1/plans/` | ✅ Approved |
+| Product Backlog | v[X] | [Date] | `docs/sprints/sprint-1/plans/` | 🔄 Active |
+
+### Design Documents
+| Document | Version | Date | Location | Status |
+|----------|---------|------|----------|--------|
+| System Design Spec | v[X] | [Date] | `docs/sprints/sprint-1/designs/` | ✅ Approved |
+| UI/UX Design Spec | v[X] | [Date] | `docs/sprints/sprint-1/designs/` | ✅ Approved |
+
+### Review Documents
+| Document | Version | Date | Location | Status |
+|----------|---------|------|----------|--------|
+| Design Verification | v[X] | [Date] | `docs/sprints/sprint-1/reviews/` | ✅ Approved |
+| Security Review | v[X] | [Date] | `docs/sprints/sprint-1/reviews/` | ✅ Approved |
+
+### Development Documents
+| Document | Version | Date | Location | Status |
+|----------|---------|------|----------|--------|
+| Development Log | v[X] | [Date] | `docs/sprints/sprint-1/logs/` | 🔄 Active |
+| DevOps Plan | v[X] | [Date] | `docs/sprints/sprint-1/logs/` | 🔄 Active |
+
+### Testing Documents
+| Document | Version | Date | Location | Status |
+|----------|---------|------|----------|--------|
+| Test Report | v[X] | [Date] | `docs/sprints/sprint-1/tests/` | ⏳ Pending |
+
+### Reports
+| Document | Version | Date | Location | Status |
+|----------|---------|------|----------|--------|
+| Phase Report | v[X] | [Date] | `docs/sprints/sprint-1/reports/` | ✅ Complete |
+| Final Project Report | v[X] | [Date] | `docs/global/reports/` | ⏳ Pending |
+
+---
+
+## 6. Team & Roles
+
+| Role | Responsibilities | Current Status |
+|------|------------------|----------------|
+| @PM | Project management, planning | Active |
+| @PO | Product ownership, backlog | Active |
+| @SA | System architecture | Complete |
+| @UIUX | UI/UX design | Complete |
+| @QA | Quality assurance | Active |
+| @SECA | Security analysis | Complete |
+| @DEV | Development | Active |
+| @DEVOPS | Infrastructure, deployment | Active |
+| @TESTER | Testing | Pending |
+| @REPORTER | Documentation | Active |
+| @STAKEHOLDER | Final approval | Pending |
+
+---
+
+## 7. Current Status
+
+### Overall Progress
+| Category | Progress | Status |
+|----------|----------|--------|
+| Planning | 100% | ✅ Complete |
+| Design | 100% | ✅ Complete |
+| Development | [X]% | 🔄 In Progress |
+| Testing | [X]% | ⏳ Pending |
+| Deployment | [X]% | ⏳ Pending |
+
+### Feature Status
+| Feature | Priority | Status | Notes |
+|---------|----------|--------|-------|
+| [Feature 1] | Must-Have | ✅ Complete | [Notes] |
+| [Feature 2] | Must-Have | 🔄 In Progress | [Notes] |
+| [Feature 3] | Should-Have | ⏳ Pending | [Notes] |
+
+### Current Sprint
+**Sprint [N]:** [Focus area]
+- **Start Date:** [Date]
+- **End Date:** [Date]
+- **Items:** [X/Y completed]
+- **Blockers:** [None / List]
+
+---
+
+## 8. Known Issues
+
+### Active Bugs
+| Bug ID | Title | Severity | Status | Assigned | ETA |
+|--------|-------|----------|--------|----------|-----|
+| BUG-001 | [Title] | High | Open | @DEV | [Date] |
+
+### Technical Debt
+| Item | Priority | Impact | Plan |
+|------|----------|--------|------|
+| [Debt item] | Medium | [Impact] | [Plan] |
+
+### Risks
+| Risk | Likelihood | Impact | Mitigation |
+|------|------------|--------|------------|
+| [Risk] | High/Med/Low | High/Med/Low | [Mitigation] |
+
+---
+
+## 9. Future Roadmap
+
+### Planned Features (Post-Launch)
+| Feature | Priority | Target Version | Notes |
+|---------|----------|----------------|-------|
+| [Feature] | Could-Have | v2.0 | [Notes] |
+
+### Improvement Areas
+- [Improvement 1]
+- [Improvement 2]
+
+### Maintenance Plan
+- **Regular Updates:** [Frequency]
+- **Security Patches:** [Process]
+- **Bug Fixes:** [SLA]
+
+---
+
+## 10. Quick Reference
+
+### Important Links
+- **Repository:** [URL]
+- **Staging:** [URL]
+- **Production:** [URL]
+- **Documentation:** [URL]
+- **CI/CD:** [URL]
+- **Monitoring:** [URL]
+
+### Key Contacts
+| Role | Contact | Availability |
+|------|---------|--------------|
+| Project Lead | [Name] | [Hours] |
+| Technical Lead | [Name] | [Hours] |
+
+### Emergency Procedures
+- **Incident Response:** See `incident-response.md`
+- **Rollback Procedure:** See `DevOps-Plan.md`
+- **On-Call:** [Contact info]
+
+---
+
+## Document History
+| Version | Date | Author | Changes |
+|---------|------|--------|---------|
+| 1.0 | [Date] | @REPORTER | Initial version |
+| 1.1 | [Date] | @REPORTER | Updated status |
+
+---
+
+#reporting #master-documentation

package/.agent/templates/Phase-Report-Template.md

@@ -0,0 +1,70 @@
+# Phase Report - [Phase Name]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| Phase | [Planning/Design/Development/Testing/Deployment] |
+| Date | [YYYY-MM-DD] |
+| Author | @REPORTER |
+| Status | Complete / In Progress |
+
+---
+
+## 1. Phase Summary
+| Metric | Planned | Actual |
+|--------|---------|--------|
+| Duration | [X days] | [X days] |
+| Items | [X] | [X] |
+| On Schedule | ✅/❌ | - |
+
+## 2. Completed Deliverables
+| Deliverable | Owner | Version | Status |
+|-------------|-------|---------|--------|
+| [Artifact name] | @[ROLE] | v[X] | ✅ Complete |
+
+## 3. Key Accomplishments
+- [Accomplishment 1]
+- [Accomplishment 2]
+
+## 4. Issues & Resolutions
+| Issue | Impact | Resolution | Status |
+|-------|--------|------------|--------|
+| [Issue 1] | [Impact] | [How resolved] | Resolved |
+
+## 5. Risks Identified
+| Risk | Likelihood | Impact | Mitigation |
+|------|------------|--------|------------|
+| [Risk description] | High/Med/Low | High/Med/Low | [Action] |
+
+## 6. Metrics
+
+### Development Metrics (if applicable)
+| Metric | Value |
+|--------|-------|
+| Features Completed | [X/Y] |
+| Code Coverage | [X]% |
+| Technical Debt Items | [X] |
+
+### Testing Metrics (if applicable)
+| Metric | Value |
+|--------|-------|
+| Test Pass Rate | [X]% |
+| Bugs Found | [X] |
+| Bugs Fixed | [X] |
+
+## 7. Lessons Learned
+- [Lesson 1]
+- [Lesson 2]
+
+## 8. Next Phase Preview
+| Phase | Start Date | Key Activities |
+|-------|------------|----------------|
+| [Next phase] | [Date] | [Activities] |
+
+---
+
+### Next Step:
+- @[NEXT_ROLE] - Begin [next phase activities]
+- @STAKEHOLDER - Review phase completion (if final phase)
+
+#reporting

package/.agent/templates/Product-Backlog-Template.md

@@ -0,0 +1,84 @@
+# Product Backlog - Version [X]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| Version | [X.0] |
+| Date | [YYYY-MM-DD] |
+| Author | @PO |
+| Status | Draft / Active |
+
+---
+
+## Backlog Summary
+| Priority | Count | Status |
+|----------|-------|--------|
+| Must-Have | [X] | [X] Done |
+| Should-Have | [X] | [X] Done |
+| Could-Have | [X] | [X] Done |
+
+---
+
+## Must-Have Items
+
+### [ITEM-001] [Item Title]
+| Field | Value |
+|-------|-------|
+| Priority | Must-Have |
+| Status | Todo / In Progress / Done |
+| Assigned | @[ROLE] |
+| Sprint | [Sprint #] |
+
+**Description:** [Brief description]
+
+**Acceptance Criteria:**
+- [ ] Criteria 1
+- [ ] Criteria 2
+
+---
+
+## Should-Have Items
+
+### [ITEM-002] [Item Title]
+| Field | Value |
+|-------|-------|
+| Priority | Should-Have |
+| Status | Todo |
+| Assigned | @[ROLE] |
+| Sprint | [Sprint #] |
+
+**Description:** [Brief description]
+
+**Acceptance Criteria:**
+- [ ] Criteria 1
+
+---
+
+## Could-Have Items
+
+### [ITEM-003] [Item Title]
+| Field | Value |
+|-------|-------|
+| Priority | Could-Have |
+| Status | Todo |
+| Assigned | Unassigned |
+| Sprint | Backlog |
+
+**Description:** [Brief description]
+
+---
+
+## Sprint Planning
+
+### Sprint 1: [Focus Area]
+| Item ID | Title | Assigned | Status |
+|---------|-------|----------|--------|
+| ITEM-001 | [Title] | @DEV | Todo |
+
+---
+
+### Next Step:
+- @DEV - Begin development of Sprint 1 items
+- @TESTER - Prepare test cases for Sprint 1
+
+#product-owner #backlog

package/.agent/templates/Project-Plan-Template.md

@@ -0,0 +1,79 @@
+# Project Plan - Version [X]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| Version | [X.0] |
+| Date | [YYYY-MM-DD] |
+| Author | @PM |
+| Status | Draft / Approved |
+
+---
+
+## Project Title
+[Project name]
+
+## Business Goals
+- [Goal 1]
+- [Goal 2]
+
+## Scope & Features
+
+### Must-Have
+- [ ] Feature 1: [Description]
+- [ ] Feature 2: [Description]
+
+### Should-Have
+- [ ] Feature 1: [Description]
+
+### Could-Have (if time permits)
+- [ ] Feature 1: [Description]
+
+## User Stories / Use Cases
+| ID | As a... | I want... | So that... | Priority |
+|----|---------|-----------|------------|----------|
+| US-01 | [User type] | [Feature] | [Benefit] | Must |
+| US-02 | [User type] | [Feature] | [Benefit] | Should |
+
+## Target Platforms & Tech Stack
+| Layer | Technology |
+|-------|------------|
+| Frontend | [e.g., SvelteKit, React] |
+| Backend | [e.g., Node.js, Python] |
+| Database | [e.g., PostgreSQL, Supabase] |
+| Deployment | [e.g., Vercel, AWS] |
+
+## High-Level Timeline
+| Phase | Duration | Target Date |
+|-------|----------|-------------|
+| Planning | Complete | [Date] |
+| Design | [X days] | [Date] |
+| Development | [X days] | [Date] |
+| Testing | [X days] | [Date] |
+| Deployment | [X days] | [Date] |
+
+## Risks & Assumptions
+| Type | Description | Mitigation |
+|------|-------------|------------|
+| Risk | [Risk description] | [Mitigation plan] |
+| Assumption | [Assumption] | - |
+
+## Task Assignments
+| Role | Responsibility |
+|------|----------------|
+| @SA | Backend architecture |
+| @UIUX | UI/UX design |
+| @DEV | Implementation |
+| @DEVOPS | CI/CD, deployment |
+| @TESTER | Testing |
+
+## Approval Status
+⏳ Awaiting user approval.
+
+---
+
+### Next Step After Approval:
+- @SA @UIUX @PO - Start design phase (in parallel)
+- @REPORTER - Begin progress tracking
+
+#planning

package/.agent/templates/Security-Review-Report-Template.md

@@ -0,0 +1,80 @@
+# Security Review Report - Version [X]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| Version | [X.0] |
+| Date | [YYYY-MM-DD] |
+| Author | @SECA |
+| Status | Pass / Fail / Conditional Pass |
+
+---
+
+## 1. Scope of Review
+| Area | Reviewed |
+|------|----------|
+| Authentication | ✅/❌ |
+| Authorization | ✅/❌ |
+| Data Validation | ✅/❌ |
+| API Security | ✅/❌ |
+| Data Storage | ✅/❌ |
+| Dependencies | ✅/❌ |
+
+## 2. Security Summary
+| Severity | Count | Status |
+|----------|-------|--------|
+| Critical | [X] | [X] Resolved |
+| High | [X] | [X] Resolved |
+| Medium | [X] | [X] Resolved |
+| Low | [X] | [X] Resolved |
+
+## 3. Findings
+
+### 3.1 Critical
+| ID | Finding | OWASP Ref | Status |
+|----|---------|-----------|--------|
+| SEC-001 | [Description] | [A01-A10] | Open/Resolved |
+
+### 3.2 High
+| ID | Finding | OWASP Ref | Status |
+|----|---------|-----------|--------|
+| SEC-002 | [Description] | [A01-A10] | Open/Resolved |
+
+### 3.3 Medium
+| ID | Finding | OWASP Ref | Status |
+|----|---------|-----------|--------|
+| SEC-003 | [Description] | [A01-A10] | Open/Resolved |
+
+### 3.4 Low
+| ID | Finding | OWASP Ref | Status |
+|----|---------|-----------|--------|
+| SEC-004 | [Description] | [A01-A10] | Open/Resolved |
+
+## 4. Security Checklist
+- [ ] Input validation on all endpoints
+- [ ] SQL injection prevention (parameterized queries)
+- [ ] XSS prevention (output encoding)
+- [ ] CSRF protection
+- [ ] Authentication tokens properly secured
+- [ ] Authorization checks on all protected resources
+- [ ] Sensitive data encrypted at rest
+- [ ] Sensitive data encrypted in transit (HTTPS)
+- [ ] No secrets in source code
+- [ ] Dependency vulnerabilities addressed
+
+## 5. Recommendations
+1. [Security recommendation 1]
+2. [Security recommendation 2]
+
+## 6. Verdict
+☐ **PASS** - No blocking security issues
+☐ **CONDITIONAL PASS** - Proceed with noted mitigations
+☐ **FAIL** - Critical/High issues must be resolved
+
+---
+
+### Next Step:
+- @SA @DEV - Address security findings (if any)
+- @DEV - Proceed with development (if approved)
+
+#security-review