# Architecture

This directory documents the permission system's internal architecture, informed by [OpenCode's permission model](https://opencode.ai/docs/permissions/).

## Documents

| Document                                   | Purpose                                                                                                |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
| [v3-architecture.md](./v3-architecture.md) | Architecture as of v3.4–3.9 (pre-flat-config, pre-unified-evaluate). Retained as historical reference. |
| [architecture.md](./architecture.md)       | Current architecture: unified rule model, evaluated ruleset, and session approval generalization       |
| [history/](./history/)                     | Per-phase records of the completed improvement phases (findings, plans, dependency graphs, metrics).   |