Architecture Decision Records

ADRs capture each architectural decision: the context that led to it, the decision itself, the consequences, and the alternatives that were rejected. The source-of-truth lives at docs/architecture/adr/ in the repo — this page is a stable index.

Index

#	Title	Status	Scope
001	Apache 2.0 license for the project	accepted	Legal
002	Rust-based architecture with npm binary distribution	accepted	Core
003	Testing strategy — layered mocking with optional record-and-replay for real APIs	accepted	Testing, CI
004	Trait-based provider abstraction for testability and extensibility	accepted	Core
005	Credential storage — OS keychain with environment-variable fallback	accepted	Storage, Security
007	Plugin architecture — API providers, format pipeline, and the enricher model	accepted	Plugins
010	Asset management — file attachments for AI agents	accepted	Assets (phases 1–3 shipped; phase 5 pending)
012	Skills subsystem — procedural recipes on top of the tool bundle	proposed	Skills
013	Skill install targets — repo-local default, global and agent-specific overrides	proposed	Skills
014	Skills lifecycle — manifest-based install, upgrade, and collision detection	proposed	Skills
015	Skills self-feedback loop — session trace format	proposed	Skills, Observability
016	Skills language adaptation	proposed	Skills (deferred)
017	Agent detection and `devboy onboard` command	proposed	Onboarding, Skills

Number gaps (006, 008, 009, 011) are intentional — those numbers are reserved for decisions that are not in scope for this project.

Writing a new ADR

See TEMPLATE.md. Copy it to ADR-NNN-short-title.md using the next available number, fill in every section, and start with status: proposed. Flip to accepted once implemented (or rejected / superseded if it goes the other way).

#Architecture Decision Records

#Index

#Writing a new ADR

Architecture Decision Records

Index

Writing a new ADR