Context Architecture: DAG-Based Progressive Disclosure

Core Principle

Agents should only read what they need. Documents are organized as a directed acyclic graph (DAG) where index files act as hub nodes. An agent reads the index, identifies relevant edges, and follows only those to leaf documents. No agent ever loads the full tree.

The 4-Tier Information Flow

refs/ (what IS)  -->  kits/ (what MUST BE)  -->  plans/ (HOW)  -->  impl/ (what WAS DONE)
     Tier 1                  Tier 2                     Tier 3              Tier 4

Each tier consumes the previous tier's output. Cross-references between tiers create the DAG edges that agents traverse.