# shubhamtaywade82/agentic-sdlc-kit architecture

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

- Interactive diagram: https://gitdiagram.com/shubhamtaywade82/agentic-sdlc-kit
- Repository: https://github.com/shubhamtaywade82/agentic-sdlc-kit

## Overview

Agentic SDLC Kit is a runtime-independent workflow engine and CLI for taking engineering work from repository discovery and requirements through planning, implementation, verification, and reporting. Its documented capabilities also include greenfield scaffolding, project memory and self-evolution, installation, and Claude Code runtime plugins. The README documents the product-level flows; sampled source confirms repository scanning and workflow state transitions. Plugin internals and most CLI command implementations were not sampled, so their detailed wiring is not inferred.

Main entry points: [`packages/cli/src/application/dispatcher.ts`](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/cli/src/application/dispatcher.ts) (Kit CLI), [`packages/core/src/workflows/engine.ts`](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/workflows/engine.ts) (Workflow engine), [`packages/cli/src/commands/install.ts`](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/cli/src/commands/install.ts) (Plugin installation), [`packages/claude-code-adapter/src/events/translator.ts`](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/claude-code-adapter/src/events/translator.ts) (Claude Code adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflows"]
  node_cli["Kit CLI<br/>[dispatcher.ts]"]
end

subgraph group_engine["Core engineering"]
  node_discovery["Repository discovery"]
  node_profile["Project profile<br/>[generator.ts]"]
  node_spec["Specification<br/>[parser.ts]"]
  node_planning["Implementation planning<br/>[dag.ts]"]
  node_workflow["Workflow engine<br/>[engine.ts]"]
  node_tdd["TDD cycle<br/>[cycle.ts]"]
  node_verification["Deterministic verification<br/>[runner.ts]"]
  node_artifacts["Execution artifacts<br/>[writer.ts]"]
  node_scaffold["Application scaffolding<br/>[generator.ts]"]
end

subgraph group_learning["Learning and memory"]
  node_memory[("Engineering memory<br/>[memory-store.ts]")]
  node_evolution["Learning and evolution<br/>[evolution-lab.ts]"]
end

subgraph group_runtime["Runtime extensions"]
  node_installer["Plugin installation<br/>[install.ts]"]
  node_adapter["Claude Code adapter<br/>[translator.ts]"]
  node_approval["Approval gate<br/>[approval-gate.ts]"]
  node_guard["SDLC guard<br/>[register.ts]"]
  node_router["Model router<br/>[register.ts]"]
  node_observer["Run observer<br/>[register.ts]"]
end

node_engineer(("Engineer"))

node_engineer -->|"runs commands"| node_cli
node_cli -->|"inspects repository"| node_discovery
node_cli -->|"initializes project"| node_profile
node_cli -->|"validates specification"| node_spec
node_cli -->|"validates plan"| node_planning
node_cli -->|"executes workflows"| node_workflow
node_workflow -->|"runs cycles"| node_tdd
node_workflow -->|"runs verification"| node_verification
node_workflow -->|"produces report"| node_artifacts
node_cli -->|"creates application"| node_scaffold
node_cli -->|"queries memory"| node_memory
node_cli -->|"runs evolution"| node_evolution
node_cli -->|"installs plugins"| node_installer
node_adapter -.->|"approval boundary"| node_approval
node_installer -.->|"installs runtime mod"| node_guard
node_installer -.->|"installs runtime mod"| node_router
node_installer -.->|"installs runtime mod"| node_observer

click node_cli "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/cli/src/application/dispatcher.ts"
click node_discovery "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/discovery/repository-scanner.ts"
click node_profile "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/project-profile/generator.ts"
click node_spec "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/specification/parser.ts"
click node_planning "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/planning/dag.ts"
click node_workflow "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/workflows/engine.ts"
click node_tdd "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/tdd/cycle.ts"
click node_verification "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/verification/runner.ts"
click node_artifacts "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/artifacts/writer.ts"
click node_scaffold "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/scaffolding/generator.ts"
click node_memory "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/learning/memory-store.ts"
click node_evolution "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/learning/evolution-lab.ts"
click node_installer "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/cli/src/commands/install.ts"
click node_adapter "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/claude-code-adapter/src/events/translator.ts"
click node_approval "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/claude-code-adapter/src/middleware/approval-gate.ts"
click node_guard "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/plugins/sdlc-guard/hooks/register.ts"
click node_router "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/plugins/model-router/hooks/register.ts"
click node_observer "https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/plugins/run-observer/hooks/register.ts"

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_cli toneBlue
class node_discovery,node_profile,node_spec,node_planning,node_workflow,node_tdd,node_verification,node_artifacts,node_scaffold toneAmber
class node_memory,node_evolution toneMint
class node_installer,node_adapter,node_approval,node_guard,node_router,node_observer toneRose
class node_engineer toneIndigo
```

## Components

### CLI workflows

- [Kit CLI](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/cli/src/application/dispatcher.ts): `packages/cli/src/application/dispatcher.ts`

### Core engineering

- [Repository discovery](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/discovery/repository-scanner.ts): `packages/core/src/discovery/repository-scanner.ts`
- [Project profile](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/project-profile/generator.ts): `packages/core/src/project-profile/generator.ts`
- [Specification](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/specification/parser.ts): `packages/core/src/specification/parser.ts`
- [Implementation planning](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/planning/dag.ts): `packages/core/src/planning/dag.ts`
- [Workflow engine](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/workflows/engine.ts): `packages/core/src/workflows/engine.ts`
- [TDD cycle](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/tdd/cycle.ts): `packages/core/src/tdd/cycle.ts`
- [Deterministic verification](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/verification/runner.ts): `packages/core/src/verification/runner.ts`
- [Execution artifacts](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/artifacts/writer.ts): `packages/core/src/artifacts/writer.ts`
- [Application scaffolding](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/scaffolding/generator.ts): `packages/core/src/scaffolding/generator.ts`

### Learning and memory

- [Engineering memory](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/learning/memory-store.ts): `packages/core/src/learning/memory-store.ts`
- [Learning and evolution](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/core/src/learning/evolution-lab.ts): `packages/core/src/learning/evolution-lab.ts`

### Runtime extensions

- [Plugin installation](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/cli/src/commands/install.ts): `packages/cli/src/commands/install.ts`
- [Claude Code adapter](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/claude-code-adapter/src/events/translator.ts): `packages/claude-code-adapter/src/events/translator.ts`
- [Approval gate](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/packages/claude-code-adapter/src/middleware/approval-gate.ts): `packages/claude-code-adapter/src/middleware/approval-gate.ts`
- [SDLC guard](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/plugins/sdlc-guard/hooks/register.ts): `plugins/sdlc-guard/hooks/register.ts`
- [Model router](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/plugins/model-router/hooks/register.ts): `plugins/model-router/hooks/register.ts`
- [Run observer](https://github.com/shubhamtaywade82/agentic-sdlc-kit/blob/main/plugins/run-observer/hooks/register.ts): `plugins/run-observer/hooks/register.ts`

### Other components

- **Engineer**

## Connections

- Engineer → Kit CLI: runs commands (evidence: `README.md`)
- Kit CLI → Repository discovery: inspects repository (evidence: `README.md`)
- Kit CLI → Project profile: initializes project (evidence: `README.md`)
- Kit CLI → Specification: validates specification (evidence: `README.md`)
- Kit CLI → Implementation planning: validates plan (evidence: `README.md`)
- Kit CLI → Workflow engine: executes workflows (evidence: `README.md`)
- Workflow engine → TDD cycle: runs cycles (evidence: `README.md`)
- Workflow engine → Deterministic verification: runs verification (evidence: `README.md`)
- Workflow engine → Execution artifacts: produces report (evidence: `README.md`)
- Kit CLI → Application scaffolding: creates application (evidence: `README.md`)
- Kit CLI → Engineering memory: queries memory (evidence: `README.md`)
- Kit CLI → Learning and evolution: runs evolution (evidence: `README.md`)
- Kit CLI → Plugin installation: installs plugins (evidence: `README.md`)
- Claude Code adapter → Approval gate: approval boundary
- Plugin installation → SDLC guard: installs runtime mod (evidence: `README.md`)
- Plugin installation → Model router: installs runtime mod (evidence: `README.md`)
- Plugin installation → Run observer: installs runtime mod (evidence: `README.md`)
