ADR Records

Published Architecture and Development Decision Records for this project.

This page and linked ADR pages are generated from docs/decisions/*.yaml by task docs:export-adr-markdown.

• Total ADRs: 37
• Accepted ADRs: 36

ADR List

• ADR 001: Go as primary implementation language (architecture, accepted)
• ADR 002: Taskfile for development automation (development, accepted)
• ADR 003: AI agents as first-class developers (development, accepted)
• ADR 004: Live integration tests as primary correctness gate (development, accepted)
• ADR 005: Minimum coverage and integration testing policy (development, accepted)
• ADR 006: Conventional commits with hook enforcement (development, accepted)
• ADR 007: Manual GitHub release workflow (development, superseded)
• ADR 008: Layered Go architecture and package boundaries (architecture, accepted)
• ADR 009: Transport policy for Bitbucket API calls (architecture, accepted)
• ADR 010: Go model validation and schema export (architecture, accepted)
• ADR 011: Error taxonomy and CLI exit contract (architecture, accepted)
• ADR 012: Git backend abstraction for repository operations (architecture, accepted)
• ADR 013: CLI framework and command tree standard (architecture, accepted)
• ADR 014: Output contract for human and machine modes (architecture, accepted)
• ADR 015: Live test harness and deterministic seeding (development, accepted)
• ADR 016: Test classification and execution policy (development, accepted)
• ADR 017: Undocumented behavior registry via live tests (development, accepted)
• ADR 018: Supported Bitbucket version policy (architecture, accepted)
• ADR 019: Configuration and secret handling policy (development, accepted)
• ADR 020: Execgit as default Git backend (architecture, accepted)
• ADR 021: Persistent auth configuration and keyring storage (architecture, accepted)
• ADR 022: Auth mode priority and token-first policy (architecture, accepted)
• ADR 023: Long-term planning via GitHub issues (development, accepted)
• ADR 024: Use .tmp directory for agent temporary files (development, accepted)
• ADR 025: Git discipline and branch management (development, accepted)
• ADR 026: PR readiness and auto-merge criteria (development, accepted)
• ADR 027: Atlassian 9.4 docs as API reference source (architecture, accepted)
• ADR 028: OpenAPI fix registry and parity enforcement (development, accepted)
• ADR 029: Network Isolation during Unit Testing (development, accepted)
• ADR 030: Linear rebase workflow with generated coverage artifacts (development, accepted)
• ADR 031: Top-level search command tree for discovery (architecture, accepted)
• ADR 032: Refactor CLI root into command packages (architecture, accepted)
• ADR 033: Automated Conventional Commit release on main (development, accepted)
• ADR 034: Unified dry-run planning engine for server mutating commands (architecture, accepted)
• ADR 035: Dry-run capability signaling and test strategy policy (development, accepted)
• ADR 036: CLI identity bb and BB namespace (architecture, accepted)
• ADR 037: Versioned docs via MkDocs Material and mike (development, accepted)