v1.5.3

Changed

• Renamed .afx.yaml config key context: → library: to align with VS Code extension Library view.
• Updated .afx.yaml.template with cleaner defaults (features: [], commented-out examples).
• Updated docs/agenticflowx/agenticflowx.md config example to use library: key.

Added

• install.sh now creates docs/research/ directory during project scaffolding.

v1.5.2

Chore

• Simplified co-author trailers to plain names with unresolvable noreply emails (avoids GitHub "private" contributor artifacts from bot account emails).
  • Codex: codex <noreply@openai.com>
  • Copilot: copilot <noreply@github.com>
• Removed duplicate [bot] noreply lines from GEMINI.md and prompts/gemini.md.

v1.5.0

[1.5.0] - 2026-02-26

Added

• feat(copilot): add GitHub Copilot support (6bc6910)
• feat(install): add GEMINI.md managed snippet integration (7609ee4)

v1.4.0 - Gemini CLI Support & ADR Awareness

Added

• Gemini CLI Support: First-class support for Gemini CLI via proxy commands in .gemini/commands/.
• ADR Command Awareness: Global ADRs are now surfaced in /afx:next, /afx:context, and /afx:discover.
• Multi-Agent Documentation: Consolidated agent parity guides into docs/agenticflowx/multi-agent.md.

Changed

• Updated install.sh to support Gemini CLI asset deployment.
• Updated AGENTS.md and prompts/agents.md with multi-agent instructions.
• Renamed docs/agenticflowx/codex.md to docs/agenticflowx/multi-agent.md.

v1.3.1

[1.3.1] - 2026-02-25

Chore

• Standardized git commit attribution guidelines across documentation for:
  • Gemini: gemini-code-assist <noreply@gemini.google.com>
  • Claude: claude <noreply@anthropic.com>
  • Codex: code <noreply@openai.com>

v1.3.0

[1.3.0] - 2026-02-25

Added

• New AFX framework maintenance command /afx:update with:
  • check subcommand to compare local AFX version against upstream release.
  • apply subcommand to execute installer update flow (--update) with pass-through safety flags.
• New Codex skill parity for updates:
  • .codex/skills/afx-update/SKILL.md
  • .codex/skills/afx-update/agents/openai.yaml
• New spec package for this feature at docs/specs/afx-update/ (spec.md, design.md, tasks.md, journal.md).

Changed

• Updated command/discovery surfaces to include update workflow:
  • .claude/commands/afx-help.md
  • docs/agenticflowx/codex.md
  • README.md
  • CLAUDE.md
  • AGENTS.md
  • prompts/agents.md
  • docs/_index.md
  • docs/agenticflowx/agenticflowx.md

Fixed

• Corrected /afx:update check behavior when local marker is AFX Version: Unknown to return Status: UNKNOWN instead of LOCAL AHEAD.

v1.2.0

[1.2.0] - 2026-02-25

Added

• First-class Codex skill support with versioned skills at .codex/skills/afx-* for all AFX command families.
• OpenAI skill metadata manifests at .codex/skills/afx-*/agents/openai.yaml.
• New AGENTS.md guidance for Codex and compatible coding agents.
• New Codex snippet source at prompts/agents.md.
• New Codex command reference at docs/agenticflowx/codex.md.
• install.sh support for Codex installation:
  • Installs/updates .codex/skills/afx-*.
  • Manages a bounded AFX Codex block in AGENTS.md.
  • Adds --no-agents-md option.

Changed

• Updated documentation and framework references to position AFX as supporting both Claude Code and Codex:
  • README.md
  • CLAUDE.md
  • docs/_index.md
  • docs/agenticflowx/agenticflowx.md
• Expanded --commands-only behavior in install.sh to include both .claude and .codex command assets.
• Aligned command specs to current spec file expectations (spec.md, tasks.md, journal.md) instead of legacy readme.md references where applicable.

Removed

• Removed obsolete examples/minimal-project/docs/specs/example-feature/readme.md.

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.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

v1.0.8

Fixed

• Updated install.sh to dynamically fetch the latest release version directly from CHANGELOG.md to prevent outdated version displays during remote updates.
• Corrected the chronological order in CHANGELOG.md by moving v1.0.0 to the bottom of the list.

v1.0.7

Added

• Added a new How to create your first specs step-by-step tutorial to README.md. It teaches users how to scaffold an entire feature from scratch by having Claude act as a PM. This uses a simple plain HTML SaaS Landing Page example.

Removed

• Removed the separate prompts/bootstrap.md file since the prompt is now fully embedded directly into README.md for easier access without jumping between files.