# rvbhavsar/ai-native-sdlc-playbook architecture

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

- Interactive diagram: https://gitdiagram.com/rvbhavsar/ai-native-sdlc-playbook
- Repository: https://github.com/rvbhavsar/ai-native-sdlc-playbook

## Overview

AI-Native SDLC Playbook guides human-controlled software work from rough request through approved intent, specification, and implementation planning. Its three stage skills help discover, draft, and structurally evaluate each artifact; human approval gates progression. Planning incorporates repository baselines, dependencies, parallel work, and execution boundaries, but implementation and deployment are downstream and not authorized here. The README establishes the lifecycle and skill capabilities; sampled evaluator scripts confirm structural checks, not how the skills invoke them.

Main entry points: [`skills/plan-readiness/SKILL.md`](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/plan-readiness/SKILL.md) (Plan readiness skill), [`docs/stages/01-intent/intent-template.md`](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/01-intent/intent-template.md) (intent.md), [`docs/stages/02-specification/spec-template.md`](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/02-specification/spec-template.md) (spec.md), [`skills/spec-readiness/SKILL.md`](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/spec-readiness/SKILL.md) (Specification readiness skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Lifecycle stages"]
  node_intent_stage["Intent discovery<br/>[README.md]"]
  node_spec_stage["Specification<br/>[README.md]"]
  node_planning_stage["Execution planning<br/>[README.md]"]
end

subgraph group_skills["Agent skills"]
  node_intent_skill["Intent readiness skill<br/>[SKILL.md]"]
  node_spec_skill["Specification readiness skill<br/>[SKILL.md]"]
  node_plan_skill["Plan readiness skill<br/>[SKILL.md]"]
end

subgraph group_governance["Approval and readiness"]
  node_intent_eval["Intent evaluator<br/>[evaluate_intent.py]"]
  node_spec_eval["Specification evaluator<br/>[evaluate_spec.py]"]
  node_plan_eval["Plan evaluator<br/>[evaluate_plan.py]"]
  node_readiness_guidance["Readiness rubrics and eval guidance"]
end

subgraph group_workspace["Artifacts and planning"]
  node_intent_doc["intent.md<br/>[intent-template.md]"]
  node_spec_doc["spec.md<br/>[spec-template.md]"]
  node_plan_doc["plan.md<br/>[plan-template.md]"]
  node_workspace_example["Starter workspace<br/>[README.md]"]
  node_parallel_guidance["Parallel delivery model"]
end

node_request(("Request or incident"))
node_human(("Human approver"))

node_request -->|"starts discovery"| node_intent_skill
node_intent_stage -->|"guides"| node_intent_skill
node_intent_skill -->|"drafts"| node_intent_doc
node_intent_eval -->|"checks structure"| node_intent_doc
node_intent_doc -->|"requests approval"| node_human
node_human -->|"approves intent"| node_spec_skill
node_spec_stage -->|"guides"| node_spec_skill
node_spec_skill -->|"reads approved input"| node_intent_doc
node_spec_skill -->|"drafts"| node_spec_doc
node_spec_eval -->|"checks structure"| node_spec_doc
node_spec_doc -->|"requests approval"| node_human
node_human -->|"approves specification"| node_plan_skill
node_planning_stage -->|"guides"| node_plan_skill
node_plan_skill -->|"reads approved input"| node_spec_doc
node_plan_skill -->|"drafts"| node_plan_doc
node_plan_eval -->|"checks structure"| node_plan_doc
node_plan_doc -->|"requests approval"| node_human
node_workspace_example -.->|"provides template"| node_intent_doc
node_workspace_example -.->|"provides template"| node_spec_doc
node_workspace_example -.->|"provides template"| node_plan_doc
node_readiness_guidance -->|"informs review"| node_human
node_parallel_guidance -->|"guides decomposition"| node_plan_skill

click node_intent_stage "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/01-intent/README.md"
click node_spec_stage "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/02-specification/README.md"
click node_planning_stage "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/03-planning/README.md"
click node_intent_skill "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/intent-readiness/SKILL.md"
click node_spec_skill "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/spec-readiness/SKILL.md"
click node_plan_skill "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/plan-readiness/SKILL.md"
click node_intent_eval "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/intent-readiness/scripts/evaluate_intent.py"
click node_spec_eval "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/spec-readiness/scripts/evaluate_spec.py"
click node_plan_eval "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/plan-readiness/scripts/evaluate_plan.py"
click node_intent_doc "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/01-intent/intent-template.md"
click node_spec_doc "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/02-specification/spec-template.md"
click node_plan_doc "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/03-planning/plan-template.md"
click node_workspace_example "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/examples/initiative-workspace/README.md"
click node_readiness_guidance "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/governance/evals-and-readiness-gates.md"
click node_parallel_guidance "https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/plan-readiness/references/parallel-execution.md"

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_intent_stage,node_spec_stage,node_planning_stage toneBlue
class node_intent_skill,node_spec_skill,node_plan_skill toneAmber
class node_intent_eval,node_spec_eval,node_plan_eval,node_readiness_guidance,node_request toneMint
class node_intent_doc,node_spec_doc,node_plan_doc,node_workspace_example,node_parallel_guidance toneRose
class node_human toneIndigo
```

## Components

### Lifecycle stages

- [Intent discovery](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/01-intent/README.md): `docs/stages/01-intent/README.md`
- [Specification](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/02-specification/README.md): `docs/stages/02-specification/README.md`
- [Execution planning](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/03-planning/README.md): `docs/stages/03-planning/README.md`

### Agent skills

- [Intent readiness skill](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/intent-readiness/SKILL.md): `skills/intent-readiness/SKILL.md`
- [Specification readiness skill](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/spec-readiness/SKILL.md): `skills/spec-readiness/SKILL.md`
- [Plan readiness skill](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/plan-readiness/SKILL.md): `skills/plan-readiness/SKILL.md`

### Approval and readiness

- [Intent evaluator](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/intent-readiness/scripts/evaluate_intent.py): `skills/intent-readiness/scripts/evaluate_intent.py`
- [Specification evaluator](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/spec-readiness/scripts/evaluate_spec.py): `skills/spec-readiness/scripts/evaluate_spec.py`
- [Plan evaluator](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/plan-readiness/scripts/evaluate_plan.py): `skills/plan-readiness/scripts/evaluate_plan.py`
- [Readiness rubrics and eval guidance](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/governance/evals-and-readiness-gates.md): `docs/governance/evals-and-readiness-gates.md`

### Artifacts and planning

- [intent.md](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/01-intent/intent-template.md): `docs/stages/01-intent/intent-template.md`
- [spec.md](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/02-specification/spec-template.md): `docs/stages/02-specification/spec-template.md`
- [plan.md](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/docs/stages/03-planning/plan-template.md): `docs/stages/03-planning/plan-template.md`
- [Starter workspace](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/examples/initiative-workspace/README.md): `examples/initiative-workspace/README.md`
- [Parallel delivery model](https://github.com/rvbhavsar/ai-native-sdlc-playbook/blob/main/skills/plan-readiness/references/parallel-execution.md): `skills/plan-readiness/references/parallel-execution.md`

### Other components

- **Request or incident**
- **Human approver**

## Connections

- Request or incident → Intent readiness skill: starts discovery
- Intent discovery → Intent readiness skill: guides
- Intent readiness skill → intent.md: drafts
- Intent evaluator → intent.md: checks structure
- intent.md → Human approver: requests approval
- Human approver → Specification readiness skill: approves intent
- Specification → Specification readiness skill: guides
- Specification readiness skill → intent.md: reads approved input
- Specification readiness skill → spec.md: drafts
- Specification evaluator → spec.md: checks structure
- spec.md → Human approver: requests approval
- Human approver → Plan readiness skill: approves specification
- Execution planning → Plan readiness skill: guides
- Plan readiness skill → spec.md: reads approved input
- Plan readiness skill → plan.md: drafts
- Plan evaluator → plan.md: checks structure
- plan.md → Human approver: requests approval
- Starter workspace → intent.md: provides template
- Starter workspace → spec.md: provides template
- Starter workspace → plan.md: provides template
- Readiness rubrics and eval guidance → Human approver: informs review
- Parallel delivery model → Plan readiness skill: guides decomposition