{"repo":"user-hash/LivingDocFramework","free":true,"listed":false,"github":"https://github.com/user-hash/LivingDocFramework","clone":"git clone https://github.com/user-hash/LivingDocFramework.git","description":"A methodology for building well-architected codebases with AI assistance. Principles, conventions, and reference implementation. Proven on a 400k LOC Unity project.","language":"Shell","stars":28,"topics":["code-quality","developer-tools","documentation","git-hooks","software-architecture","static-analysis","roslyn-analyzer","unity"],"license":"AGPL-3.0","category":"dev-tools","readme_excerpt":"LivingDocFramework How to keep a codebase architecturally coherent when AI writes most of the code. We built this while shipping a 400k LOC Unity project with AI assistance. This is what works for us. Any AI tool, any programming language, any team size. How to use this repo: Read the principles below. Tell your AI agent to read them too. Implement what makes sense for your project. The reference implementation (hooks, scripts) is a bonus, not the point. --- The Problem AI produces code faster than anyone can review it. The bottleneck is no longer writing code. It is architectural coherence . Without explicit structure, every AI session introduces boundary violations, magic numbers, and subtle invariant breaks. The codebase drifts. Architecture erodes. Nobody notices until it is expensive. --- Seven Core Ideas Each stands alone. They compound when combined. Full details with examples 1. Hexagonal Architecture (Ports & Adapters) Separate domain logic from infrastructure. Pure domain has zero platform imports. The compiler enforces the boundary, not code review. Lego style block can be easily replaced while keeping architecture the same. 2. Pure Assemblies Group code into modules with explicit dependency rules. Some are pure: zero platform references, compiler-enforced. AI cannot break what the build system protects. 3. Invariant-Driven Development Critical rules written as numbered codes: INV-DSP-003: Voice mutation is audio-thread-only . The AI reads them before writing code.","default_branch":null,"files":null,"tree":[],"storefront":"/r/user-hash","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/user-hash/LivingDocFramework/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}