Claude Code Workflow: Restructuring Large Codebase Docs with 3D Classification
default-username · reddit · 2026-08-14
When integrating Claude Code into a massive legacy codebase (5,000+ files), a developer hit a wall with stale docs and diverging conventions. A single architectural shift overnight transformed his workflow.
The solution requires classifying all information into three strict categories:
- Vertical: End-to-end flows or services with a single doc.md.
- Horizontal: Cross-cutting concepts (e.g., logging, retries) identified by a specific KEY.
- Ubiquitous: Repo-wide rules.
Instead of static files, documentation becomes a searchable network of facts and relationships. Developers can quickly locate concepts via key searches, while Claude can follow verticals or horizontals to dynamically generate context on demand, saving hours of manual tracing.
More from coding & agent
- Building an Agent in 14 Days: Why Your Code Isn't the Real Value — sujingshen · 2026-08-14
- New ComfyUI Timeline Node Enables Precise Control for H3 Video Generation — Mr_Zelash · 2026-08-14
- Singularity in Software: Coding Agents Trigger an Explosion of Bits — paraschopra · 2026-08-14
- GitPow: An Open-Source Cross-Platform Git Client with Image Previews — tom_doerr · 2026-08-14
- Agent Auto-Generates Earnings Reports: Cloudflare Case Shows AI Traffic Inflection — draecomino · 2026-08-14
- Obsidian Embedded Terminal Plugin: Multi-tab Support & Backlink Autocomplete — tom_doerr · 2026-08-14