Repository navigation
v1.1.0 — Global Architecture Decision Records
What's New
Global Architecture Decision Records (ADRs)
First-class docs/adr/ support for project-wide architectural decisions — the industry-standard location (Michael Nygard convention) for recording significant technical choices.
This is the first feature developed by dogfooding AFX on itself — using the full spec-driven workflow (spec → design → tasks → journal) to build AFX's own capabilities.
New Capabilities
/afx:init adr <title>— New subcommand that generates real ADR content with auto-increment numbering (ADR-NNNN-kebab-slug.md)- Global vs feature-local ADRs —
docs/adr/for project-wide decisions,docs/specs/{feature}/research/for feature-scoped decisions - ADR lifecycle — Proposed → Accepted → Deprecated/Superseded (with Mermaid diagram in README)
- Installer support —
install.shnow createsdocs/adr/in target projects - Configuration — New
paths.adrfield in.afx.yaml
Dogfooding
AFX now manages its own development:
.afx.yamlconfig for self-management- Full feature spec at
docs/specs/global-adr/(all phases verified ✓) ADR-0001-global-adr-directory.md— the self-referential first ADR
Documentation
Updated across all surfaces: README (dedicated ADR section with lifecycle diagram), framework manual, cheatsheet, CLAUDE.md, and all prompt snippets.
Full Changelog: v1.0.8...v1.1.0