# gpatwa/agentic-sdlc-playbook architecture

> Architecture diagram of the GitHub repository gpatwa/agentic-sdlc-playbook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gpatwa/agentic-sdlc-playbook
- Repository: https://github.com/gpatwa/agentic-sdlc-playbook

## Overview

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`](https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/agents) (Specialist Roles), [`execution/install.mjs`](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/install.mjs) (Pack Installer), [`execution/verify-approvals.mjs`](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/verify-approvals.mjs) (Approval Verification), [`agents/release-manager.md`](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/release-manager.md) (Release & Deploy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Project Setup"]
  node_packs["Project Packs"]
  node_context["Project Context<br/>[.agentic]"]
end

subgraph group_lifecycle["Slice Lifecycle"]
  node_orchestrator["Slice Orchestrator<br/>[orchestrator.md]"]
  node_roles["Specialist Roles"]
  node_discovery["Discovery &amp; Scope"]
  node_product["Product &amp; UX<br/>[product-manager.md]"]
  node_architecture["Architecture &amp; Design"]
  node_implementation["Build &amp; Data"]
  node_assurance["QA &amp; Security<br/>[qa-evidence.md]"]
  node_gates["Release Gates<br/>[RELEASE_GATES.md]"]
  node_approval["Human Approvals"]
  node_release["Release &amp; Deploy<br/>[release-manager.md]"]
  node_production["Production Learning"]
  node_artefacts["Stage Artefacts"]
  node_handoff["Agent Handoffs"]
end

subgraph group_runtime["Execution Runtime"]
  node_installer["Pack Installer<br/>[install.mjs]"]
  node_protocols["Run Protocols"]
  node_scopeguard["Write Scope Guard"]
  node_budgetguard["Budget Guard<br/>[budget-guard.mjs]"]
end

subgraph group_evidence["Run Evidence"]
  node_usage["Usage Measurement<br/>[usage.mjs]"]
  node_analytics["Cost Analytics<br/>[analyze.mjs]"]
  node_quality["Code Quality Report<br/>[quality.mjs]"]
  node_conformity["Conformity Export<br/>[conformity.mjs]"]
  node_verify["Approval Verification"]
  node_telemetry["Telemetry Probe<br/>[otlp-probe.mjs]"]
  node_runrecords[("Run Records")]
end

node_human(("Product Owner"))
node_claude["Claude Code"]
node_github["GitHub"]

node_human -->|"selects archetype"| node_packs
node_human -->|"defines project"| node_context
node_installer -->|"reads briefs"| node_roles
node_installer -->|"copies pack"| node_protocols
node_installer -->|"installs guidance"| node_claude
node_human -->|"scopes slice"| node_orchestrator
node_orchestrator -->|"invokes"| node_claude
node_claude -->|"dispatches roles"| node_roles
node_context -->|"informs work"| node_roles
node_roles -->|"hands off"| node_handoff
node_roles -->|"produces"| node_artefacts
node_discovery -->|"hands off"| node_product
node_product -->|"hands off"| node_architecture
node_architecture -->|"hands off"| node_implementation
node_implementation -->|"hands off"| node_assurance
node_assurance -->|"submits evidence"| node_gates
node_gates -->|"authorizes"| node_release
node_human -->|"approves actions"| node_approval
node_approval -->|"gates action"| node_release
node_release -->|"continues record"| node_production
node_scopeguard -->|"checks writes"| node_claude
node_budgetguard -->|"reads state"| node_runrecords
node_usage -->|"reads logs"| node_claude
node_usage -->|"associates runs"| node_runrecords
node_analytics -->|"reads traces"| node_runrecords
node_analytics -->|"writes reports"| node_runrecords
node_quality -->|"analyzes product code"| node_claude
node_conformity -->|"reads approvals"| node_runrecords
node_conformity -->|"writes export"| node_runrecords
node_verify -->|"reads claims"| node_runrecords
node_verify -->|"checks records"| node_github
node_verify -->|"writes results"| node_runrecords
node_telemetry -.->|"receives telemetry"| node_claude

click node_packs "https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/project-packs"
click node_context "https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/examples/saved-items-bulk-delete/.agentic"
click node_installer "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/install.mjs"
click node_orchestrator "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/prompts/orchestrator.md"
click node_roles "https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/agents"
click node_discovery "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/market-researcher.md"
click node_product "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/product-manager.md"
click node_architecture "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/software-architect.md"
click node_implementation "https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/agents"
click node_assurance "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/qa-evidence.md"
click node_gates "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/docs/RELEASE_GATES.md"
click node_approval "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/docs/HUMAN_APPROVAL_RULES.md"
click node_release "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/release-manager.md"
click node_production "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/post-launch-learning.md"
click node_artefacts "https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/templates"
click node_handoff "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/templates/AGENT_HANDOFF_TEMPLATE.md"
click node_protocols "https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/execution/pack/protocols"
click node_scopeguard "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/hooks/write-scope-guard.mjs"
click node_budgetguard "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/hooks/budget-guard.mjs"
click node_usage "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/usage.mjs"
click node_analytics "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/analyze.mjs"
click node_quality "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/quality.mjs"
click node_conformity "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/conformity.mjs"
click node_verify "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/verify-approvals.mjs"
click node_telemetry "https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/otlp-probe.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_packs,node_context toneBlue
class node_orchestrator,node_roles,node_discovery,node_product,node_architecture,node_implementation,node_assurance,node_gates,node_approval,node_release,node_production,node_artefacts,node_handoff toneAmber
class node_installer,node_protocols,node_scopeguard,node_budgetguard toneMint
class node_usage,node_analytics,node_quality,node_conformity,node_verify,node_telemetry,node_runrecords toneRose
class node_human,node_claude,node_github toneIndigo
```

## Components

### Project Setup

- [Project Packs](https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/project-packs): `project-packs`
- [Project Context](https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/examples/saved-items-bulk-delete/.agentic): `examples/saved-items-bulk-delete/.agentic`

### Slice Lifecycle

- [Slice Orchestrator](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/prompts/orchestrator.md): `prompts/orchestrator.md`
- [Specialist Roles](https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/agents): `agents`
- [Discovery & Scope](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/market-researcher.md): `agents/market-researcher.md`
- [Product & UX](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/product-manager.md): `agents/product-manager.md`
- [Architecture & Design](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/software-architect.md): `agents/software-architect.md`
- [Build & Data](https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/agents): `agents`
- [QA & Security](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/qa-evidence.md): `agents/qa-evidence.md`
- [Release Gates](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/docs/RELEASE_GATES.md): `docs/RELEASE_GATES.md`
- [Human Approvals](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/docs/HUMAN_APPROVAL_RULES.md): `docs/HUMAN_APPROVAL_RULES.md`
- [Release & Deploy](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/release-manager.md): `agents/release-manager.md`
- [Production Learning](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/agents/post-launch-learning.md): `agents/post-launch-learning.md`
- [Stage Artefacts](https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/templates): `templates`
- [Agent Handoffs](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/templates/AGENT_HANDOFF_TEMPLATE.md): `templates/AGENT_HANDOFF_TEMPLATE.md`

### Execution Runtime

- [Pack Installer](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/install.mjs): `execution/install.mjs`
- [Run Protocols](https://github.com/gpatwa/agentic-sdlc-playbook/tree/main/execution/pack/protocols): `execution/pack/protocols`
- [Write Scope Guard](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/hooks/write-scope-guard.mjs): `execution/hooks/write-scope-guard.mjs`
- [Budget Guard](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/hooks/budget-guard.mjs): `execution/hooks/budget-guard.mjs`

### Run Evidence

- [Usage Measurement](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/usage.mjs): `execution/usage.mjs`
- [Cost Analytics](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/analyze.mjs): `execution/analyze.mjs`
- [Code Quality Report](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/quality.mjs): `execution/quality.mjs`
- [Conformity Export](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/conformity.mjs): `execution/conformity.mjs`
- [Approval Verification](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/verify-approvals.mjs): `execution/verify-approvals.mjs`
- [Telemetry Probe](https://github.com/gpatwa/agentic-sdlc-playbook/blob/main/execution/otlp-probe.mjs): `execution/otlp-probe.mjs`
- **Run Records**

### Other components

- **Product Owner**
- **Claude Code**
- **GitHub**

## Connections

- 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