Active Proposals

Changes to the rig follow a docs-first workflow:

1. Write the proposal with diagrams in this section
2. Create a PR — the docs site preview shows the change
3. Team reviews the proposal (architecture, trade-offs, effort)
4. Approved → create implementation issues
5. Implemented → move proposal to architecture docs

Current Proposals

Proposal	Status	Effort
Session Recovery (Prime)	Proposed	Small
Pre-Tool Guards	Proposed	Small
Agent Identity Attribution	Proposed	Small
Centralized Hooks Config	Proposed	Medium
Escalation with Severity Routing	Proposed	Medium

How to Create a Proposal

1. Create a new .md file in docs-site/docs/proposals/
2. Use YAML frontmatter (title, description)
3. Include Mermaid diagrams for before/after flows
4. Add to the nav in mkdocs.yml
5. PR to rig-gitops