full-stack-feature

Orchestrate full-stack feature development across backend, frontend, and infrastructure layers with modern API-first approach:

[Extended thinking: This workflow coordinates multiple specialized agents to deliver a complete full-stack feature from architecture through deployment. It follows API-first development principles, ensuring contract-driven development where the API specification drives both backend implementation and frontend consumption. Each phase builds upon previous outputs, creating a cohesive system with proper separation of concerns, comprehensive testing, and production-ready deployment. The workflow emphasizes modern practices like component-driven UI development, feature flags, observability, and progressive rollout strategies.]

Phase 1: Architecture & Design Foundation

1. Database Architecture Design

• Do this step directly in Codex CLI (legacy playbook referenced subagent: database-design::database-architect).
• Instruction: "Design database schema and data models for: (use the user's prompt). Consider scalability, query patterns, indexing strategy, and data consistency requirements. Include migration strategy if modifying existing schema. Provide both logical and physical data models."
• Expected output: Entity relationship diagrams, table schemas, indexing strategy, migration scripts, data access patterns
• Context: Initial requirements and business domain model

2. Backend Service Architecture

• Do this step directly in Codex CLI (legacy playbook referenced subagent: backend-development::backend-architect).
• Instruction: "Design backend service architecture for: (use the user's prompt). Using the database design from previous step, create service boundaries, define API contracts (OpenAPI/GraphQL), design authentication/authorization strategy, and specify inter-service communication patterns. Include resilience patterns (circuit breakers, retries) and caching strategy."
• Expected output: Service architecture diagram, OpenAPI specifications, authentication flows, caching architecture, message queue design (if applicable)
• Context: Database schema from step 1, non-functional requirements

3. Frontend Component Architecture

• Do this step directly in Codex CLI (legacy playbook referenced subagent: frontend-mobile-development::frontend-developer).
• Instruction: "Design frontend architecture and component structure for: (use the user's prompt). Based on the API contracts from previous step, design component hierarchy, state management approach (Redux/Zustand/Context), routing structure, and data fetching patterns. Include accessibility requirements and responsive design strategy. Plan for Storybook component documentation."
• Expected output: Component tree diagram, state management design, routing configuration, design system integration plan, accessibility checklist
• Context: API specifications from step 2, UI/UX requirements

Phase 2: Parallel Implementation

4. Backend Service Implementation

• Do this step directly in Codex CLI (legacy playbook referenced subagent: python-development::python-pro).
• Instruction: "Implement backend services for: (use the user's prompt). Using the architecture and API specs from Phase 1, build RESTful/GraphQL endpoints with proper validation, error handling, and logging. Implement business logic, data access layer, authentication middleware, and integration with external services. Include observability (structured logging, metrics, tracing)."
• Expected output: Backend service code, API endpoints, middleware, background jobs, unit tests, integration tests
• Context: Architecture designs from Phase 1, database schema

5. Frontend Implementation

• Do this step directly in Codex CLI (legacy playbook referenced subagent: frontend-mobile-development::frontend-developer).
• Instruction: "Implement frontend application for: (use the user's prompt). Build React/Next.js components using the component architecture from Phase 1. Implement state management, API integration with proper error handling and loading states, form validation, and responsive layouts. Create Storybook stories for components. Ensure accessibility (WCAG 2.1 AA compliance)."
• Expected output: React components, state management implementation, API client code, Storybook stories, responsive styles, accessibility implementations
• Context: Component architecture from step 3, API contracts

6. Database Implementation & Optimization

• Do this step directly in Codex CLI (legacy playbook referenced subagent: database-design::sql-pro).
• Instruction: "Implement and optimize database layer for: (use the user's prompt). Create migration scripts, stored procedures (if needed), optimize queries identified by backend implementation, set up proper indexes, and implement data validation constraints. Include database-level security measures and backup strategies."
• Expected output: Migration scripts, optimized queries, stored procedures, index definitions, database security configuration
• Context: Database design from step 1, query patterns from backend implementation

Phase 3: Integration & Testing

7. API Contract Testing

• Do this step directly in Codex CLI (legacy playbook referenced subagent: test-automator).
• Instruction: "Create contract tests for: (use the user's prompt). Implement Pact/Dredd tests to validate API contracts between backend and frontend. Create integration tests for all API endpoints, test authentication flows, validate error responses, and ensure proper CORS configuration. Include load testing scenarios."
• Expected output: Contract test suites, integration tests, load test scenarios, API documentation validation
• Context: API implementations from Phase 2

8. End-to-End Testing

• Do this step directly in Codex CLI (legacy playbook referenced subagent: test-automator).
• Instruction: "Implement E2E tests for: (use the user's prompt). Create Playwright/Cypress tests covering critical user journeys, cross-browser compatibility, mobile responsiveness, and error scenarios. Test feature flags integration, analytics tracking, and performance metrics. Include visual regression tests."
• Expected output: E2E test suites, visual regression baselines, performance benchmarks, test reports
• Context: Frontend and backend implementations from Phase 2

9. Security Audit & Hardening

• Do this step directly in Codex CLI (legacy playbook referenced subagent: security-auditor).
• Instruction: "Perform security audit for: (use the user's prompt). Review API security (authentication, authorization, rate limiting), check for OWASP Top 10 vulnerabilities, audit frontend for XSS/CSRF risks, validate input sanitization, and review secrets management. Provide penetration testing results and remediation steps."
• Expected output: Security audit report, vulnerability assessment, remediation recommendations, security headers configuration
• Context: All implementations from Phase 2

Phase 4: Deployment & Operations

10. Infrastructure & CI/CD Setup

• Do this step directly in Codex CLI (legacy playbook referenced subagent: deployment-engineer).
• Instruction: "Setup deployment infrastructure for: (use the user's prompt). Create Docker containers, Kubernetes manifests (or cloud-specific configs), implement CI/CD pipelines with automated testing gates, setup feature flags (LaunchDarkly/Unleash), and configure monitoring/alerting. Include blue-green deployment strategy and rollback procedures."
• Expected output: Dockerfiles, K8s manifests, CI/CD pipeline configs, feature flag setup, IaC templates (Terraform/CloudFormation)
• Context: All implementations and tests from previous phases

11. Observability & Monitoring

• Do this step directly in Codex CLI (legacy playbook referenced subagent: deployment-engineer).
• Instruction: "Implement observability stack for: (use the user's prompt). Setup distributed tracing (OpenTelemetry), configure application metrics (Prometheus/DataDog), implement centralized logging (ELK/Splunk), create dashboards for key metrics, and define SLIs/SLOs. Include alerting rules and on-call procedures."
• Expected output: Observability configuration, dashboard definitions, alert rules, runbooks, SLI/SLO definitions
• Context: Infrastructure setup from step 10

12. Performance Optimization

• Do this step directly in Codex CLI (legacy playbook referenced subagent: performance-engineer).
• Instruction: "Optimize performance across stack for: (use the user's prompt). Analyze and optimize database queries, implement caching strategies (Redis/CDN), optimize frontend bundle size and loading performance, setup lazy loading and code splitting, and tune backend service performance. Include before/after metrics."
• Expected output: Performance improvements, caching configuration, CDN setup, optimized bundles, performance metrics report
• Context: Monitoring data from step 11, load test results

Configuration Options

• stack: Specify technology stack (e.g., "React/FastAPI/PostgreSQL", "Next.js/Django/MongoDB")
• deployment_target: Cloud platform (AWS/GCP/Azure) or on-premises
• feature_flags: Enable/disable feature flag integration
• api_style: REST or GraphQL
• testing_depth: Comprehensive or essential
• compliance: Specific compliance requirements (GDPR, HIPAA, SOC2)

Success Criteria

• All API contracts validated through contract tests
• Frontend and backend integration tests passing
• E2E tests covering critical user journeys
• Security audit passed with no critical vulnerabilities
• Performance metrics meeting defined SLOs
• Observability stack capturing all key metrics
• Feature flags configured for progressive rollout
• Documentation complete for all components
• CI/CD pipeline with automated quality gates
• Zero-downtime deployment capability verified

Coordination Notes

• Each phase builds upon outputs from previous phases
• Parallel tasks in Phase 2 can run simultaneously but must converge for Phase 3
• Maintain traceability between requirements and implementations
• Use correlation IDs across all services for distributed tracing
• Document all architectural decisions in ADRs
• Ensure consistent error handling and API responses across services

Feature to implement: (use the user's prompt)

Output Format

<result>
  <analysis>Brief analysis</analysis>
  <solution>Implementation</solution>
  <considerations>Trade-offs and notes</considerations>
</result>