# inkblotapps/ai-sdlc architecture

> Architecture diagram of the GitHub repository inkblotapps/ai-sdlc, 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/inkblotapps/ai-sdlc
- Repository: https://github.com/inkblotapps/ai-sdlc

## Overview

This repository is a research and architecture site, not an implementation of the proposed governance platform. The graph summarizes the documented product-family design and its governance loop; the available source excerpt supports those conceptual relationships, not runtime calls. The reader workflow is through the published HTML site, with research preserved in Markdown.

Main entry points: [`docs/02-product-family.md`](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md) (BaseCoat), [`site/index.html`](https://github.com/inkblotapps/ai-sdlc/blob/main/site/index.html) (Published site), [`site/app.js`](https://github.com/inkblotapps/ai-sdlc/blob/main/site/app.js) (Site search), [`docs/README.md`](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/README.md) (Research docs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shared["Shared contracts"]
  node_binder["Binder"]
end

subgraph group_engineering["Engineering governance"]
  node_basecoat["BaseCoat"]
  node_stencil["Stencil"]
  node_sheen["Sheen"]
end

subgraph group_discovery["Inventory and discovery"]
  node_swatch[("Swatch")]
  node_snitch["Snitch"]
  node_teardown["Teardown"]
end

subgraph group_assurance["Validation and response"]
  node_adhesion["Adhesion"]
  node_proof[("Proof")]
  node_crosslink["Crosslink"]
end

node_organization(("Organization"))
node_site["Published site<br/>[index.html]"]
node_search["Site search<br/>[app.js]"]
node_research["Research docs<br/>[README.md]"]

node_organization -->|"sets intent"| node_basecoat
node_basecoat -->|"targets policy"| node_stencil
node_basecoat -->|"requests context"| node_swatch
node_swatch -->|"returns context"| node_basecoat
node_snitch -->|"feeds observations"| node_swatch
node_teardown -->|"enriches records"| node_swatch
node_adhesion -->|"records validation"| node_proof
node_crosslink -->|"coordinates response"| node_organization
node_binder -->|"defines contracts"| node_basecoat
node_binder -->|"defines contracts"| node_swatch
node_binder -->|"defines contracts"| node_proof
node_organization -->|"reads research"| node_site
node_site -->|"uses index"| node_search
node_site -->|"links to"| node_research

click node_basecoat "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_stencil "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_sheen "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/11-sheen-consistency.md"
click node_swatch "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_snitch "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_teardown "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_adhesion "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_proof "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_crosslink "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_binder "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md"
click node_site "https://github.com/inkblotapps/ai-sdlc/blob/main/site/index.html"
click node_search "https://github.com/inkblotapps/ai-sdlc/blob/main/site/app.js"
click node_research "https://github.com/inkblotapps/ai-sdlc/blob/main/docs/README.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_binder toneBlue
class node_basecoat,node_stencil,node_sheen toneAmber
class node_swatch,node_snitch,node_teardown toneMint
class node_adhesion,node_proof,node_crosslink toneRose
class node_organization toneIndigo
class node_site,node_search,node_research toneTeal
```

## Components

### Shared contracts

- [Binder](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`

### Engineering governance

- [BaseCoat](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`
- [Stencil](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`
- [Sheen](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/11-sheen-consistency.md): `docs/11-sheen-consistency.md`

### Inventory and discovery

- [Swatch](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`
- [Snitch](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`
- [Teardown](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`

### Validation and response

- [Adhesion](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`
- [Proof](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`
- [Crosslink](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/02-product-family.md): `docs/02-product-family.md`

### Other components

- **Organization**
- [Published site](https://github.com/inkblotapps/ai-sdlc/blob/main/site/index.html): `site/index.html`
- [Site search](https://github.com/inkblotapps/ai-sdlc/blob/main/site/app.js): `site/app.js`
- [Research docs](https://github.com/inkblotapps/ai-sdlc/blob/main/docs/README.md): `docs/README.md`

## Connections

- Organization → BaseCoat: sets intent
- BaseCoat → Stencil: targets policy
- BaseCoat → Swatch: requests context
- Swatch → BaseCoat: returns context
- Snitch → Swatch: feeds observations
- Teardown → Swatch: enriches records
- Adhesion → Proof: records validation
- Crosslink → Organization: coordinates response
- Binder → BaseCoat: defines contracts
- Binder → Swatch: defines contracts
- Binder → Proof: defines contracts
- Organization → Published site: reads research
- Published site → Site search: uses index
- Published site → Research docs: links to