feat(project): add initial scaffold, CI, and README

This commit is contained in:
nexusct (Blackbox Agent)
2026-03-03 02:10:16 +00:00
parent 767e3ccfd5
commit a76c0c1dab
16 changed files with 4775 additions and 0 deletions

View File

@@ -0,0 +1,178 @@
# 🔍 Phase 0 Playbook — Intelligence & Discovery
> **Duration**: 3-7 days | **Agents**: 6 | **Gate Keeper**: Executive Summary Generator
---
## Objective
Validate the opportunity before committing resources. No building until the problem, market, and regulatory landscape are understood.
## Pre-Conditions
- [ ] Project brief or initial concept exists
- [ ] Stakeholder sponsor identified
- [ ] Budget for discovery phase approved
## Agent Activation Sequence
### Wave 1: Parallel Launch (Day 1)
#### 🔍 Trend Researcher — Market Intelligence Lead
```
Activate Trend Researcher for market intelligence on [PROJECT DOMAIN].
Deliverables required:
1. Competitive landscape analysis (direct + indirect competitors)
2. Market sizing: TAM, SAM, SOM with methodology
3. Trend lifecycle mapping: where is this market in the adoption curve?
4. 3-6 month trend forecast with confidence intervals
5. Investment and funding trends in the space
Sources: Minimum 15 unique, verified sources
Format: Strategic Report with executive summary
Timeline: 3 days
```
#### 💬 Feedback Synthesizer — User Needs Analysis
```
Activate Feedback Synthesizer for user needs analysis on [PROJECT DOMAIN].
Deliverables required:
1. Multi-channel feedback collection plan (surveys, interviews, reviews, social)
2. Sentiment analysis across existing user touchpoints
3. Pain point identification and prioritization (RICE scored)
4. Feature request analysis with business value estimation
5. Churn risk indicators from feedback patterns
Format: Synthesized Feedback Report with priority matrix
Timeline: 3 days
```
#### 🔍 UX Researcher — User Behavior Analysis
```
Activate UX Researcher for user behavior analysis on [PROJECT DOMAIN].
Deliverables required:
1. User interview plan (5-10 target users)
2. Persona development (3-5 primary personas)
3. Journey mapping for primary user flows
4. Usability heuristic evaluation of competitor products
5. Behavioral insights with statistical validation
Format: Research Findings Report with personas and journey maps
Timeline: 5 days
```
### Wave 2: Parallel Launch (Day 1, independent of Wave 1)
#### 📊 Analytics Reporter — Data Landscape Assessment
```
Activate Analytics Reporter for data landscape assessment on [PROJECT DOMAIN].
Deliverables required:
1. Existing data source audit (what data is available?)
2. Signal identification (what can we measure?)
3. Baseline metrics establishment
4. Data quality assessment with completeness scoring
5. Analytics infrastructure recommendations
Format: Data Audit Report with signal map
Timeline: 2 days
```
#### ⚖️ Legal Compliance Checker — Regulatory Scan
```
Activate Legal Compliance Checker for regulatory scan on [PROJECT DOMAIN].
Deliverables required:
1. Applicable regulatory frameworks (GDPR, CCPA, HIPAA, etc.)
2. Data handling requirements and constraints
3. Jurisdiction mapping for target markets
4. Compliance risk assessment with severity ratings
5. Blocking vs. manageable compliance issues
Format: Compliance Requirements Matrix
Timeline: 3 days
```
#### 🛠️ Tool Evaluator — Technology Landscape
```
Activate Tool Evaluator for technology landscape assessment on [PROJECT DOMAIN].
Deliverables required:
1. Technology stack assessment for the problem domain
2. Build vs. buy analysis for key components
3. Integration feasibility with existing systems
4. Open source vs. commercial evaluation
5. Technology risk assessment
Format: Tech Stack Assessment with recommendation matrix
Timeline: 2 days
```
## Convergence Point (Day 5-7)
All six agents deliver their reports. The Executive Summary Generator synthesizes:
```
Activate Executive Summary Generator to synthesize Phase 0 findings.
Input documents:
1. Trend Researcher → Market Analysis Report
2. Feedback Synthesizer → Synthesized Feedback Report
3. UX Researcher → Research Findings Report
4. Analytics Reporter → Data Audit Report
5. Legal Compliance Checker → Compliance Requirements Matrix
6. Tool Evaluator → Tech Stack Assessment
Output: Executive Summary (≤500 words, SCQA format)
Decision required: GO / NO-GO / PIVOT
Include: Quantified market opportunity, validated user needs, regulatory path, technology feasibility
```
## Quality Gate Checklist
| # | Criterion | Evidence Source | Status |
|---|-----------|----------------|--------|
| 1 | Market opportunity validated with TAM > minimum viable threshold | Trend Researcher report | ☐ |
| 2 | ≥3 validated user pain points with supporting data | Feedback Synthesizer + UX Researcher | ☐ |
| 3 | No blocking compliance issues identified | Legal Compliance Checker matrix | ☐ |
| 4 | Key metrics and data sources identified | Analytics Reporter audit | ☐ |
| 5 | Technology stack feasible and assessed | Tool Evaluator assessment | ☐ |
| 6 | Executive summary delivered with GO/NO-GO recommendation | Executive Summary Generator | ☐ |
## Gate Decision
- **GO**: Proceed to Phase 1 — Strategy & Architecture
- **NO-GO**: Archive findings, document learnings, redirect resources
- **PIVOT**: Modify scope/direction based on findings, re-run targeted discovery
## Handoff to Phase 1
```markdown
## Phase 0 → Phase 1 Handoff Package
### Documents to carry forward:
1. Market Analysis Report (Trend Researcher)
2. Synthesized Feedback Report (Feedback Synthesizer)
3. User Personas and Journey Maps (UX Researcher)
4. Data Audit Report (Analytics Reporter)
5. Compliance Requirements Matrix (Legal Compliance Checker)
6. Tech Stack Assessment (Tool Evaluator)
7. Executive Summary with GO decision (Executive Summary Generator)
### Key constraints identified:
- [Regulatory constraints from Legal Compliance Checker]
- [Technical constraints from Tool Evaluator]
- [Market timing constraints from Trend Researcher]
### Priority user needs (for Sprint Prioritizer):
1. [Pain point 1 — from Feedback Synthesizer]
2. [Pain point 2 — from UX Researcher]
3. [Pain point 3 — from Feedback Synthesizer]
```
---
*Phase 0 is complete when the Executive Summary Generator delivers a GO decision with supporting evidence from all six discovery agents.*

View File

@@ -0,0 +1,238 @@
# 🏗️ Phase 1 Playbook — Strategy & Architecture
> **Duration**: 5-10 days | **Agents**: 8 | **Gate Keepers**: Studio Producer + Reality Checker
---
## Objective
Define what we're building, how it's structured, and what success looks like — before writing a single line of code. Every architectural decision is documented. Every feature is prioritized. Every dollar is accounted for.
## Pre-Conditions
- [ ] Phase 0 Quality Gate passed (GO decision)
- [ ] Phase 0 Handoff Package received
- [ ] Stakeholder alignment on project scope
## Agent Activation Sequence
### Step 1: Strategic Framing (Day 1-3, Parallel)
#### 🎬 Studio Producer — Strategic Portfolio Alignment
```
Activate Studio Producer for strategic portfolio alignment on [PROJECT].
Input: Phase 0 Executive Summary + Market Analysis Report
Deliverables required:
1. Strategic Portfolio Plan with project positioning
2. Vision, objectives, and ROI targets
3. Resource allocation strategy
4. Risk/reward assessment
5. Success criteria and milestone definitions
Align with: Organizational strategic objectives
Format: Strategic Portfolio Plan Template
Timeline: 3 days
```
#### 🎭 Brand Guardian — Brand Identity System
```
Activate Brand Guardian for brand identity development on [PROJECT].
Input: Phase 0 UX Research (personas, journey maps)
Deliverables required:
1. Brand Foundation (purpose, vision, mission, values, personality)
2. Visual Identity System (colors, typography, spacing as CSS variables)
3. Brand Voice and Messaging Architecture
4. Logo system specifications (if new brand)
5. Brand usage guidelines
Format: Brand Identity System Document
Timeline: 3 days
```
#### 💰 Finance Tracker — Budget and Resource Planning
```
Activate Finance Tracker for financial planning on [PROJECT].
Input: Studio Producer strategic plan + Phase 0 Tech Stack Assessment
Deliverables required:
1. Comprehensive project budget with category breakdown
2. Resource cost projections (agents, infrastructure, tools)
3. ROI model with break-even analysis
4. Cash flow timeline
5. Financial risk assessment with contingency reserves
Format: Financial Plan with ROI Projections
Timeline: 2 days
```
### Step 2: Technical Architecture (Day 3-7, Parallel, after Step 1 outputs available)
#### 🏛️ UX Architect — Technical Architecture + UX Foundation
```
Activate UX Architect for technical architecture on [PROJECT].
Input: Brand Guardian visual identity + Phase 0 UX Research
Deliverables required:
1. CSS Design System (variables, tokens, scales)
2. Layout Framework (Grid/Flexbox patterns, responsive breakpoints)
3. Component Architecture (naming conventions, hierarchy)
4. Information Architecture (page flow, content hierarchy)
5. Theme System (light/dark/system toggle)
6. Accessibility Foundation (WCAG 2.1 AA baseline)
Files to create:
- css/design-system.css
- css/layout.css
- css/components.css
- docs/ux-architecture.md
Format: Developer-Ready Foundation Package
Timeline: 4 days
```
#### 🏗️ Backend Architect — System Architecture
```
Activate Backend Architect for system architecture on [PROJECT].
Input: Phase 0 Tech Stack Assessment + Compliance Requirements
Deliverables required:
1. System Architecture Specification
- Architecture pattern (microservices/monolith/serverless/hybrid)
- Communication pattern (REST/GraphQL/gRPC/event-driven)
- Data pattern (CQRS/Event Sourcing/CRUD)
2. Database Schema Design with indexing strategy
3. API Design Specification with versioning
4. Authentication and Authorization Architecture
5. Security Architecture (defense in depth)
6. Scalability Plan (horizontal scaling strategy)
Format: System Architecture Specification
Timeline: 4 days
```
#### 🤖 AI Engineer — ML Architecture (if applicable)
```
Activate AI Engineer for ML system architecture on [PROJECT].
Input: Backend Architect system architecture + Phase 0 Data Audit
Deliverables required:
1. ML System Design
- Model selection and training strategy
- Data pipeline architecture
- Inference strategy (real-time/batch/edge)
2. AI Ethics and Safety Framework
3. Model monitoring and retraining plan
4. Integration points with main application
5. Cost projections for ML infrastructure
Condition: Only activate if project includes AI/ML features
Format: ML System Design Document
Timeline: 3 days
```
#### 👔 Senior Project Manager — Spec-to-Task Conversion
```
Activate Senior Project Manager for task list creation on [PROJECT].
Input: ALL Phase 0 documents + Architecture specs (as available)
Deliverables required:
1. Comprehensive Task List
- Quote EXACT requirements from spec (no luxury features)
- Each task has clear acceptance criteria
- Dependencies mapped between tasks
- Effort estimates (story points or hours)
2. Work Breakdown Structure
3. Critical path identification
4. Risk register for implementation
Rules:
- Do NOT add features not in the specification
- Quote exact text from requirements
- Be realistic about effort estimates
Format: Task List with acceptance criteria
Timeline: 3 days
```
### Step 3: Prioritization (Day 7-10, Sequential, after Step 2)
#### 🎯 Sprint Prioritizer — Feature Prioritization
```
Activate Sprint Prioritizer for backlog prioritization on [PROJECT].
Input:
- Senior Project Manager → Task List
- Backend Architect → System Architecture
- UX Architect → UX Architecture
- Finance Tracker → Budget Framework
- Studio Producer → Strategic Plan
Deliverables required:
1. RICE-scored backlog (Reach, Impact, Confidence, Effort)
2. Sprint assignments with velocity-based estimation
3. Dependency map with critical path
4. MoSCoW classification (Must/Should/Could/Won't)
5. Release plan with milestone mapping
Validation: Studio Producer confirms strategic alignment
Format: Prioritized Sprint Plan
Timeline: 2 days
```
## Quality Gate Checklist
| # | Criterion | Evidence Source | Status |
|---|-----------|----------------|--------|
| 1 | Architecture covers 100% of spec requirements | Senior PM task list cross-referenced with architecture | ☐ |
| 2 | Brand system complete (logo, colors, typography, voice) | Brand Guardian deliverable | ☐ |
| 3 | All technical components have implementation path | Backend Architect + UX Architect specs | ☐ |
| 4 | Budget approved and within constraints | Finance Tracker plan | ☐ |
| 5 | Sprint plan is velocity-based and realistic | Sprint Prioritizer backlog | ☐ |
| 6 | Security architecture defined | Backend Architect security spec | ☐ |
| 7 | Compliance requirements integrated into architecture | Legal requirements mapped to technical decisions | ☐ |
## Gate Decision
**Dual sign-off required**: Studio Producer (strategic) + Reality Checker (technical)
- **APPROVED**: Proceed to Phase 2 with full Architecture Package
- **REVISE**: Specific items need rework (return to relevant Step)
- **RESTRUCTURE**: Fundamental architecture issues (restart Phase 1)
## Handoff to Phase 2
```markdown
## Phase 1 → Phase 2 Handoff Package
### Architecture Package:
1. Strategic Portfolio Plan (Studio Producer)
2. Brand Identity System (Brand Guardian)
3. Financial Plan (Finance Tracker)
4. CSS Design System + UX Architecture (UX Architect)
5. System Architecture Specification (Backend Architect)
6. ML System Design (AI Engineer — if applicable)
7. Comprehensive Task List (Senior Project Manager)
8. Prioritized Sprint Plan (Sprint Prioritizer)
### For DevOps Automator:
- Deployment architecture from Backend Architect
- Environment requirements from System Architecture
- Monitoring requirements from Infrastructure needs
### For Frontend Developer:
- CSS Design System from UX Architect
- Brand Identity from Brand Guardian
- Component architecture from UX Architect
- API specification from Backend Architect
### For Backend Architect (continuing):
- Database schema ready for deployment
- API scaffold ready for implementation
- Auth system architecture defined
```
---
*Phase 1 is complete when Studio Producer and Reality Checker both sign off on the Architecture Package.*

View File

@@ -0,0 +1,278 @@
# ⚙️ Phase 2 Playbook — Foundation & Scaffolding
> **Duration**: 3-5 days | **Agents**: 6 | **Gate Keepers**: DevOps Automator + Evidence Collector
---
## Objective
Build the technical and operational foundation that all subsequent work depends on. Get the skeleton standing before adding muscle. After this phase, every developer has a working environment, a deployable pipeline, and a design system to build with.
## Pre-Conditions
- [ ] Phase 1 Quality Gate passed (Architecture Package approved)
- [ ] Phase 1 Handoff Package received
- [ ] All architecture documents finalized
## Agent Activation Sequence
### Workstream A: Infrastructure (Day 1-3, Parallel)
#### 🚀 DevOps Automator — CI/CD Pipeline + Infrastructure
```
Activate DevOps Automator for infrastructure setup on [PROJECT].
Input: Backend Architect system architecture + deployment requirements
Deliverables required:
1. CI/CD Pipeline (GitHub Actions / GitLab CI)
- Security scanning stage
- Automated testing stage
- Build and containerization stage
- Deployment stage (blue-green or canary)
- Automated rollback capability
2. Infrastructure as Code
- Environment provisioning (dev, staging, production)
- Container orchestration setup
- Network and security configuration
3. Environment Configuration
- Secrets management
- Environment variable management
- Multi-environment parity
Files to create:
- .github/workflows/ci-cd.yml (or equivalent)
- infrastructure/ (Terraform/CDK templates)
- docker-compose.yml
- Dockerfile(s)
Format: Working CI/CD pipeline with IaC templates
Timeline: 3 days
```
#### 🏗️ Infrastructure Maintainer — Cloud Infrastructure + Monitoring
```
Activate Infrastructure Maintainer for monitoring setup on [PROJECT].
Input: DevOps Automator infrastructure + Backend Architect architecture
Deliverables required:
1. Cloud Resource Provisioning
- Compute, storage, networking resources
- Auto-scaling configuration
- Load balancer setup
2. Monitoring Stack
- Application metrics (Prometheus/DataDog)
- Infrastructure metrics
- Custom dashboards (Grafana)
3. Logging and Alerting
- Centralized log aggregation
- Alert rules for critical thresholds
- On-call notification setup
4. Security Hardening
- Firewall rules
- SSL/TLS configuration
- Access control policies
Format: Infrastructure Readiness Report with dashboard access
Timeline: 3 days
```
#### ⚙️ Studio Operations — Process Setup
```
Activate Studio Operations for process setup on [PROJECT].
Input: Sprint Prioritizer plan + Project Shepherd coordination needs
Deliverables required:
1. Git Workflow
- Branch strategy (GitFlow / trunk-based)
- PR review process
- Merge policies
2. Communication Channels
- Team channels setup
- Notification routing
- Status update cadence
3. Documentation Templates
- PR template
- Issue template
- Decision log template
4. Collaboration Tools
- Project board setup
- Sprint tracking configuration
Format: Operations Playbook
Timeline: 2 days
```
### Workstream B: Application Foundation (Day 1-4, Parallel)
#### 🎨 Frontend Developer — Project Scaffolding + Component Library
```
Activate Frontend Developer for project scaffolding on [PROJECT].
Input: UX Architect CSS Design System + Brand Guardian identity
Deliverables required:
1. Project Scaffolding
- Framework setup (React/Vue/Angular per architecture)
- TypeScript configuration
- Build tooling (Vite/Webpack/Next.js)
- Testing framework (Jest/Vitest + Testing Library)
2. Design System Implementation
- CSS design tokens from UX Architect
- Base component library (Button, Input, Card, Layout)
- Theme system (light/dark/system toggle)
- Responsive utilities
3. Application Shell
- Routing setup
- Layout components (Header, Footer, Sidebar)
- Error boundary implementation
- Loading states
Files to create:
- src/ (application source)
- src/components/ (component library)
- src/styles/ (design tokens)
- src/layouts/ (layout components)
Format: Working application skeleton with component library
Timeline: 3 days
```
#### 🏗️ Backend Architect — Database + API Foundation
```
Activate Backend Architect for API foundation on [PROJECT].
Input: System Architecture Specification + Database Schema Design
Deliverables required:
1. Database Setup
- Schema deployment (migrations)
- Index creation
- Seed data for development
- Connection pooling configuration
2. API Scaffold
- Framework setup (Express/FastAPI/etc.)
- Route structure matching architecture
- Middleware stack (auth, validation, error handling, CORS)
- Health check endpoints
3. Authentication System
- Auth provider integration
- JWT/session management
- Role-based access control scaffold
4. Service Communication
- API versioning setup
- Request/response serialization
- Error response standardization
Files to create:
- api/ or server/ (backend source)
- migrations/ (database migrations)
- docs/api-spec.yaml (OpenAPI specification)
Format: Working API scaffold with database and auth
Timeline: 4 days
```
#### 🏛️ UX Architect — CSS System Implementation
```
Activate UX Architect for CSS system implementation on [PROJECT].
Input: Brand Guardian identity + own Phase 1 CSS Design System spec
Deliverables required:
1. Design Tokens Implementation
- CSS custom properties (colors, typography, spacing)
- Brand color palette with semantic naming
- Typography scale with responsive adjustments
2. Layout System
- Container system (responsive breakpoints)
- Grid patterns (2-col, 3-col, sidebar)
- Flexbox utilities
3. Theme System
- Light theme variables
- Dark theme variables
- System preference detection
- Theme toggle component
- Smooth transition between themes
Files to create/update:
- css/design-system.css (or equivalent in framework)
- css/layout.css
- css/components.css
- js/theme-manager.js
Format: Implemented CSS design system with theme toggle
Timeline: 2 days
```
## Verification Checkpoint (Day 4-5)
### Evidence Collector Verification
```
Activate Evidence Collector for Phase 2 foundation verification.
Verify the following with screenshot evidence:
1. CI/CD pipeline executes successfully (show pipeline logs)
2. Application skeleton loads in browser (desktop screenshot)
3. Application skeleton loads on mobile (mobile screenshot)
4. Theme toggle works (light + dark screenshots)
5. API health check responds (curl output)
6. Database is accessible (migration status)
7. Monitoring dashboards are active (dashboard screenshot)
8. Component library renders (component demo page)
Format: Evidence Package with screenshots
Verdict: PASS / FAIL with specific issues
```
## Quality Gate Checklist
| # | Criterion | Evidence Source | Status |
|---|-----------|----------------|--------|
| 1 | CI/CD pipeline builds, tests, and deploys | Pipeline execution logs | ☐ |
| 2 | Database schema deployed with all tables/indexes | Migration success output | ☐ |
| 3 | API scaffold responding on health check | curl response evidence | ☐ |
| 4 | Frontend skeleton renders in browser | Evidence Collector screenshots | ☐ |
| 5 | Monitoring dashboards showing metrics | Dashboard screenshots | ☐ |
| 6 | Design system tokens implemented | Component library demo | ☐ |
| 7 | Theme toggle functional (light/dark/system) | Before/after screenshots | ☐ |
| 8 | Git workflow and processes documented | Studio Operations playbook | ☐ |
## Gate Decision
**Dual sign-off required**: DevOps Automator (infrastructure) + Evidence Collector (visual)
- **PASS**: Working skeleton with full DevOps pipeline → Phase 3 activation
- **FAIL**: Specific infrastructure or application issues → Fix and re-verify
## Handoff to Phase 3
```markdown
## Phase 2 → Phase 3 Handoff Package
### For all Developer Agents:
- Working CI/CD pipeline (auto-deploys on merge)
- Design system tokens and component library
- API scaffold with auth and health checks
- Database with schema and seed data
- Git workflow and PR process
### For Evidence Collector (ongoing QA):
- Application URLs (dev, staging)
- Screenshot capture methodology
- Component library reference
- Brand guidelines for visual verification
### For Agents Orchestrator (Dev↔QA loop management):
- Sprint Prioritizer backlog (from Phase 1)
- Task list with acceptance criteria (from Phase 1)
- Agent assignment matrix (from NEXUS strategy)
- Quality thresholds for each task type
### Environment Access:
- Dev environment: [URL]
- Staging environment: [URL]
- Monitoring dashboard: [URL]
- CI/CD pipeline: [URL]
- API documentation: [URL]
```
---
*Phase 2 is complete when the skeleton application is running, the CI/CD pipeline is operational, and the Evidence Collector has verified all foundation elements with screenshots.*

View File

@@ -0,0 +1,286 @@
# 🔨 Phase 3 Playbook — Build & Iterate
> **Duration**: 2-12 weeks (varies by scope) | **Agents**: 15-30+ | **Gate Keeper**: Agents Orchestrator
---
## Objective
Implement all features through continuous Dev↔QA loops. Every task is validated before the next begins. This is where the bulk of the work happens — and where NEXUS's orchestration delivers the most value.
## Pre-Conditions
- [ ] Phase 2 Quality Gate passed (foundation verified)
- [ ] Sprint Prioritizer backlog available with RICE scores
- [ ] CI/CD pipeline operational
- [ ] Design system and component library ready
- [ ] API scaffold with auth system ready
## The Dev↔QA Loop — Core Mechanic
The Agents Orchestrator manages every task through this cycle:
```
FOR EACH task IN sprint_backlog (ordered by RICE score):
1. ASSIGN task to appropriate Developer Agent (see assignment matrix)
2. Developer IMPLEMENTS task
3. Evidence Collector TESTS task
- Visual screenshots (desktop, tablet, mobile)
- Functional verification against acceptance criteria
- Brand consistency check
4. IF verdict == PASS:
Mark task complete
Move to next task
ELIF verdict == FAIL AND attempts < 3:
Send QA feedback to Developer
Developer FIXES specific issues
Return to step 3
ELIF attempts >= 3:
ESCALATE to Agents Orchestrator
Orchestrator decides: reassign, decompose, defer, or accept
5. UPDATE pipeline status report
```
## Agent Assignment Matrix
### Primary Developer Assignment
| Task Category | Primary Agent | Backup Agent | QA Agent |
|--------------|--------------|-------------|----------|
| **React/Vue/Angular UI** | Frontend Developer | Rapid Prototyper | Evidence Collector |
| **REST/GraphQL API** | Backend Architect | Senior Developer | API Tester |
| **Database operations** | Backend Architect | — | API Tester |
| **Mobile (iOS/Android)** | Mobile App Builder | — | Evidence Collector |
| **ML model/pipeline** | AI Engineer | — | Test Results Analyzer |
| **CI/CD/Infrastructure** | DevOps Automator | Infrastructure Maintainer | Performance Benchmarker |
| **Premium/complex feature** | Senior Developer | Backend Architect | Evidence Collector |
| **Quick prototype/POC** | Rapid Prototyper | Frontend Developer | Evidence Collector |
| **WebXR/immersive** | XR Immersive Developer | — | Evidence Collector |
| **visionOS** | visionOS Spatial Engineer | macOS Spatial/Metal Engineer | Evidence Collector |
| **Cockpit controls** | XR Cockpit Interaction Specialist | XR Interface Architect | Evidence Collector |
| **CLI/terminal tools** | Terminal Integration Specialist | — | API Tester |
| **Code intelligence** | LSP/Index Engineer | — | Test Results Analyzer |
| **Performance optimization** | Performance Benchmarker | Infrastructure Maintainer | Performance Benchmarker |
### Specialist Support (activated as needed)
| Specialist | When to Activate | Trigger |
|-----------|-----------------|---------|
| UI Designer | Component needs visual refinement | Developer requests design guidance |
| Whimsy Injector | Feature needs delight/personality | UX review identifies opportunity |
| Visual Storyteller | Visual narrative content needed | Content requires visual assets |
| Brand Guardian | Brand consistency concern | QA finds brand deviation |
| XR Interface Architect | Spatial interaction design needed | XR feature requires UX guidance |
| Data Analytics Reporter | Deep data analysis needed | Feature requires analytics integration |
## Parallel Build Tracks
For NEXUS-Full deployments, four tracks run simultaneously:
### Track A: Core Product Development
```
Managed by: Agents Orchestrator (Dev↔QA loop)
Agents: Frontend Developer, Backend Architect, AI Engineer,
Mobile App Builder, Senior Developer
QA: Evidence Collector, API Tester, Test Results Analyzer
Sprint cadence: 2-week sprints
Daily: Task implementation + QA validation
End of sprint: Sprint review + retrospective
```
### Track B: Growth & Marketing Preparation
```
Managed by: Project Shepherd
Agents: Growth Hacker, Content Creator, Social Media Strategist,
App Store Optimizer
Sprint cadence: Aligned with Track A milestones
Activities:
- Growth Hacker → Design viral loops and referral mechanics
- Content Creator → Build launch content pipeline
- Social Media Strategist → Plan cross-platform campaign
- App Store Optimizer → Prepare store listing (if mobile)
```
### Track C: Quality & Operations
```
Managed by: Agents Orchestrator
Agents: Evidence Collector, API Tester, Performance Benchmarker,
Workflow Optimizer, Experiment Tracker
Continuous activities:
- Evidence Collector → Screenshot QA for every task
- API Tester → Endpoint validation for every API task
- Performance Benchmarker → Periodic load testing
- Workflow Optimizer → Process improvement identification
- Experiment Tracker → A/B test setup for validated features
```
### Track D: Brand & Experience Polish
```
Managed by: Brand Guardian
Agents: UI Designer, Brand Guardian, Visual Storyteller,
Whimsy Injector
Triggered activities:
- UI Designer → Component refinement when QA identifies visual issues
- Brand Guardian → Periodic brand consistency audit
- Visual Storyteller → Visual narrative assets as features complete
- Whimsy Injector → Micro-interactions and delight moments
```
## Sprint Execution Template
### Sprint Planning (Day 1)
```
Sprint Prioritizer activates:
1. Review backlog with updated RICE scores
2. Select tasks for sprint based on team velocity
3. Assign tasks to developer agents
4. Identify dependencies and ordering
5. Set sprint goal and success criteria
Output: Sprint Plan with task assignments
```
### Daily Execution (Day 2 to Day N-1)
```
Agents Orchestrator manages:
1. Current task status check
2. Dev↔QA loop execution
3. Blocker identification and resolution
4. Progress tracking and reporting
Status report format:
- Tasks completed today: [list]
- Tasks in QA: [list]
- Tasks in development: [list]
- Blocked tasks: [list with reason]
- QA pass rate: [X/Y]
```
### Sprint Review (Day N)
```
Project Shepherd facilitates:
1. Demo completed features
2. Review QA evidence for each task
3. Collect stakeholder feedback
4. Update backlog based on learnings
Participants: All active agents + stakeholders
Output: Sprint Review Summary
```
### Sprint Retrospective
```
Workflow Optimizer facilitates:
1. What went well?
2. What could improve?
3. What will we change next sprint?
4. Process efficiency metrics
Output: Retrospective Action Items
```
## Orchestrator Decision Logic
### Task Failure Handling
```
WHEN task fails QA:
IF attempt == 1:
→ Send specific QA feedback to developer
→ Developer fixes ONLY the identified issues
→ Re-submit for QA
IF attempt == 2:
→ Send accumulated QA feedback
→ Consider: Is the developer agent the right fit?
→ Developer fixes with additional context
→ Re-submit for QA
IF attempt == 3:
→ ESCALATE
→ Options:
a) Reassign to different developer agent
b) Decompose task into smaller sub-tasks
c) Revise approach/architecture
d) Accept with known limitations (document)
e) Defer to future sprint
→ Document decision and rationale
```
### Parallel Task Management
```
WHEN multiple tasks have no dependencies:
→ Assign to different developer agents simultaneously
→ Each runs independent Dev↔QA loop
→ Orchestrator tracks all loops concurrently
→ Merge completed tasks in dependency order
WHEN task has dependencies:
→ Wait for dependency to pass QA
→ Then assign dependent task
→ Include dependency context in handoff
```
## Quality Gate Checklist
| # | Criterion | Evidence Source | Status |
|---|-----------|----------------|--------|
| 1 | All sprint tasks pass QA (100% completion) | Evidence Collector screenshots per task | ☐ |
| 2 | All API endpoints validated | API Tester regression report | ☐ |
| 3 | Performance baselines met (P95 < 200ms) | Performance Benchmarker report | ☐ |
| 4 | Brand consistency verified (95%+ adherence) | Brand Guardian audit | ☐ |
| 5 | No critical bugs (zero P0/P1 open) | Test Results Analyzer summary | ☐ |
| 6 | All acceptance criteria met | Task-by-task verification | ☐ |
| 7 | Code review completed for all PRs | Git history evidence | ☐ |
## Gate Decision
**Gate Keeper**: Agents Orchestrator
- **PASS**: Feature-complete application → Phase 4 activation
- **CONTINUE**: More sprints needed → Continue Phase 3
- **ESCALATE**: Systemic issues → Studio Producer intervention
## Handoff to Phase 4
```markdown
## Phase 3 → Phase 4 Handoff Package
### For Reality Checker:
- Complete application (all features implemented)
- All QA evidence from Dev↔QA loops
- API Tester regression results
- Performance Benchmarker baseline data
- Brand Guardian consistency audit
- Known issues list (if any accepted limitations)
### For Legal Compliance Checker:
- Data handling implementation details
- Privacy policy implementation
- Consent management implementation
- Security measures implemented
### For Performance Benchmarker:
- Application URLs for load testing
- Expected traffic patterns
- Performance budgets from architecture
### For Infrastructure Maintainer:
- Production environment requirements
- Scaling configuration needs
- Monitoring alert thresholds
```
---
*Phase 3 is complete when all sprint tasks pass QA, all API endpoints are validated, performance baselines are met, and no critical bugs remain open.*

View File

@@ -0,0 +1,332 @@
# 🛡️ Phase 4 Playbook — Quality & Hardening
> **Duration**: 3-7 days | **Agents**: 8 | **Gate Keeper**: Reality Checker (sole authority)
---
## Objective
The final quality gauntlet. The Reality Checker defaults to "NEEDS WORK" — you must prove production readiness with overwhelming evidence. This phase exists because first implementations typically need 2-3 revision cycles, and that's healthy.
## Pre-Conditions
- [ ] Phase 3 Quality Gate passed (all tasks QA'd)
- [ ] Phase 3 Handoff Package received
- [ ] All features implemented and individually verified
## Critical Mindset
> **The Reality Checker's default verdict is NEEDS WORK.**
>
> This is not pessimism — it's realism. Production readiness requires:
> - Complete user journeys working end-to-end
> - Cross-device consistency (desktop, tablet, mobile)
> - Performance under load (not just happy path)
> - Security validation (not just "we added auth")
> - Specification compliance (every requirement, not most)
>
> A B/B+ rating on first pass is normal and expected.
## Agent Activation Sequence
### Step 1: Evidence Collection (Day 1-2, All Parallel)
#### 📸 Evidence Collector — Comprehensive Visual Evidence
```
Activate Evidence Collector for comprehensive system evidence on [PROJECT].
Deliverables required:
1. Full screenshot suite:
- Desktop (1920x1080) — every page/view
- Tablet (768x1024) — every page/view
- Mobile (375x667) — every page/view
2. Interaction evidence:
- Navigation flows (before/after clicks)
- Form interactions (empty, filled, submitted, error states)
- Modal/dialog interactions
- Accordion/expandable content
3. Theme evidence:
- Light mode — all pages
- Dark mode — all pages
- System preference detection
4. Error state evidence:
- 404 pages
- Form validation errors
- Network error handling
- Empty states
Format: Screenshot Evidence Package with test-results.json
Timeline: 2 days
```
#### 🔌 API Tester — Full API Regression
```
Activate API Tester for complete API regression on [PROJECT].
Deliverables required:
1. Endpoint regression suite:
- All endpoints tested (GET, POST, PUT, DELETE)
- Authentication/authorization verification
- Input validation testing
- Error response verification
2. Integration testing:
- Cross-service communication
- Database operation verification
- External API integration
3. Edge case testing:
- Rate limiting behavior
- Large payload handling
- Concurrent request handling
- Malformed input handling
Format: API Test Report with pass/fail per endpoint
Timeline: 2 days
```
#### ⚡ Performance Benchmarker — Load Testing
```
Activate Performance Benchmarker for load testing on [PROJECT].
Deliverables required:
1. Load test at 10x expected traffic:
- Response time distribution (P50, P95, P99)
- Throughput under load
- Error rate under load
- Resource utilization (CPU, memory, network)
2. Core Web Vitals measurement:
- LCP (Largest Contentful Paint) < 2.5s
- FID (First Input Delay) < 100ms
- CLS (Cumulative Layout Shift) < 0.1
3. Database performance:
- Query execution times
- Connection pool utilization
- Index effectiveness
4. Stress test results:
- Breaking point identification
- Graceful degradation behavior
- Recovery time after overload
Format: Performance Certification Report
Timeline: 2 days
```
#### ⚖️ Legal Compliance Checker — Final Compliance Audit
```
Activate Legal Compliance Checker for final compliance audit on [PROJECT].
Deliverables required:
1. Privacy compliance verification:
- Privacy policy accuracy
- Consent management functionality
- Data subject rights implementation
- Cookie consent implementation
2. Security compliance:
- Data encryption (at rest and in transit)
- Authentication security
- Input sanitization
- OWASP Top 10 check
3. Regulatory compliance:
- GDPR requirements (if applicable)
- CCPA requirements (if applicable)
- Industry-specific requirements
4. Accessibility compliance:
- WCAG 2.1 AA verification
- Screen reader compatibility
- Keyboard navigation
Format: Compliance Certification Report
Timeline: 2 days
```
### Step 2: Analysis (Day 3-4, Parallel, after Step 1)
#### 📊 Test Results Analyzer — Quality Metrics Aggregation
```
Activate Test Results Analyzer for quality metrics aggregation on [PROJECT].
Input: ALL Step 1 reports
Deliverables required:
1. Aggregate quality dashboard:
- Overall quality score
- Category breakdown (visual, functional, performance, security, compliance)
- Issue severity distribution
- Trend analysis (if multiple test cycles)
2. Issue prioritization:
- Critical issues (must fix before production)
- High issues (should fix before production)
- Medium issues (fix in next sprint)
- Low issues (backlog)
3. Risk assessment:
- Production readiness probability
- Remaining risk areas
- Recommended mitigations
Format: Quality Metrics Dashboard
Timeline: 1 day
```
#### 🔄 Workflow Optimizer — Process Efficiency Review
```
Activate Workflow Optimizer for process efficiency review on [PROJECT].
Input: Phase 3 execution data + Step 1 findings
Deliverables required:
1. Process efficiency analysis:
- Dev↔QA loop efficiency (first-pass rate, average retries)
- Bottleneck identification
- Time-to-resolution for different issue types
2. Improvement recommendations:
- Process changes for Phase 6 operations
- Automation opportunities
- Quality improvement suggestions
Format: Optimization Recommendations Report
Timeline: 1 day
```
#### 🏗️ Infrastructure Maintainer — Production Readiness Check
```
Activate Infrastructure Maintainer for production readiness on [PROJECT].
Deliverables required:
1. Production environment validation:
- All services healthy and responding
- Auto-scaling configured and tested
- Load balancer configuration verified
- SSL/TLS certificates valid
2. Monitoring validation:
- All critical metrics being collected
- Alert rules configured and tested
- Dashboard access verified
- Log aggregation working
3. Disaster recovery validation:
- Backup systems operational
- Recovery procedures documented and tested
- Failover mechanisms verified
4. Security validation:
- Firewall rules reviewed
- Access controls verified
- Secrets management confirmed
- Vulnerability scan clean
Format: Infrastructure Readiness Report
Timeline: 1 day
```
### Step 3: Final Judgment (Day 5-7, Sequential)
#### 🔍 Reality Checker — THE FINAL VERDICT
```
Activate Reality Checker for final integration testing on [PROJECT].
MANDATORY PROCESS — DO NOT SKIP:
Step 1: Reality Check Commands
- Verify what was actually built (ls, grep for claimed features)
- Cross-check claimed features against specification
- Run comprehensive screenshot capture
- Review all evidence from Step 1 and Step 2
Step 2: QA Cross-Validation
- Review Evidence Collector findings
- Cross-reference with API Tester results
- Verify Performance Benchmarker data
- Confirm Legal Compliance Checker findings
Step 3: End-to-End System Validation
- Test COMPLETE user journeys (not individual features)
- Verify responsive behavior across ALL devices
- Check interaction flows end-to-end
- Review actual performance data
Step 4: Specification Reality Check
- Quote EXACT text from original specification
- Compare with ACTUAL implementation evidence
- Document EVERY gap between spec and reality
- No assumptions — evidence only
VERDICT OPTIONS:
- READY: Overwhelming evidence of production readiness (rare first pass)
- NEEDS WORK: Specific issues identified with fix list (expected)
- NOT READY: Major architectural issues requiring Phase 1/2 revisit
Format: Reality-Based Integration Report
Default: NEEDS WORK unless proven otherwise
```
## Quality Gate — THE FINAL GATE
| # | Criterion | Threshold | Evidence Required |
|---|-----------|-----------|-------------------|
| 1 | User journeys complete | All critical paths working end-to-end | Reality Checker screenshots |
| 2 | Cross-device consistency | Desktop + Tablet + Mobile all working | Responsive screenshots |
| 3 | Performance certified | P95 < 200ms, LCP < 2.5s, uptime > 99.9% | Performance Benchmarker report |
| 4 | Security validated | Zero critical vulnerabilities | Security scan + compliance report |
| 5 | Compliance certified | All regulatory requirements met | Legal Compliance Checker report |
| 6 | Specification compliance | 100% of spec requirements implemented | Point-by-point verification |
| 7 | Infrastructure ready | Production environment validated | Infrastructure Maintainer report |
## Gate Decision
**Sole authority**: Reality Checker
### If READY (proceed to Phase 5):
```markdown
## Phase 4 → Phase 5 Handoff Package
### For Launch Team:
- Reality Checker certification report
- Performance certification
- Compliance certification
- Infrastructure readiness report
- Known limitations (if any)
### For Growth Hacker:
- Product ready for users
- Feature list for marketing messaging
- Performance data for credibility
### For DevOps Automator:
- Production deployment approved
- Blue-green deployment plan
- Rollback procedures confirmed
```
### If NEEDS WORK (return to Phase 3):
```markdown
## Phase 4 → Phase 3 Return Package
### Fix List (from Reality Checker):
1. [Critical Issue 1]: [Description + evidence + fix instruction]
2. [Critical Issue 2]: [Description + evidence + fix instruction]
3. [High Issue 1]: [Description + evidence + fix instruction]
...
### Process:
- Issues enter Dev↔QA loop (Phase 3 mechanics)
- Each fix must pass Evidence Collector QA
- When all fixes complete → Return to Phase 4 Step 3
- Reality Checker re-evaluates with updated evidence
### Expected: 2-3 revision cycles is normal
```
### If NOT READY (return to Phase 1/2):
```markdown
## Phase 4 → Phase 1/2 Return Package
### Architectural Issues Identified:
1. [Fundamental Issue]: [Why it can't be fixed in Phase 3]
2. [Structural Problem]: [What needs to change at architecture level]
### Recommended Action:
- [ ] Revise system architecture (Phase 1)
- [ ] Rebuild foundation (Phase 2)
- [ ] Descope and redefine (Phase 1)
### Studio Producer Decision Required
```
---
*Phase 4 is complete when the Reality Checker issues a READY verdict with overwhelming evidence. NEEDS WORK is the expected first-pass result — it means the system is working but needs polish.*

View File

@@ -0,0 +1,277 @@
# 🚀 Phase 5 Playbook — Launch & Growth
> **Duration**: 2-4 weeks (T-7 through T+14) | **Agents**: 12 | **Gate Keepers**: Studio Producer + Analytics Reporter
---
## Objective
Coordinate go-to-market execution across all channels simultaneously. Maximum impact at launch. Every marketing agent fires in concert while engineering ensures stability.
## Pre-Conditions
- [ ] Phase 4 Quality Gate passed (Reality Checker READY verdict)
- [ ] Phase 4 Handoff Package received
- [ ] Production deployment plan approved
- [ ] Marketing content pipeline ready (from Phase 3 Track B)
## Launch Timeline
### T-7: Pre-Launch Week
#### Content & Campaign Preparation (Parallel)
```
ACTIVATE Content Creator:
- Finalize all launch content (blog posts, landing pages, email sequences)
- Queue content in publishing platforms
- Prepare response templates for anticipated questions
- Create launch day real-time content plan
ACTIVATE Social Media Strategist:
- Finalize cross-platform campaign assets
- Schedule pre-launch teaser content
- Coordinate influencer partnerships
- Prepare platform-specific content variations
ACTIVATE Growth Hacker:
- Arm viral mechanics (referral codes, sharing incentives)
- Configure growth experiment tracking
- Set up funnel analytics
- Prepare acquisition channel budgets
ACTIVATE App Store Optimizer (if mobile):
- Finalize store listing (title, description, keywords, screenshots)
- Submit app for review (if applicable)
- Prepare launch day ASO adjustments
- Configure in-app review prompts
```
#### Technical Preparation (Parallel)
```
ACTIVATE DevOps Automator:
- Prepare blue-green deployment
- Verify rollback procedures
- Configure feature flags for gradual rollout
- Test deployment pipeline end-to-end
ACTIVATE Infrastructure Maintainer:
- Configure auto-scaling for 10x expected traffic
- Verify monitoring and alerting thresholds
- Test disaster recovery procedures
- Prepare incident response runbook
ACTIVATE Project Shepherd:
- Distribute launch checklist to all agents
- Confirm all dependencies resolved
- Set up launch day communication channel
- Brief stakeholders on launch plan
```
### T-1: Launch Eve
```
FINAL CHECKLIST (Project Shepherd coordinates):
Technical:
☐ Blue-green deployment tested
☐ Rollback procedure verified
☐ Auto-scaling configured
☐ Monitoring dashboards live
☐ Incident response team on standby
☐ Feature flags configured
Content:
☐ All content queued and scheduled
☐ Email sequences armed
☐ Social media posts scheduled
☐ Blog posts ready to publish
☐ Press materials distributed
Marketing:
☐ Viral mechanics tested
☐ Referral system operational
☐ Analytics tracking verified
☐ Ad campaigns ready to activate
☐ Community engagement plan ready
Support:
☐ Support team briefed
☐ FAQ and help docs published
☐ Escalation procedures confirmed
☐ Feedback collection active
```
### T-0: Launch Day
#### Hour 0: Deployment
```
ACTIVATE DevOps Automator:
1. Execute blue-green deployment to production
2. Run health checks on all services
3. Verify database migrations complete
4. Confirm all endpoints responding
5. Switch traffic to new deployment
6. Monitor error rates for 15 minutes
7. Confirm: DEPLOYMENT SUCCESSFUL or ROLLBACK
ACTIVATE Infrastructure Maintainer:
1. Monitor all system metrics in real-time
2. Watch for traffic spikes and scaling events
3. Track error rates and response times
4. Alert on any threshold breaches
5. Confirm: SYSTEMS STABLE
```
#### Hour 1-2: Marketing Activation
```
ACTIVATE Twitter Engager:
- Publish launch thread
- Engage with early responses
- Monitor brand mentions
- Amplify positive reactions
- Real-time conversation participation
ACTIVATE Reddit Community Builder:
- Post authentic launch announcement in relevant subreddits
- Engage with comments (value-first, not promotional)
- Monitor community sentiment
- Respond to technical questions
ACTIVATE Instagram Curator:
- Publish launch visual content
- Stories with product demos
- Engage with early followers
- Cross-promote with other channels
ACTIVATE TikTok Strategist:
- Publish launch videos
- Monitor for viral potential
- Engage with comments
- Adjust content based on early performance
```
#### Hour 2-8: Monitoring & Response
```
ACTIVATE Support Responder:
- Handle incoming user inquiries
- Document common issues
- Escalate technical problems to engineering
- Collect early user feedback
ACTIVATE Analytics Reporter:
- Real-time metrics dashboard
- Hourly traffic and conversion reports
- Channel attribution tracking
- User behavior flow analysis
ACTIVATE Feedback Synthesizer:
- Monitor all feedback channels
- Categorize incoming feedback
- Identify critical issues
- Prioritize user-reported problems
```
### T+1 to T+7: Post-Launch Week
```
DAILY CADENCE:
Morning:
├── Analytics Reporter → Daily metrics report
├── Feedback Synthesizer → Feedback summary
├── Infrastructure Maintainer → System health report
└── Growth Hacker → Channel performance analysis
Afternoon:
├── Content Creator → Response content based on reception
├── Social Media Strategist → Engagement optimization
├── Experiment Tracker → Launch A/B test results
└── Support Responder → Issue resolution summary
Evening:
├── Executive Summary Generator → Daily stakeholder briefing
├── Project Shepherd → Cross-team coordination
└── DevOps Automator → Deployment of hotfixes (if needed)
```
### T+7 to T+14: Optimization Week
```
ACTIVATE Growth Hacker:
- Analyze first-week acquisition data
- Optimize conversion funnels based on data
- Scale winning channels, cut losing ones
- Refine viral mechanics based on K-factor data
ACTIVATE Analytics Reporter:
- Week 1 comprehensive analysis
- Cohort analysis of launch users
- Retention curve analysis
- Revenue/engagement metrics
ACTIVATE Experiment Tracker:
- Launch systematic A/B tests
- Test onboarding variations
- Test pricing/packaging (if applicable)
- Test feature discovery flows
ACTIVATE Executive Summary Generator:
- Week 1 executive summary (SCQA format)
- Key metrics vs. targets
- Recommendations for Week 2+
- Resource reallocation suggestions
```
## Quality Gate Checklist
| # | Criterion | Evidence Source | Status |
|---|-----------|----------------|--------|
| 1 | Deployment successful (zero-downtime) | DevOps Automator deployment logs | ☐ |
| 2 | Systems stable (no P0/P1 in 48 hours) | Infrastructure Maintainer monitoring | ☐ |
| 3 | User acquisition channels active | Analytics Reporter dashboard | ☐ |
| 4 | Feedback loop operational | Feedback Synthesizer report | ☐ |
| 5 | Stakeholders informed | Executive Summary Generator output | ☐ |
| 6 | Support operational | Support Responder metrics | ☐ |
| 7 | Growth metrics tracking | Growth Hacker channel reports | ☐ |
## Gate Decision
**Dual sign-off**: Studio Producer (strategic) + Analytics Reporter (data)
- **STABLE**: Product launched, systems stable, growth active → Phase 6 activation
- **CRITICAL**: Major issues requiring immediate engineering response → Hotfix cycle
- **ROLLBACK**: Fundamental problems → Revert deployment, return to Phase 4
## Handoff to Phase 6
```markdown
## Phase 5 → Phase 6 Handoff Package
### For Ongoing Operations:
- Launch metrics baseline (Analytics Reporter)
- User feedback themes (Feedback Synthesizer)
- System performance baseline (Infrastructure Maintainer)
- Growth channel performance (Growth Hacker)
- Support issue patterns (Support Responder)
### For Continuous Improvement:
- A/B test results and learnings (Experiment Tracker)
- Process improvement recommendations (Workflow Optimizer)
- Financial performance vs. projections (Finance Tracker)
- Compliance monitoring status (Legal Compliance Checker)
### Operational Cadences Established:
- Daily: System monitoring, support, analytics
- Weekly: Analytics report, feedback synthesis, sprint planning
- Monthly: Executive summary, financial review, compliance check
- Quarterly: Strategic review, process optimization, market intelligence
```
---
*Phase 5 is complete when the product is deployed, systems are stable for 48+ hours, growth channels are active, and the feedback loop is operational.*

View File

@@ -0,0 +1,318 @@
# 🔄 Phase 6 Playbook — Operate & Evolve
> **Duration**: Ongoing | **Agents**: 12+ (rotating) | **Governance**: Studio Producer
---
## Objective
Sustained operations with continuous improvement. The product is live — now make it thrive. This phase has no end date; it runs as long as the product is in market.
## Pre-Conditions
- [ ] Phase 5 Quality Gate passed (stable launch)
- [ ] Phase 5 Handoff Package received
- [ ] Operational cadences established
- [ ] Baseline metrics documented
## Operational Cadences
### Continuous (Always Active)
| Agent | Responsibility | SLA |
|-------|---------------|-----|
| **Infrastructure Maintainer** | System uptime, performance, security | 99.9% uptime, < 30min MTTR |
| **Support Responder** | Customer support, issue resolution | < 4hr first response |
| **DevOps Automator** | Deployment pipeline, hotfixes | Multiple deploys/day capability |
### Daily
| Agent | Activity | Output |
|-------|----------|--------|
| **Analytics Reporter** | KPI dashboard update | Daily metrics snapshot |
| **Support Responder** | Issue triage and resolution | Support ticket summary |
| **Infrastructure Maintainer** | System health check | Health status report |
### Weekly
| Agent | Activity | Output |
|-------|----------|--------|
| **Analytics Reporter** | Weekly performance analysis | Weekly Analytics Report |
| **Feedback Synthesizer** | User feedback synthesis | Weekly Feedback Summary |
| **Sprint Prioritizer** | Backlog grooming + sprint planning | Sprint Plan |
| **Growth Hacker** | Growth channel optimization | Growth Metrics Report |
| **Project Shepherd** | Cross-team coordination | Weekly Status Update |
### Bi-Weekly
| Agent | Activity | Output |
|-------|----------|--------|
| **Feedback Synthesizer** | Deep feedback analysis | Bi-Weekly Insights Report |
| **Experiment Tracker** | A/B test analysis | Experiment Results Summary |
| **Content Creator** | Content calendar execution | Published Content Report |
### Monthly
| Agent | Activity | Output |
|-------|----------|--------|
| **Executive Summary Generator** | C-suite reporting | Monthly Executive Summary |
| **Finance Tracker** | Financial performance review | Monthly Financial Report |
| **Legal Compliance Checker** | Regulatory monitoring | Compliance Status Report |
| **Trend Researcher** | Market intelligence update | Monthly Market Brief |
| **Brand Guardian** | Brand consistency audit | Brand Health Report |
### Quarterly
| Agent | Activity | Output |
|-------|----------|--------|
| **Studio Producer** | Strategic portfolio review | Quarterly Strategic Review |
| **Workflow Optimizer** | Process efficiency audit | Optimization Report |
| **Performance Benchmarker** | Performance regression testing | Quarterly Performance Report |
| **Tool Evaluator** | Technology stack review | Tech Debt Assessment |
## Continuous Improvement Loop
```
MEASURE (Analytics Reporter)
ANALYZE (Feedback Synthesizer + Data Analytics Reporter)
PLAN (Sprint Prioritizer + Studio Producer)
BUILD (Phase 3 Dev↔QA Loop — mini-cycles)
VALIDATE (Evidence Collector + Reality Checker)
DEPLOY (DevOps Automator)
MEASURE (back to start)
```
### Feature Development in Phase 6
New features follow a compressed NEXUS cycle:
```
1. Sprint Prioritizer selects feature from backlog
2. Appropriate Developer Agent implements
3. Evidence Collector validates (Dev↔QA loop)
4. DevOps Automator deploys (feature flag or direct)
5. Experiment Tracker monitors (A/B test if applicable)
6. Analytics Reporter measures impact
7. Feedback Synthesizer collects user response
```
## Incident Response Protocol
### Severity Levels
| Level | Definition | Response Time | Decision Authority |
|-------|-----------|--------------|-------------------|
| **P0 — Critical** | Service down, data loss, security breach | Immediate | Studio Producer |
| **P1 — High** | Major feature broken, significant degradation | < 1 hour | Project Shepherd |
| **P2 — Medium** | Minor feature issue, workaround available | < 4 hours | Agents Orchestrator |
| **P3 — Low** | Cosmetic issue, minor inconvenience | Next sprint | Sprint Prioritizer |
### Incident Response Sequence
```
DETECTION (Infrastructure Maintainer or Support Responder)
TRIAGE (Agents Orchestrator)
├── Classify severity (P0-P3)
├── Assign response team
└── Notify stakeholders
RESPONSE
├── P0: Infrastructure Maintainer + DevOps Automator + Backend Architect
├── P1: Relevant Developer Agent + DevOps Automator
├── P2: Relevant Developer Agent
└── P3: Added to sprint backlog
RESOLUTION
├── Fix implemented and deployed
├── Evidence Collector verifies fix
└── Infrastructure Maintainer confirms stability
POST-MORTEM
├── Workflow Optimizer leads retrospective
├── Root cause analysis documented
├── Prevention measures identified
└── Process improvements implemented
```
## Growth Operations
### Monthly Growth Review (Growth Hacker leads)
```
1. Channel Performance Analysis
- Acquisition by channel (organic, paid, referral, social)
- CAC by channel
- Conversion rates by funnel stage
- LTV:CAC ratio trends
2. Experiment Results
- Completed A/B tests and outcomes
- Statistical significance validation
- Winner implementation status
- New experiment pipeline
3. Retention Analysis
- Cohort retention curves
- Churn risk identification
- Re-engagement campaign results
- Feature adoption metrics
4. Growth Roadmap Update
- Next month's growth experiments
- Channel budget reallocation
- New channel exploration
- Viral coefficient optimization
```
### Content Operations (Content Creator + Social Media Strategist)
```
Weekly:
- Content calendar execution
- Social media engagement
- Community management
- Performance tracking
Monthly:
- Content performance review
- Editorial calendar planning
- Platform algorithm updates
- Content strategy refinement
Platform-Specific:
- Twitter Engager → Daily engagement, weekly threads
- Instagram Curator → 3-5 posts/week, daily stories
- TikTok Strategist → 3-5 videos/week
- Reddit Community Builder → Daily authentic engagement
```
## Financial Operations
### Monthly Financial Review (Finance Tracker)
```
1. Revenue Analysis
- MRR/ARR tracking
- Revenue by segment/plan
- Expansion revenue
- Churn revenue impact
2. Cost Analysis
- Infrastructure costs
- Marketing spend by channel
- Team/resource costs
- Tool and service costs
3. Unit Economics
- CAC trends
- LTV trends
- LTV:CAC ratio
- Payback period
4. Forecasting
- Revenue forecast (3-month rolling)
- Cost forecast
- Cash flow projection
- Budget variance analysis
```
## Compliance Operations
### Monthly Compliance Check (Legal Compliance Checker)
```
1. Regulatory Monitoring
- New regulations affecting the product
- Existing regulation changes
- Enforcement actions in the industry
- Compliance deadline tracking
2. Privacy Compliance
- Data subject request handling
- Consent management effectiveness
- Data retention policy adherence
- Cross-border transfer compliance
3. Security Compliance
- Vulnerability scan results
- Patch management status
- Access control review
- Incident log review
4. Audit Readiness
- Documentation currency
- Evidence collection status
- Training completion rates
- Policy acknowledgment tracking
```
## Strategic Evolution
### Quarterly Strategic Review (Studio Producer)
```
1. Market Position Assessment
- Competitive landscape changes (Trend Researcher input)
- Market share evolution
- Brand perception (Brand Guardian input)
- Customer satisfaction trends (Feedback Synthesizer input)
2. Product Strategy
- Feature roadmap review
- Technology debt assessment (Tool Evaluator input)
- Platform expansion opportunities
- Partnership evaluation
3. Growth Strategy
- Channel effectiveness review
- New market opportunities
- Pricing strategy assessment
- Expansion planning
4. Organizational Health
- Process efficiency (Workflow Optimizer input)
- Team performance metrics
- Resource allocation optimization
- Capability development needs
Output: Quarterly Strategic Review → Updated roadmap and priorities
```
## Phase 6 Success Metrics
| Category | Metric | Target | Owner |
|----------|--------|--------|-------|
| **Reliability** | System uptime | > 99.9% | Infrastructure Maintainer |
| **Reliability** | MTTR | < 30 minutes | Infrastructure Maintainer |
| **Growth** | MoM user growth | > 20% | Growth Hacker |
| **Growth** | Activation rate | > 60% | Analytics Reporter |
| **Retention** | Day 7 retention | > 40% | Analytics Reporter |
| **Retention** | Day 30 retention | > 20% | Analytics Reporter |
| **Financial** | LTV:CAC ratio | > 3:1 | Finance Tracker |
| **Financial** | Portfolio ROI | > 25% | Studio Producer |
| **Quality** | NPS score | > 50 | Feedback Synthesizer |
| **Quality** | Support resolution time | < 4 hours | Support Responder |
| **Compliance** | Regulatory adherence | > 98% | Legal Compliance Checker |
| **Efficiency** | Deployment frequency | Multiple/day | DevOps Automator |
| **Efficiency** | Process improvement | 20%/quarter | Workflow Optimizer |
---
*Phase 6 has no end date. It runs as long as the product is in market, with continuous improvement cycles driving the product forward. The NEXUS pipeline can be re-activated (NEXUS-Sprint or NEXUS-Micro) for major new features or pivots.*