# tt-a1i/simplify-codebase architecture

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

- Interactive diagram: https://gitdiagram.com/tt-a1i/simplify-codebase
- Repository: https://github.com/tt-a1i/simplify-codebase

## Overview

Simplify Codebase is an Agent Skill for evidence-based codebase audits and authorized simplification, with an optional interactive Cleanup Map report. Its principal workflow investigates consumers and boundaries, records evidence and decisions, then makes and verifies a scoped change. The visualization path compiles cleanup-map data into an Architecture diagram and adds cleanup-specific interaction. Source excerpts are incomplete, so implementation links are limited to documented relationships and visible imports.

Main entry points: [`visualization/archify-core/renderers/architecture/render-architecture.mjs`](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/architecture/render-architecture.mjs) (Architecture Renderer), [`SKILL.md`](https://github.com/tt-a1i/simplify-codebase/blob/main/SKILL.md) (Simplify Skill), [`visualization/archify-core/renderers/shared/cli.mjs`](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/cli.mjs) (Diagram I/O), [`visualization/archify-core/renderers/shared/utils.mjs`](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/utils.mjs) (SVG Utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skill["Skill workflow"]
  node_skill["Simplify Skill<br/>[SKILL.md]"]
end

subgraph group_guidance["Investigation guidance"]
  node_investigate["Investigation<br/>[investigation.md]"]
  node_boundaries["Boundaries &amp; Lifecycle"]
  node_execution["Execution &amp; Recovery"]
  node_decisions["Decision Records"]
  node_integration["Finding Integration"]
  node_visualguidance["Visual Reporting"]
end

subgraph group_visual["Cleanup Map"]
  node_mapdata["Cleanup Map Input"]
  node_compiler["Map Compiler"]
  node_extension["Cleanup Interaction"]
end

subgraph group_render["Renderer internals"]
  node_renderer["Architecture Renderer"]
  node_grid["Grid Placement<br/>[grid.mjs]"]
  node_cli["Diagram I/O<br/>[cli.mjs]"]
  node_validator["Input Validation<br/>[validator.mjs]"]
  node_diagnostics["Diagnostics<br/>[diagnostics.mjs]"]
  node_geometry["Geometry &amp; Routing<br/>[geometry.mjs]"]
  node_readability["Desktop Readability"]
  node_layoutreport["Layout Reporting<br/>[layout-report.mjs]"]
  node_textfit["Text Fitting<br/>[text-fit.mjs]"]
  node_utils["SVG Utilities<br/>[utils.mjs]"]
  node_i18n["Localization<br/>[i18n.mjs]"]
end

node_user(("Engineer"))

node_user -->|"requests audit"| node_skill
node_skill -->|"investigates code"| node_investigate
node_investigate -->|"checks consumers"| node_boundaries
node_skill -->|"records evidence"| node_decisions
node_skill -->|"guides changes"| node_execution
node_execution -->|"respects ownership"| node_boundaries
node_skill -->|"merges findings"| node_integration
node_skill -->|"offers optional report"| node_visualguidance
node_visualguidance -->|"defines map contract"| node_mapdata
node_mapdata -.->|"provides input"| node_compiler
node_compiler -->|"compiles for"| node_renderer
node_renderer -->|"supports interaction"| node_extension
node_renderer -->|"resolves placement"| node_grid
node_renderer -->|"loads and writes"| node_cli
node_cli -->|"validates input"| node_validator
node_cli -->|"installs boundary"| node_diagnostics
node_renderer -->|"routes connections"| node_geometry
node_renderer -->|"sets text minimum"| node_readability
node_renderer -.->|"uses layout data"| node_layoutreport
node_renderer -.->|"fits node labels"| node_textfit
node_renderer -->|"renders SVG helpers"| node_utils
node_renderer -.->|"localizes output"| node_i18n
node_cli -->|"applies template"| node_utils
node_cli -->|"resolves locale"| node_i18n
node_validator -->|"raises errors"| node_diagnostics
node_geometry -->|"records issues"| node_diagnostics
node_utils -->|"uses translations"| node_i18n
node_textfit -->|"measures text"| node_utils

click node_skill "https://github.com/tt-a1i/simplify-codebase/blob/main/SKILL.md"
click node_investigate "https://github.com/tt-a1i/simplify-codebase/blob/main/references/investigation.md"
click node_boundaries "https://github.com/tt-a1i/simplify-codebase/blob/main/references/boundaries-and-lifecycle.md"
click node_execution "https://github.com/tt-a1i/simplify-codebase/blob/main/references/execution-and-recovery.md"
click node_decisions "https://github.com/tt-a1i/simplify-codebase/blob/main/references/decision-records.md"
click node_integration "https://github.com/tt-a1i/simplify-codebase/blob/main/references/integrating-findings.md"
click node_visualguidance "https://github.com/tt-a1i/simplify-codebase/blob/main/references/visual-reporting.md"
click node_mapdata "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/cleanup-map.schema.json"
click node_compiler "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/render-cleanup-map.mjs"
click node_extension "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/cleanup-extension.js"
click node_renderer "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/architecture/render-architecture.mjs"
click node_grid "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/architecture/grid.mjs"
click node_cli "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/cli.mjs"
click node_validator "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/validator.mjs"
click node_diagnostics "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/diagnostics.mjs"
click node_geometry "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/geometry.mjs"
click node_readability "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/desktop-readability.mjs"
click node_layoutreport "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/layout-report.mjs"
click node_textfit "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/text-fit.mjs"
click node_utils "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/utils.mjs"
click node_i18n "https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/i18n.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_skill toneBlue
class node_investigate,node_boundaries,node_execution,node_decisions,node_integration,node_visualguidance toneAmber
class node_mapdata,node_compiler,node_extension toneMint
class node_renderer,node_grid,node_cli,node_validator,node_diagnostics,node_geometry,node_readability,node_layoutreport,node_textfit,node_utils,node_i18n toneRose
class node_user toneIndigo
```

## Components

### Skill workflow

- [Simplify Skill](https://github.com/tt-a1i/simplify-codebase/blob/main/SKILL.md): `SKILL.md`

### Investigation guidance

- [Investigation](https://github.com/tt-a1i/simplify-codebase/blob/main/references/investigation.md): `references/investigation.md`
- [Boundaries & Lifecycle](https://github.com/tt-a1i/simplify-codebase/blob/main/references/boundaries-and-lifecycle.md): `references/boundaries-and-lifecycle.md`
- [Execution & Recovery](https://github.com/tt-a1i/simplify-codebase/blob/main/references/execution-and-recovery.md): `references/execution-and-recovery.md`
- [Decision Records](https://github.com/tt-a1i/simplify-codebase/blob/main/references/decision-records.md): `references/decision-records.md`
- [Finding Integration](https://github.com/tt-a1i/simplify-codebase/blob/main/references/integrating-findings.md): `references/integrating-findings.md`
- [Visual Reporting](https://github.com/tt-a1i/simplify-codebase/blob/main/references/visual-reporting.md): `references/visual-reporting.md`

### Cleanup Map

- [Cleanup Map Input](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/cleanup-map.schema.json): `visualization/cleanup-map.schema.json`
- [Map Compiler](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/render-cleanup-map.mjs): `visualization/render-cleanup-map.mjs`
- [Cleanup Interaction](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/cleanup-extension.js): `visualization/cleanup-extension.js`

### Renderer internals

- [Architecture Renderer](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/architecture/render-architecture.mjs): `visualization/archify-core/renderers/architecture/render-architecture.mjs`
- [Grid Placement](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/architecture/grid.mjs): `visualization/archify-core/renderers/architecture/grid.mjs`
- [Diagram I/O](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/cli.mjs): `visualization/archify-core/renderers/shared/cli.mjs`
- [Input Validation](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/validator.mjs): `visualization/archify-core/renderers/shared/validator.mjs`
- [Diagnostics](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/diagnostics.mjs): `visualization/archify-core/renderers/shared/diagnostics.mjs`
- [Geometry & Routing](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/geometry.mjs): `visualization/archify-core/renderers/shared/geometry.mjs`
- [Desktop Readability](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/desktop-readability.mjs): `visualization/archify-core/renderers/shared/desktop-readability.mjs`
- [Layout Reporting](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/layout-report.mjs): `visualization/archify-core/renderers/shared/layout-report.mjs`
- [Text Fitting](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/text-fit.mjs): `visualization/archify-core/renderers/shared/text-fit.mjs`
- [SVG Utilities](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/utils.mjs): `visualization/archify-core/renderers/shared/utils.mjs`
- [Localization](https://github.com/tt-a1i/simplify-codebase/blob/main/visualization/archify-core/renderers/shared/i18n.mjs): `visualization/archify-core/renderers/shared/i18n.mjs`

### Other components

- **Engineer**

## Connections

- Engineer → Simplify Skill: requests audit (evidence: `README.md`)
- Simplify Skill → Investigation: investigates code (evidence: `README.md`)
- Investigation → Boundaries & Lifecycle: checks consumers (evidence: `README.md`)
- Simplify Skill → Decision Records: records evidence (evidence: `README.md`)
- Simplify Skill → Execution & Recovery: guides changes (evidence: `README.md`)
- Execution & Recovery → Boundaries & Lifecycle: respects ownership (evidence: `README.md`)
- Simplify Skill → Finding Integration: merges findings (evidence: `README.md`)
- Simplify Skill → Visual Reporting: offers optional report (evidence: `README.md`)
- Visual Reporting → Cleanup Map Input: defines map contract (evidence: `README.md`)
- Cleanup Map Input → Map Compiler: provides input
- Map Compiler → Architecture Renderer: compiles for (evidence: `README.md`)
- Architecture Renderer → Cleanup Interaction: supports interaction (evidence: `README.md`)
- Architecture Renderer → Grid Placement: resolves placement (evidence: `visualization/archify-core/renderers/architecture/render-architecture.mjs`)
- Architecture Renderer → Diagram I/O: loads and writes (evidence: `visualization/archify-core/renderers/architecture/render-architecture.mjs`)
- Diagram I/O → Input Validation: validates input (evidence: `visualization/archify-core/renderers/shared/cli.mjs`)
- Diagram I/O → Diagnostics: installs boundary (evidence: `visualization/archify-core/renderers/shared/cli.mjs`)
- Architecture Renderer → Geometry & Routing: routes connections (evidence: `visualization/archify-core/renderers/architecture/render-architecture.mjs`)
- Architecture Renderer → Desktop Readability: sets text minimum (evidence: `visualization/archify-core/renderers/architecture/render-architecture.mjs`)
- Architecture Renderer → Layout Reporting: uses layout data (evidence: `visualization/archify-core/renderers/architecture/render-architecture.mjs`)
- Architecture Renderer → Text Fitting: fits node labels (evidence: `visualization/archify-core/renderers/architecture/render-architecture.mjs`)
- Architecture Renderer → SVG Utilities: renders SVG helpers (evidence: `visualization/archify-core/renderers/architecture/render-architecture.mjs`)
- Architecture Renderer → Localization: localizes output (evidence: `visualization/archify-core/renderers/architecture/render-architecture.mjs`)
- Diagram I/O → SVG Utilities: applies template (evidence: `visualization/archify-core/renderers/shared/cli.mjs`)
- Diagram I/O → Localization: resolves locale (evidence: `visualization/archify-core/renderers/shared/cli.mjs`)
- Input Validation → Diagnostics: raises errors (evidence: `visualization/archify-core/renderers/shared/validator.mjs`)
- Geometry & Routing → Diagnostics: records issues (evidence: `visualization/archify-core/renderers/shared/geometry.mjs`)
- SVG Utilities → Localization: uses translations (evidence: `visualization/archify-core/renderers/shared/utils.mjs`)
- Text Fitting → SVG Utilities: measures text (evidence: `visualization/archify-core/renderers/shared/text-fit.mjs`)