agentic-sdlc 1.0.0

package/.agent/templates/System-Design-Spec-Template.md

@@ -0,0 +1,170 @@
+# System Design Specification - Version [X]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| Version | [X.0] |
+| Date | [YYYY-MM-DD] |
+| Author | @SA |
+| Project Type | Web / Mobile / Desktop / Embedded / CLI / API / Library |
+| Status | Draft / Review / Approved |
+
+---
+
+## 1. Architecture Overview
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   Client    │────▶│   System    │────▶│  Storage    │
+│             │     │   Layer     │     │             │
+└─────────────┘     └─────────────┘     └─────────────┘
+```
+
+## 2. Technology Stack
+| Layer | Technology | Justification |
+|-------|------------|---------------|
+| Platform | [e.g., Web/iOS/Android/Windows/Linux] | [Reason] |
+| Runtime | [e.g., Node.js 20/Python 3.11/JVM] | [Reason] |
+| Framework | [e.g., SvelteKit/React Native/Electron] | [Reason] |
+| Storage | [e.g., PostgreSQL/SQLite/File System] | [Reason] |
+| Auth | [e.g., Supabase Auth/OAuth/JWT] | [Reason] |
+
+## 3. Interface Design
+
+### 3.1 API Endpoints (for Web/Mobile Backend)
+| Method | Endpoint | Description | Auth |
+|--------|----------|-------------|------|
+| GET | /api/[resource] | List all | Required |
+| POST | /api/[resource] | Create new | Required |
+
+**Request/Response Example:**
+```json
+// POST /api/[resource]
+// Request
+{ "field": "value" }
+
+// Response 201
+{ "id": "uuid", "field": "value", "createdAt": "ISO8601" }
+```
+
+### 3.2 Public API (for Libraries/SDKs)
+```typescript
+// Main interface
+interface [LibraryName] {
+  method1(param: Type): ReturnType;
+  method2(options: Options): Promise<Result>;
+}
+```
+
+### 3.3 CLI Commands (for CLI Tools)
+```bash
+# Command structure
+tool-name <command> [options]
+
+# Examples
+tool-name init --template=basic
+tool-name build --output=dist
+```
+
+### 3.4 Communication Protocol (for Embedded/IoT)
+```
+Message Format: [Header][Payload][Checksum]
+- Header: 4 bytes (command ID + length)
+- Payload: Variable length
+- Checksum: 2 bytes CRC16
+```
+
+## 4. Data Model
+
+### 4.1 Database Schema (for Web/Mobile with DB)
+| Table | Columns | Constraints |
+|-------|---------|-------------|
+| [table_name] | id, field1, field2 | PK, FK, etc. |
+
+### 4.2 Data Structures (for Desktop/CLI/Library)
+```typescript
+interface DataModel {
+  id: string;
+  field: Type;
+}
+```
+
+### 4.3 File Format (for Desktop/CLI tools)
+```json
+{
+  "version": "1.0",
+  "data": {}
+}
+```
+
+### 4.4 Relationships
+```
+[Entity A] 1──────N [Entity B]
+              └── foreign_key: entity_a_id
+```
+
+## 5. Authentication & Authorization
+| Role | Permissions | Platform Notes |
+|------|-------------|----------------|
+| Guest | Read public | N/A for CLI tools |
+| User | Read/Write own | Session/Token based |
+| Admin | Full access | Elevated privileges |
+
+## 6. Error Handling
+| Code/Type | Meaning | Response |
+|-----------|---------|----------|
+| 400 / InvalidInput | Bad Request | { "error": "message" } |
+| 401 / Unauthorized | Not authenticated | { "error": "Not authenticated" } |
+| 403 / Forbidden | Access denied | { "error": "Access denied" } |
+| 404 / NotFound | Resource not found | { "error": "Resource not found" } |
+| 500 / InternalError | Server Error | { "error": "Internal error" } |
+
+## 7. Platform-Specific Considerations
+
+### For Mobile Apps:
+- Offline support strategy: [describe]
+- Background sync: [describe]
+- Push notifications: [describe]
+- Battery optimization: [describe]
+
+### For Desktop Apps:
+- Auto-update mechanism: [describe]
+- Multi-window support: [describe]
+- System tray integration: [describe]
+
+### For Embedded Systems:
+- Memory constraints: [X KB RAM, Y KB Flash]
+- Power management: [describe]
+- Firmware update: [OTA/USB/etc.]
+
+### For CLI Tools:
+- Configuration file location: [~/.config/tool/]
+- Output formats: [JSON/YAML/Table]
+- Piping support: [Yes/No]
+
+### For Libraries:
+- Dependency management: [peer/bundled]
+- Tree-shaking support: [Yes/No]
+- TypeScript definitions: [Included/Separate]
+
+## 8. Performance & Scalability
+| Metric | Target | Strategy |
+|--------|--------|----------|
+| Response Time | < 200ms | Caching, indexing |
+| Throughput | [X req/s] | Load balancing |
+| Memory Usage | < [X MB] | Optimization |
+| Battery Impact | Minimal | Background throttling |
+
+## 9. Open Questions
+- [ ] @UIUX: [Question about UI requirements]
+- [ ] @PO: [Question about business logic]
+- [ ] @DEVOPS: [Question about deployment]
+
+---
+
+### Next Step:
+- @QA - Review design for testability
+- @SECA - Security review of architecture and interfaces
+- @DEV - Prepare for implementation
+
+#designing

package/.agent/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/.agent/templates/UIUX-Design-Spec-Template.md

@@ -0,0 +1,280 @@
+# UI/UX Design Specification - Version [X]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| Version | [X.0] |
+| Date | [YYYY-MM-DD] |
+| Author | @UIUX |
+| Platform | Web / Mobile (iOS/Android) / Desktop / Embedded / CLI |
+| Status | Draft / Review / Approved |
+
+---
+
+## 1. Design Overview
+**Target Users:** [Primary user personas]
+**Platform:** [Web/Mobile/Desktop/Embedded/CLI]
+**Design Goals:** [Key objectives]
+
+---
+
+## 2. User Personas
+
+### Persona 1: [Name]
+| Attribute | Details |
+|-----------|---------|
+| Role | [e.g., End User, Admin, Developer] |
+| Age Range | [e.g., 25-40] |
+| Goals | [What they want to achieve] |
+| Pain Points | [Current frustrations] |
+| Tech Savviness | Low / Medium / High |
+| Platform Usage | [Desktop/Mobile/Both] |
+
+---
+
+## 3. User Flows
+
+### Flow 1: [Primary User Journey]
+```
+┌──────────┐    ┌───────────────┐    ┌─────────────┐
+│  Entry   │───▶│   Action      │───▶│   Result    │
+│  Point   │    │               │    │             │
+└──────────┘    └───────┬───────┘    └─────────────┘
+                        │
+                        ▼ (Error)
+                ┌───────────────┐
+                │ Error Handling│
+                └───────────────┘
+```
+
+### Flow 2: [Secondary Journey]
+[Add flow diagrams for key user journeys]
+
+---
+
+## 4. Screen/Interface Specifications
+
+### 4.1 [Screen/View Name]
+
+**Layout (for GUI platforms):**
+```
+┌────────────────────────────────────────┐
+│              [Header/Nav]              │
+├────────────────────────────────────────┤
+│  ┌──────────────────────────────────┐  │
+│  │          Main Content            │  │
+│  │  ┌────────────────────────────┐  │  │
+│  │  │ Component 1                │  │  │
+│  │  └────────────────────────────┘  │  │
+│  │  ┌────────────────────────────┐  │  │
+│  │  │ Component 2                │  │  │
+│  │  └────────────────────────────┘  │  │
+│  └──────────────────────────────────┘  │
+└────────────────────────────────────────┘
+```
+
+**Command Structure (for CLI):**
+```bash
+# Command syntax
+tool-name <command> [options]
+
+# Interactive prompts
+? Select option: (Use arrow keys)
+  ❯ Option 1
+    Option 2
+    Option 3
+
+# Output format
+✓ Success message
+✗ Error message
+```
+
+**Specifications:**
+| Element | Specification |
+|---------|---------------|
+| Container | [Size, padding, margins] |
+| Typography | [Font, size, weight] |
+| Colors | [Primary, secondary, etc.] |
+| Spacing | [Grid system] |
+| Interactive Elements | [Buttons, inputs, etc.] |
+
+**States:**
+- Default: [Description]
+- Hover/Focus: [Description]
+- Active: [Description]
+- Disabled: [Description]
+- Loading: [Description]
+- Error: [Description]
+
+**Platform-Specific Notes:**
+- **Mobile:** Touch targets ≥ 44x44px, swipe gestures
+- **Desktop:** Keyboard shortcuts, window management
+- **CLI:** Color support, progress indicators
+- **Embedded:** Display constraints, button mapping
+
+---
+
+## 5. Design System
+
+### 5.1 Color Palette
+
+| Token | Hex/RGB | Usage | Accessibility |
+|-------|---------|-------|---------------|
+| `--color-primary` | #0066FF | CTAs, links | WCAG AA ✓ |
+| `--color-secondary` | #6B7280 | Secondary text | WCAG AA ✓ |
+| `--color-success` | #10B981 | Success states | WCAG AA ✓ |
+| `--color-warning` | #F59E0B | Warnings | WCAG AA ✓ |
+| `--color-error` | #EF4444 | Errors | WCAG AA ✓ |
+| `--color-bg` | #F9FAFB | Background | - |
+| `--color-text` | #111827 | Primary text | WCAG AAA ✓ |
+
+### 5.2 Typography
+
+| Token | Font | Size | Weight | Line Height | Usage |
+|-------|------|------|--------|-------------|-------|
+| `--font-h1` | [Font] | 32px | 700 | 1.2 | Page titles |
+| `--font-h2` | [Font] | 24px | 600 | 1.3 | Section headers |
+| `--font-body` | [Font] | 16px | 400 | 1.5 | Body text |
+| `--font-small` | [Font] | 14px | 400 | 1.4 | Captions |
+| `--font-mono` | [Mono] | 14px | 400 | 1.5 | Code, CLI output |
+
+### 5.3 Spacing System
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| `--space-xs` | 4px | Tight spacing |
+| `--space-sm` | 8px | Component padding |
+| `--space-md` | 16px | Card padding |
+| `--space-lg` | 24px | Section gaps |
+| `--space-xl` | 32px | Page margins |
+
+### 5.4 Component Library
+
+| Component | Variants | States | Platform Notes |
+|-----------|----------|--------|----------------|
+| Button | Primary, Secondary, Ghost | Default, Hover, Active, Disabled | Touch-friendly on mobile |
+| Input | Text, Password, Number | Default, Focus, Error, Disabled | Auto-complete support |
+| Card | Default, Elevated, Outlined | Default, Hover | Swipeable on mobile |
+| Modal | Small, Medium, Large | Open, Closing | Full-screen on mobile |
+| Progress | Linear, Circular, Spinner | Indeterminate, Determinate | CLI: ASCII progress bar |
+
+---
+
+## 6. Responsive/Adaptive Design
+
+### 6.1 Breakpoints (for Web/Desktop)
+| Breakpoint | Width | Layout Changes |
+|------------|-------|----------------|
+| Mobile | < 768px | Single column, bottom nav |
+| Tablet | 768-1024px | 2 columns, side nav |
+| Desktop | > 1024px | 3 columns, full nav |
+
+### 6.2 Platform Adaptations
+- **iOS:** Native navigation patterns, SF Symbols
+- **Android:** Material Design 3, FAB patterns
+- **Desktop:** Menu bar, keyboard shortcuts
+- **CLI:** Terminal width detection, color support check
+
+---
+
+## 7. Interactions & Animations
+
+| Interaction | Animation | Duration | Platform |
+|-------------|-----------|----------|----------|
+| Button press | Scale 0.98 | 100ms | GUI |
+| Modal open | Fade + slide | 200ms | GUI |
+| Page transition | Fade | 300ms | GUI |
+| Loading | Spinner/Progress | Continuous | All |
+| CLI command | Typing effect | 50ms/char | CLI |
+
+**Animation Principles:**
+- Respect user motion preferences (prefers-reduced-motion)
+- No animations on low-power devices (when applicable)
+- Smooth 60fps animations
+
+---
+
+## 8. Accessibility Checklist
+
+### Visual Accessibility
+- [ ] Color contrast ≥ 4.5:1 (WCAG AA)
+- [ ] Text resizable up to 200%
+- [ ] No information conveyed by color alone
+- [ ] Focus indicators visible on all interactive elements
+
+### Keyboard & Navigation
+- [ ] All functionality accessible via keyboard
+- [ ] Logical tab order
+- [ ] Skip navigation links (web)
+- [ ] Keyboard shortcuts documented
+
+### Screen Reader Support
+- [ ] All images have alt text
+- [ ] Form labels properly associated
+- [ ] ARIA labels where needed
+- [ ] Semantic HTML structure
+
+### Platform-Specific
+- [ ] **Mobile:** VoiceOver/TalkBack tested
+- [ ] **Desktop:** Screen reader compatible
+- [ ] **CLI:** Screen reader friendly output
+
+---
+
+## 9. Platform Guidelines Compliance
+
+### iOS (if applicable)
+- [ ] Human Interface Guidelines followed
+- [ ] SF Symbols used appropriately
+- [ ] Native navigation patterns
+- [ ] Dark mode support
+
+### Android (if applicable)
+- [ ] Material Design 3 guidelines
+- [ ] Adaptive icons
+- [ ] System navigation support
+- [ ] Dynamic color support
+
+### Web (if applicable)
+- [ ] Progressive enhancement
+- [ ] Cross-browser compatibility
+- [ ] Responsive design
+- [ ] PWA capabilities (if needed)
+
+---
+
+## 10. Assets & Resources
+
+### Required Assets
+| Asset | Format | Size | Notes |
+|-------|--------|------|-------|
+| App Icon | PNG/SVG | [sizes] | Multiple resolutions |
+| Logo | SVG | Scalable | Light/dark variants |
+| Illustrations | SVG/PNG | Various | Optimized |
+| Icons | SVG | 24x24 | Icon set |
+
+### Design Files
+- Figma/Sketch file: [Link]
+- Component library: [Link]
+- Style guide: [Link]
+
+---
+
+## 11. Open Questions
+- [ ] @SA: [Technical feasibility question]
+- [ ] @PO: [Business requirement clarification]
+- [ ] @DEV: [Implementation complexity question]
+
+---
+
+## 12. Conclusion & Next Step
+
+Design complete and ready for review.
+
+### Next Step:
+- @SA - Confirm system design supports UI requirements
+- @QA - Review for usability and testability
+- @SECA - Security review of user flows and data handling
+- @PO - Validate against acceptance criteria
+
+#uiux-design #designing

package/.agent/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