Skip to main content

ADLC Workflow

Every task follows the same coordination pattern. No exceptions.

The Golden Rule

HITL/Manager → Product Owner → Cloud Architect → Specialist → Evidence
  1. You (HITL) give a directive
  2. Product Owner validates requirements and priority
  3. Cloud Architect designs technical approach
  4. Specialists execute (infra, QA, security, etc.)
  5. Evidence collected in tmp/<project>/

Six-Phase Lifecycle

PLAN → BUILD → TEST → DEPLOY → MONITOR → OPERATE
[A] [A] [HITL] [HITL] [HITL] [HITL]

[A] = Autonomous [HITL] = Requires your approval
PhaseYou DoAgents Do
PlanDescribe what you wantDecompose into stories, create ADRs
BuildReview progressWrite code, IaC, tests
TestApprove test planRun Tier 1/2/3 tests
DeployApprove deploymentExecute terraform/cdk apply
MonitorReview dashboardsSet up alerts, SLOs
OperateHandle incidentsCreate runbooks, playbooks

Quick Start Examples

New Feature

You:  "Add S3 bucket with encryption for audit logs"

Product Owner validates requirements

Cloud Architect designs (CDK vs Terraform, encryption type)

Infrastructure Engineer implements

QA Engineer tests (Tier 1 → 2 → 3)

Evidence in tmp/<project>/

Using SpecKit Commands

# 1. Define the feature
/speckit.specify "Add encrypted S3 bucket for audit logs"

# 2. Plan the implementation
/speckit.plan

# 3. Generate tasks
/speckit.tasks

# 4. Execute all tasks
/speckit.implement

# 5. Reflect on the session
/speckit.retrospective

Infrastructure Deployment

# Terraform workflow
/terraform:test # Run all test tiers
/terraform:cost # Estimate costs
/terraform:diff # Check for breaking changes

# CDK workflow
/cdk:test # Run all test tiers
/cdk:synth # Validate synthesis
/cdk:diff # Check for breaking changes

Evidence Directory

Every action produces evidence:

tmp/<project>/
├── coordination-logs/ # PO + CA approval records
├── test-results/ # Tier 1/2/3 results
├── screenshots/ # Visual verification
├── terraform-plans/ # IaC plan outputs
└── retrospectives/ # Session reflections

Anti-Patterns to Avoid

Don'tDo Instead
Skip PO + CA coordinationAlways invoke both first
Claim "done" without evidencePut artifacts in tmp/
Describe what you'll do (NATO)Show what you did
Deploy without testingRun Tier 1 → 2 → 3
Ignore session learningsRun /speckit.retrospective