How gpatwa/agentic-sdlc-playbook works
Aveto is a reusable, agent-guided software-development lifecycle playbook, with an execution pack that installs role briefs, commands, protocols, and hooks into a product repository for Claude Code. A human scopes a slice; specialist roles hand work through artefacts and approval gates, from discovery and implementation through release and post-launch learning. The runtime also guards write scope and spend, and provides usage, cost, quality, telemetry, conformity, and approval-verification tools. The lifecycle links follow README documentation; sampled execution code confirms several guard and reporting behaviors, but not every stage’s wiring.
Main entry points: agents Specialist Roles · install.mjs Pack Installer · verify-approvals.mjs Approval Verification · release-manager.md Release & Deploy
Components 29
Project Setup
- Project Packs
project-packs - Project Context
examples/saved-items-bulk-delete/.agentic
Slice Lifecycle
- Slice Orchestrator
prompts/orchestrator.md - Specialist Roles
agents - Discovery & Scope
agents/market-researcher.md - Product & UX
agents/product-manager.md - Architecture & Design
agents/software-architect.md - Build & Data
agents - QA & Security
agents/qa-evidence.md - Release Gates
docs/RELEASE_GATES.md - Human Approvals
docs/HUMAN_APPROVAL_RULES.md - Release & Deploy
agents/release-manager.md - Production Learning
agents/post-launch-learning.md - Stage Artefacts
templates - Agent Handoffs
templates/AGENT_HANDOFF_TEMPLATE.md
Execution Runtime
- Pack Installer
execution/install.mjs - Run Protocols
execution/pack/protocols - Write Scope Guard
execution/hooks/write-scope-guard.mjs - Budget Guard
execution/hooks/budget-guard.mjs
Run Evidence
- Usage Measurement
execution/usage.mjs - Cost Analytics
execution/analyze.mjs - Code Quality Report
execution/quality.mjs - Conformity Export
execution/conformity.mjs - Approval Verification
execution/verify-approvals.mjs - Telemetry Probe
execution/otlp-probe.mjs - Run Records
Other components
- Product Owner
- Claude Code
- GitHub
Connections 33
- Product Owner → Project Packs: selects archetype
- Product Owner → Project Context: defines project
- Pack Installer → Specialist Roles: reads briefs
- Pack Installer → Run Protocols: copies pack
- Pack Installer → Claude Code: installs guidance
- Product Owner → Slice Orchestrator: scopes slice
- Slice Orchestrator → Claude Code: invokes
- Claude Code → Specialist Roles: dispatches roles
- Project Context → Specialist Roles: informs work
- Specialist Roles → Agent Handoffs: hands off
- Specialist Roles → Stage Artefacts: produces
- Discovery & Scope → Product & UX: hands off
- Product & UX → Architecture & Design: hands off
- Architecture & Design → Build & Data: hands off
- Build & Data → QA & Security: hands off
- QA & Security → Release Gates: submits evidence
- Release Gates → Release & Deploy: authorizes
- Product Owner → Human Approvals: approves actions
- Human Approvals → Release & Deploy: gates action
- Release & Deploy → Production Learning: continues record
- Write Scope Guard → Claude Code: checks writes
- Budget Guard → Run Records: reads state
- Usage Measurement → Claude Code: reads logs
- Usage Measurement → Run Records: associates runs
- Cost Analytics → Run Records: reads traces
- Cost Analytics → Run Records: writes reports
- Code Quality Report → Claude Code: analyzes product code
- Conformity Export → Run Records: reads approvals
- Conformity Export → Run Records: writes export
- Approval Verification → Run Records: reads claims
- Approval Verification → GitHub: checks records
- Approval Verification → Run Records: writes results
- Telemetry Probe → Claude Code: receives telemetry