template-instructions 1.0.0

package/instructions/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/instructions/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/instructions/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/instructions/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

package/instructions/templates/Test-Report-Template.md

@@ -0,0 +1,97 @@
+# Test Report - Version [X]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| Version | [X.0] |
+| Date | [YYYY-MM-DD] |
+| Author | @TESTER |
+| Environment | Staging / Production |
+| Build | [Build #/Version] |
+
+---
+
+## 1. Test Summary
+| Metric | Value |
+|--------|-------|
+| Total Test Cases | [X] |
+| Passed | [X] |
+| Failed | [X] |
+| Blocked | [X] |
+| Pass Rate | [X]% |
+
+## 2. Test Coverage
+| Feature | Test Cases | Passed | Failed |
+|---------|------------|--------|--------|
+| [Feature 1] | [X] | [X] | [X] |
+| [Feature 2] | [X] | [X] | [X] |
+
+## 3. Test Cases
+
+### TC-001: [Test Case Name]
+| Field | Value |
+|-------|-------|
+| Feature | [Feature name] |
+| Priority | High/Medium/Low |
+| Status | ✅ Pass / ❌ Fail / ⏸️ Blocked |
+
+**Steps:**
+1. [Step 1]
+2. [Step 2]
+
+**Expected Result:** [Expected behavior]
+**Actual Result:** [Actual behavior]
+**Evidence:** [Screenshot/Recording link]
+
+---
+
+### TC-002: [Test Case Name]
+| Field | Value |
+|-------|-------|
+| Feature | [Feature name] |
+| Priority | High/Medium/Low |
+| Status | ✅ Pass / ❌ Fail / ⏸️ Blocked |
+
+**Steps:**
+1. [Step 1]
+
+**Expected Result:** [Expected behavior]
+**Actual Result:** [Actual behavior]
+
+---
+
+## 4. Bugs Found
+| Bug ID | Title | Severity | Status | Assigned |
+|--------|-------|----------|--------|----------|
+| BUG-001 | [Title] | Critical/High/Med/Low | Open | @DEV |
+| BUG-002 | [Title] | Critical/High/Med/Low | Open | @DEV |
+
+### BUG-001: [Bug Title]
+| Field | Value |
+|-------|-------|
+| Severity | Critical / #fixbug-critical |
+| Steps to Reproduce | [Steps] |
+| Expected | [Expected behavior] |
+| Actual | [Actual behavior] |
+| Evidence | [Screenshot/Recording] |
+
+---
+
+## 5. Test Verdict
+☐ **PASS** - All critical tests passed, ready for production
+☐ **CONDITIONAL PASS** - Minor issues, can proceed with known limitations
+☐ **FAIL** - Critical/High bugs must be fixed before release
+
+## 6. Blockers
+| Blocker | Impact | Status |
+|---------|--------|--------|
+| [Blocker description] | [Impact] | Open/Resolved |
+
+---
+
+### Next Step:
+- @DEV - Fix bugs: [BUG-001, BUG-002]
+- @DEVOPS - Deploy to production (if approved)
+- @REPORTER - Include test results in phase report
+
+#testing

package/instructions/templates/definition-of-done.md

@@ -0,0 +1,151 @@
+# Definition of Done (DoD) Checklist
+**Version:** 1.0 | **Last Updated:** 2025-12-23
+
+---
+
+## Purpose
+This checklist ensures consistent quality standards across all deliverables. A task is **NOT DONE** until ALL applicable items are checked.
+
+---
+
+## 📋 Development Task DoD
+
+### Code Quality
+- [ ] Code implemented according to approved design specs
+- [ ] Follows project coding standards and conventions
+- [ ] No hardcoded values (use config/environment variables)
+- [ ] No console.log / debug code left in production code
+- [ ] Proper error handling implemented
+- [ ] Code is self-documenting with clear naming
+
+### Testing
+- [ ] Unit tests written and passing
+- [ ] Local testing passed (all features work as expected)
+- [ ] Edge cases handled and tested
+- [ ] No regressions introduced
+
+### Documentation
+- [ ] Code comments for complex logic
+- [ ] API documentation updated (if applicable)
+- [ ] Tagged with `#development`
+
+### Evidence
+- [ ] Screenshots/recordings captured (if UI changes)
+- [ ] Build logs showing success
+
+### Handoff
+- [ ] Development-Log artifact updated
+- [ ] @TESTER tagged for testing
+
+---
+
+## 🧪 Testing Task DoD
+
+### Test Execution
+- [ ] All test cases from Test Plan executed
+- [ ] Happy path scenarios verified
+- [ ] Error/edge case scenarios verified
+- [ ] Acceptance criteria from user stories validated
+
+### Bug Management
+- [ ] All bugs logged with proper priority tags
+- [ ] No `#fixbug-critical` or `#fixbug-high` bugs remaining open
+- [ ] Responsible @DEV tagged for each bug
+
+### Evidence
+- [ ] Screenshots/recordings for key flows
+- [ ] Screenshots/recordings for each bug found
+
+### Documentation
+- [ ] Test-Report artifact created/updated
+- [ ] Tagged with `#testing`
+
+### Handoff (if passed)
+- [ ] @REPORTER tagged
+- [ ] @STAKEHOLDER tagged (if ready for final review)
+
+---
+
+## 🚀 Deployment Task DoD
+
+### Pre-Deployment
+- [ ] All tests passing in CI/CD pipeline
+- [ ] Security checklist completed
+- [ ] Environment variables configured correctly
+- [ ] Database migrations ready (if applicable)
+
+### Staging
+- [ ] Deployed to staging environment successfully
+- [ ] Smoke tests passed on staging
+- [ ] Tagged with `#deployed-staging`
+
+### Production
+- [ ] Staging approved by @TESTER
+- [ ] Deployed to production environment
+- [ ] Health checks passing
+- [ ] Monitoring/alerting configured
+- [ ] Tagged with `#deployed-production`
+
+### Documentation
+- [ ] DevOps-Plan-and-Log artifact updated
+- [ ] Deployment steps documented
+
+### Rollback
+- [ ] Rollback plan documented and tested
+
+---
+
+## 📊 Design Task DoD
+
+### Design Quality
+- [ ] All Must-Have requirements addressed
+- [ ] Consistent with project plan scope
+- [ ] Diagrams/mockups are clear and complete
+- [ ] APIs designed for both UI needs and backend feasibility
+
+### Review Readiness
+- [ ] Design-Spec artifact created with proper naming
+- [ ] Tagged with `#designing` or `#uiux-design`
+
+### Handoff
+- [ ] @QA tagged for design verification
+- [ ] @SECA tagged for security review
+
+---
+
+## ✅ Project Completion DoD
+
+### Feature Delivery
+- [ ] All Must-Have features implemented and verified
+- [ ] All Should-Have features implemented (or justified deferral)
+- [ ] No `#fixbug-critical` or `#fixbug-high` bugs remaining
+
+### Approvals
+- [ ] Design approved by QA + SecA
+- [ ] Testing passed by TESTER
+- [ ] STAKEHOLDER final approval received
+
+### Documentation
+- [ ] Master-Documentation.md complete and current
+- [ ] Final-Project-Report.md created by REPORTER
+- [ ] All artifacts versioned and archived
+
+### Notification
+- [ ] User notified of project completion
+- [ ] Handover documentation provided (if applicable)
+
+---
+
+## Quick Reference Card
+
+| Task Type | Key Criteria | Tags |
+|-----------|--------------|------|
+| **Development** | Code works, tests pass, evidence captured | `#development` |
+| **Testing** | All cases run, no critical/high bugs | `#testing` |
+| **Deployment** | CI passes, staging verified, rollback ready | `#deployed-*` |
+| **Design** | Covers requirements, diagrams clear | `#designing` |
+| **Project** | All features done, stakeholder approved | `#reporting` |
+
+---
+
+#global-rules #definition-of-done

package/instructions/templates/incident-response.md

@@ -0,0 +1,111 @@
+# Incident Response Template
+**Version:** 1.0 | **Last Updated:** 2025-12-23
+
+---
+
+## 🚨 Incident Details
+
+| Field | Value |
+|-------|-------|
+| **Incident ID** | INC-[YYYY-MM-DD]-[###] |
+| **Severity** | `Critical` / `High` / `Medium` / `Low` |
+| **Status** | `Detected` / `Triaging` / `Fixing` / `Deploying` / `Resolved` / `Postmortem` |
+| **Detected By** | @[role] |
+| **Detected At** | [datetime] |
+| **Resolved At** | [datetime] |
+| **Duration** | [total downtime] |
+
+---
+
+## Incident Summary
+[Brief description of what happened]
+
+## Impact
+- **Affected Users:** [all / specific group / percentage]
+- **Affected Features:** [list features]
+- **Data Loss:** Yes / No
+- **Security Breach:** Yes / No
+
+---
+
+## Response Timeline
+
+| Time | Action | Owner | Status |
+|------|--------|-------|--------|
+| [time] | Incident detected | @TESTER / @DEVOPS | ✅ |
+| [time] | Triage started | @PM + @DEVOPS | ✅ |
+| [time] | Root cause identified | @DEV[#] | ✅ |
+| [time] | Hotfix implemented | @DEV[#] | ✅ |
+| [time] | Quick test passed | @TESTER | ✅ |
+| [time] | Hotfix deployed | @DEVOPS | ✅ |
+| [time] | Incident resolved | @PM | ✅ |
+
+---
+
+## Root Cause Analysis
+
+### What Happened
+[Detailed technical explanation]
+
+### Why It Happened
+[Root cause - code bug / config error / infrastructure / external dependency]
+
+### Contributing Factors
+- [ ] Missing tests
+- [ ] Inadequate monitoring
+- [ ] Configuration drift
+- [ ] External service failure
+- [ ] Human error
+- [ ] Other: [specify]
+
+---
+
+## Hotfix Details
+
+| Item | Details |
+|------|---------|
+| **Hotfix Branch** | `hotfix/INC-[id]` |
+| **Files Changed** | [list files] |
+| **Testing** | Smoke test only / Full regression |
+| **Rollback Plan** | [describe rollback steps] |
+
+### Hotfix Code Summary
+```
+[Brief description or diff summary of the fix]
+```
+
+---
+
+## Action Items (Preventive Measures)
+
+| # | Action | Owner | Priority | Due Date | Status |
+|---|--------|-------|----------|----------|--------|
+| 1 | [action] | @[role] | High | [date] | ⬜ |
+| 2 | [action] | @[role] | Medium | [date] | ⬜ |
+| 3 | [action] | @[role] | Low | [date] | ⬜ |
+
+---
+
+## Lessons Learned
+1. [lesson 1]
+2. [lesson 2]
+3. [lesson 3]
+
+---
+
+## Sign-Off
+
+| Role | Name | Date | Signature |
+|------|------|------|-----------|
+| PM | | | ☐ Approved |
+| DevOps | | | ☐ Approved |
+| REPORTER | | | ☐ Documented |
+
+---
+
+### Next Step:
+- @REPORTER - Include in Phase-Report
+- @PM - Schedule postmortem review if needed
+- @DEVOPS - Add monitoring for this scenario
+
+#hotfix #fixbug-critical #incident #reporting