Skip to content

v1.1.0 — Global Architecture Decision Records

Choose a tag to compare

@rixrix rixrix released this 23 Feb 12:19
· 62 commits to main since this release

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.sh now creates docs/adr/ in target projects
  • Configuration — New paths.adr field in .afx.yaml

Dogfooding

AFX now manages its own development:

  • .afx.yaml config 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