How tt-a1i/simplify-codebase works
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: render-architecture.mjs Architecture Renderer · SKILL.md Simplify Skill · cli.mjs Diagram I/O · utils.mjs SVG Utilities
Components 22
Skill workflow
- Simplify Skill
SKILL.md
Investigation guidance
- Investigation
references/investigation.md - Boundaries & Lifecycle
references/boundaries-and-lifecycle.md - Execution & Recovery
references/execution-and-recovery.md - Decision Records
references/decision-records.md - Finding Integration
references/integrating-findings.md - Visual Reporting
references/visual-reporting.md
Cleanup Map
- Cleanup Map Input
visualization/cleanup-map.schema.json - Map Compiler
visualization/render-cleanup-map.mjs - Cleanup Interaction
visualization/cleanup-extension.js
Renderer internals
- Architecture Renderer
visualization/archify-core/renderers/architecture/render-architecture.mjs - Grid Placement
visualization/archify-core/renderers/architecture/grid.mjs - Diagram I/O
visualization/archify-core/renderers/shared/cli.mjs - Input Validation
visualization/archify-core/renderers/shared/validator.mjs - Diagnostics
visualization/archify-core/renderers/shared/diagnostics.mjs - Geometry & Routing
visualization/archify-core/renderers/shared/geometry.mjs - Desktop Readability
visualization/archify-core/renderers/shared/desktop-readability.mjs - Layout Reporting
visualization/archify-core/renderers/shared/layout-report.mjs - Text Fitting
visualization/archify-core/renderers/shared/text-fit.mjs - SVG Utilities
visualization/archify-core/renderers/shared/utils.mjs - Localization
visualization/archify-core/renderers/shared/i18n.mjs
Other components
- Engineer
Connections 28
- Engineer → Simplify Skill: requests audit
README.md - Simplify Skill → Investigation: investigates code
README.md - Investigation → Boundaries & Lifecycle: checks consumers
README.md - Simplify Skill → Decision Records: records evidence
README.md - Simplify Skill → Execution & Recovery: guides changes
README.md - Execution & Recovery → Boundaries & Lifecycle: respects ownership
README.md - Simplify Skill → Finding Integration: merges findings
README.md - Simplify Skill → Visual Reporting: offers optional report
README.md - Visual Reporting → Cleanup Map Input: defines map contract
README.md - Cleanup Map Input → Map Compiler: provides input
- Map Compiler → Architecture Renderer: compiles for
README.md - Architecture Renderer → Cleanup Interaction: supports interaction
README.md - Architecture Renderer → Grid Placement: resolves placement
visualization/archify-core/renderers/architecture/render-architecture.mjs - Architecture Renderer → Diagram I/O: loads and writes
visualization/archify-core/renderers/architecture/render-architecture.mjs - Diagram I/O → Input Validation: validates input
visualization/archify-core/renderers/shared/cli.mjs - Diagram I/O → Diagnostics: installs boundary
visualization/archify-core/renderers/shared/cli.mjs - Architecture Renderer → Geometry & Routing: routes connections
visualization/archify-core/renderers/architecture/render-architecture.mjs - Architecture Renderer → Desktop Readability: sets text minimum
visualization/archify-core/renderers/architecture/render-architecture.mjs - Architecture Renderer → Layout Reporting: uses layout data
visualization/archify-core/renderers/architecture/render-architecture.mjs - Architecture Renderer → Text Fitting: fits node labels
visualization/archify-core/renderers/architecture/render-architecture.mjs - Architecture Renderer → SVG Utilities: renders SVG helpers
visualization/archify-core/renderers/architecture/render-architecture.mjs - Architecture Renderer → Localization: localizes output
visualization/archify-core/renderers/architecture/render-architecture.mjs - Diagram I/O → SVG Utilities: applies template
visualization/archify-core/renderers/shared/cli.mjs - Diagram I/O → Localization: resolves locale
visualization/archify-core/renderers/shared/cli.mjs - Input Validation → Diagnostics: raises errors
visualization/archify-core/renderers/shared/validator.mjs - Geometry & Routing → Diagnostics: records issues
visualization/archify-core/renderers/shared/geometry.mjs - SVG Utilities → Localization: uses translations
visualization/archify-core/renderers/shared/utils.mjs - Text Fitting → SVG Utilities: measures text
visualization/archify-core/renderers/shared/text-fit.mjs