Version: 4.0.0 Last Updated: 2026-02-15
This directory contains reusable knowledge base and architecture decisions:
- Architecture Decision Records (ADRs) - Key technical decisions
- Project Guides - Reusable patterns and best practices
- Package Manuals - API reference for external libraries
- ADR-001: CLI Framework (Commander.js) | Accepted | 2026-02-15
- ADR-002: HTTP Client (got) | Accepted | 2026-02-15
- ADR-003: Configuration (Zod + smol-toml) | Accepted | 2026-02-15
- ADR-004: REPL Input Handling (pi-tui) | Accepted | 2026-02-24
- 01-Input Validation (Zod Schemas) | 2026-02-13
- 02-TOML Config Management (smol-toml) | 2026-02-13
- 03-Error Handling (RFC 9457) | 2026-02-13
- 04-HTTP Retry & Rate Limiting (got) | 2026-02-13
- 05-OAuth2 Device Flow and ROPC Fallback | 2026-06-12
- 06-CLI Patterns & Signal Handling (Commander.js) | 2026-02-13
- 07-SSE Streaming Patterns | 2026-02-15
- Testing Strategy | 2026-02-10
(No manuals yet -- all packages used in standard way)
Last Updated: 2026-02-15
Update Triggers:
- New ADRs added to adrs/ directory
- New guides added to guides/ directory
- New manuals added to manuals/ directory
Verification:
- All ADR links in registry are valid
- All guide links in registry are valid
- All manual links in registry are valid