Skip to main content

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

1

Architecture Approved

Phase 1 Quality Gate passed (Architecture Package approved)
2

Handoff Complete

Phase 1 Handoff Package received
3

Documents Finalized

All architecture documents finalized and accessible

Workstreams

Workstream A: Infrastructure (Day 1-3, Parallel)

DevOps Automator

CI/CD Pipeline + Infrastructure
  • CI/CD Pipeline (GitHub Actions/GitLab CI)
  • Security scanning
  • Automated testing
  • Build and containerization
  • Blue-green deployment
  • Automated rollback
  • Infrastructure as Code
  • Environment provisioning
  • Secrets management
Timeline: 3 days

Infrastructure Maintainer

Monitoring & Cloud Setup
  • Cloud resource provisioning
  • Auto-scaling configuration
  • Load balancer setup
  • Monitoring stack (Prometheus/DataDog)
  • Custom dashboards (Grafana)
  • Centralized logging
  • Alert rules
  • Security hardening
Timeline: 3 days

Studio Operations

Process Setup
  • Git workflow (branch strategy)
  • PR review process
  • Merge policies
  • Communication channels
  • Documentation templates
  • Collaboration tools
  • Project board setup
Timeline: 2 days

Workstream B: Application Foundation (Day 1-4, Parallel)

Project ScaffoldingDeliverables:
  • Framework setup (React/Vue/Angular)
  • TypeScript configuration
  • Build tooling (Vite/Webpack/Next.js)
  • Testing framework (Jest/Vitest + Testing Library)
  • Design system implementation
  • Base component library (Button, Input, Card, Layout)
  • Theme system (light/dark/system)
  • Application shell (routing, layouts, error boundaries)
Timeline: 3 days

Verification Checkpoint (Day 4-5)

Verify 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

#CriterionEvidence SourceStatus
1CI/CD pipeline builds, tests, deploysPipeline execution logs
2Database schema deployedMigration success output
3API scaffold respondingcurl response evidence
4Frontend skeleton rendersEvidence Collector screenshots
5Monitoring dashboards activeDashboard screenshots
6Design system tokens implementedComponent library demo
7Theme toggle functionalBefore/after screenshots
8Git workflow documentedStudio Operations playbook

Gate Decision

Proceed to Phase 3Working skeleton with full DevOps pipelineDual sign-off: DevOps Automator (infrastructure) + Evidence Collector (visual)

Handoff to Phase 3

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.

Build docs developers (and LLMs) love