# cw-codewalnut/agentic-coding-playbook architecture

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

- Interactive diagram: https://gitdiagram.com/cw-codewalnut/agentic-coding-playbook
- Repository: https://github.com/cw-codewalnut/agentic-coding-playbook

## Overview

This repository is a practical agentic-coding playbook, not an executable application. Its primary workflow guides an engineer through the default playbook, then directs them to a project-specific variant and reusable resources. The README also documents templates and team conventions. Source excerpts were unavailable, so the graph reflects only README-described reading relationships and capabilities.

Main entry points: [`01-base-guide.md`](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/01-base-guide.md) (Base guide), [`02-greenfield.md`](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/02-greenfield.md) (Greenfield), [`03-brownfield.md`](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/03-brownfield.md) (Brownfield), [`04-refactoring-legacy.md`](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/04-refactoring-legacy.md) (Legacy refactoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Core workflow"]
  node_base["Base guide<br/>[01-base-guide.md]"]
end

subgraph group_variants["Project variants"]
  node_greenfield["Greenfield<br/>[02-greenfield.md]"]
  node_brownfield["Brownfield<br/>[03-brownfield.md]"]
  node_refactoring["Legacy refactoring"]
  node_enterprise["Enterprise work<br/>[05-enterprise.md]"]
end

subgraph group_resources["Resources and conventions"]
  node_resources_guide["Resources guide<br/>[06-resources.md]"]
  node_token_economics["Token economics"]
  node_templates["Stack templates"]
  node_guidelines["Stack guidelines<br/>[.guidelines]"]
  node_agent_instructions["Agent instructions<br/>[AGENTS.md]"]
end

node_engineer(("Engineer"))

node_engineer -->|"reads first"| node_base
node_engineer -->|"selects variant"| node_greenfield
node_engineer -->|"selects variant"| node_brownfield
node_engineer -->|"selects variant"| node_refactoring
node_engineer -->|"selects variant"| node_enterprise
node_base -->|"offers variant"| node_greenfield
node_base -->|"offers variant"| node_brownfield
node_base -->|"offers variant"| node_refactoring
node_base -->|"offers variant"| node_enterprise
node_engineer -->|"consults"| node_resources_guide
node_engineer -->|"consults"| node_token_economics
node_engineer -->|"copies and adapts"| node_templates
node_engineer -->|"adapts conventions"| node_guidelines
node_engineer -->|"consults"| node_agent_instructions

click node_base "https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/01-base-guide.md"
click node_greenfield "https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/02-greenfield.md"
click node_brownfield "https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/03-brownfield.md"
click node_refactoring "https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/04-refactoring-legacy.md"
click node_enterprise "https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/05-enterprise.md"
click node_resources_guide "https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/06-resources.md"
click node_token_economics "https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/07-token-economics.md"
click node_templates "https://github.com/cw-codewalnut/agentic-coding-playbook/tree/main/resources"
click node_guidelines "https://github.com/cw-codewalnut/agentic-coding-playbook/tree/main/resources/.guidelines"
click node_agent_instructions "https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/resources/AGENTS.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_base toneBlue
class node_greenfield,node_brownfield,node_refactoring,node_enterprise toneAmber
class node_resources_guide,node_token_economics,node_templates,node_guidelines,node_agent_instructions toneMint
class node_engineer toneIndigo
```

## Components

### Core workflow

- [Base guide](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/01-base-guide.md): `01-base-guide.md`

### Project variants

- [Greenfield](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/02-greenfield.md): `02-greenfield.md`
- [Brownfield](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/03-brownfield.md): `03-brownfield.md`
- [Legacy refactoring](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/04-refactoring-legacy.md): `04-refactoring-legacy.md`
- [Enterprise work](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/05-enterprise.md): `05-enterprise.md`

### Resources and conventions

- [Resources guide](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/06-resources.md): `06-resources.md`
- [Token economics](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/07-token-economics.md): `07-token-economics.md`
- [Stack templates](https://github.com/cw-codewalnut/agentic-coding-playbook/tree/main/resources): `resources`
- [Stack guidelines](https://github.com/cw-codewalnut/agentic-coding-playbook/tree/main/resources/.guidelines): `resources/.guidelines`
- [Agent instructions](https://github.com/cw-codewalnut/agentic-coding-playbook/blob/main/resources/AGENTS.md): `resources/AGENTS.md`

### Other components

- **Engineer**

## Connections

- Engineer → Base guide: reads first
- Engineer → Greenfield: selects variant
- Engineer → Brownfield: selects variant
- Engineer → Legacy refactoring: selects variant
- Engineer → Enterprise work: selects variant
- Base guide → Greenfield: offers variant
- Base guide → Brownfield: offers variant
- Base guide → Legacy refactoring: offers variant
- Base guide → Enterprise work: offers variant
- Engineer → Resources guide: consults
- Engineer → Token economics: consults
- Engineer → Stack templates: copies and adapts
- Engineer → Stack guidelines: adapts conventions
- Engineer → Agent instructions: consults