v2.5.1

[2.5.1] - 2026-04-02

Changed

• Context Resolution (all 15 skills): Replaced copy-paste IDE-only inference block with environment-aware context resolution — detects CLI vs IDE, names concrete signals (ide_opened_file, ide_selection), adds CLI fallback path (explicit args → cwd/branch → conversation), and uses skill-specific examples and fallbacks
• Tier A skills (afx-task, afx-spec): Merged new context detection into existing resolution chains instead of duplicating; extracted trailing parameters into standalone sections
• Tier C skills (afx-hello, afx-help): Removed Active File Inference entirely — these are context-agnostic diagnostic/reference commands; kept trailing parameters as keyword filters
• Suggestion list formatting (6 skills): De-indented code-block suggestion lists to standard markdown ordered lists
• Markdown table alignment: Consistent column widths across all skill files
• afx-next numbering fix: Corrected duplicate step 3 → sequential steps 4-7
• afx-next glob escape: Escaped * in ADR glob pattern to prevent markdown emphasis

v2.5.0

Added

• /afx-release skill (new): Release workflow — auto-detects semver bump type from commit log, updates CHANGELOG.md and skills.json, commits, pushes, creates tag, and publishes GitHub release. Supports explicit patch|minor|major override.

Changed

• afx-pack-agenticflowx: Added afx-release to the pack manifest.

Fixed

• afx-cli sed -i '': Fixed cross-platform incompatibility on WSL and Git Bash — replaced macOS-only sed -i '' with portable sed -i.bak + cleanup.
• afx-cli cache cleanup: Simplified .afx/.cache/tmp.* cleanup from two rm calls to a single rm -rf.
• Datetime format: Enforced standard ISO 8601 datetime format across skill outputs.

v2.4.0

What's New

Added

• /afx-adr skill (new): ADR management — create, review, list, supersede. Reads canonical template from assets/adr-template.md. Replaces the ADR subcommands previously in /afx-init.
• /afx-scaffold skill (new): Thin orchestrator for spec scaffolding — spec <name> delegates to /afx-spec create, research <name> uses ../afx-research/assets/research-template.md, adr <title> delegates to /afx-adr create. Replaces /afx-init.
• Skill assets/ directories: Templates are now co-located with their owning skill rather than installed separately. afx-spec, afx-design, afx-task, afx-session, afx-research, afx-adr each carry their canonical template in assets/.
• Context Resolution section: Added to afx-spec, afx-adr, and afx-scaffold skills — explicit inference table for resolving feature name, owner, and paths from branch, recent files, and active spec.
• Error Handling section: Added to afx-research — covers topic-not-found, existing artifact, ambiguous match, and finalize-without-prior-research.

Changed

• afx-cli skill_sync(): Changed from cherry-picking SKILL.md + references/ to recursive cp -r so assets/ directories propagate automatically to .claude/skills/ and .agents/skills/.
• /afx-spec create: Now owns full spec scaffolding (reads templates from own assets/ and sibling skills). No longer delegates to /afx-scaffold.
• Pack manifest (afx-pack-agenticflowx.yaml): Replaced afx-init with afx-scaffold + afx-adr.

Removed

• /afx-init skill: Replaced by /afx-scaffold (spec/research/adr scaffolding) and /afx-adr (ADR lifecycle).
• step_templates() in afx-cli: Template install step removed — templates now live in skill assets/ and are synced via skill_sync().
• Dead config keys: Removed paths.sessions, ai_attribution, test_traceability, anchors, quality_gates, verification, require_see_links, scan_for_orphans from .afx.yaml.template and all managed .afx/.afx.yaml files.

Update

curl -sL https://raw.githubusercontent.com/rixrix/afx/main/afx-cli | bash -s -- --update .

v2.3.0 — Artifact Ownership Model

Highlights

This release restructures the AFX command surface around an artifact ownership model — each skill owns exactly one document type, with clear lifecycle gates between them.

Breaking Changes

• /afx-work removed → absorbed into /afx-task (plan, pick, code, verify, complete, sync) and /afx-next (status)
• /afx-dev code removed → moved to /afx-task code (task-driven coding with traceability)
• /afx-update removed → replaced by /afx-hello (environment diagnostics)
• /afx-spec design removed → new dedicated /afx-design skill
• @see policy: spec.md + design.md links required; tasks.md links optional
• @see format: #anchor-slug → [NODE-ID] brackets (e.g., [FR-1], [DES-API])
• Frontmatter: created → created_at, last_verified → updated_at, version quoted as "1.0"

New Skills

Skill	Purpose
/afx-design	Owns design.md — author, validate, review, approve
/afx-hello	Environment diagnostics and installation verification

New Quality Checks

• /afx-check deps — cross-spec dependency graph validation
• /afx-check coverage — bidirectional spec-to-code coverage map

Enhanced

• /afx-spec validate now checks requirement ID uniqueness, sequential ordering, frontmatter depth, and 8 required template sections (parity with /afx-design validate)
• Post-action checklists added to 7 skills
• All templates, prompts, and docs updated for new conventions

Artifact Ownership

/afx-spec    → spec.md
/afx-design  → design.md
/afx-task    → tasks.md + source code
/afx-session → journal.md

See CHANGELOG.md for full details.

---

Install / Update:

curl -sL https://raw.githubusercontent.com/rixrix/afx/main/afx-cli | bash -s -- --update .

v2.2.0 — Workbench Tab, Drift Detection & Ghost Tasks

Highlights

Workbench Tab (vscode-afx 2.0.0-alpha.2)

The old Tasks tab is replaced by a full Workbench — a multi-column editor that shows spec, design, tasks, and sessions documents side by side.

• Resizable columns with accent-colored toggle pills (spec=pink, design=blue, tasks=amber, sessions=green)
• Three view modes: Preview (rendered markdown), Edit (inline textarea with Ctrl+S), Open in Editor
• Conflict guard: Detects disk changes while editing — Reload or Keep mine
• Batch fetch: Single round-trip for all visible columns
• Layout persistence: Saved per feature to .afx/workbench.json

Drift Detection

• Workbench footer: Colored dots based on last_verified frontmatter — 🟢 fresh (≤7d), 🟡 stale (≤30d), 🔴 very stale (>30d)
• Analytics heatmap: Three new S/D/T drift columns in the Doc Completeness table
• Anchor sync scroll: Click a heading in one column to scroll matching headings in others

Ghost Task Detection

Extension scans tasks.md for broken @see references pointing to files that no longer exist. New KPI card in the Analytics hero row with expandable detail panel.

UX Improvements

• "Open Workbench" action in sidebar Project tree + all view title bars
• Default kanban board auto-created when none exists (backlog.md)
• Dismissible help hint bar for first-time workbench users
• Tab reorder: Workbench → Notes → Board → Pipeline → Documents → Analytics → Journal → Architecture → Time Machine
• Default columns: Spec, Design, Tasks shown on first view (sessions off)

CLI Improvements

• --verbose and --target flags for afx-cli
• Fixed Bash 5.x silent exit on Linux/WSL
• Cross-cutting skill enhancements (journaling, next-command, contracts)

---

VSCode Extension: The vscode-afx-2.0.0-alpha.2.vsix will be uploaded as a release asset shortly.

Full Changelog: v2.1.0...v2.2.0

Screenshot

v2.1.0

What's New

VSCode Extension Available as Release Asset

The AgenticFlowX VSCode Extension (vscode-afx-2.0.0-alpha.1.vsix) is now bundled with this release.

Install

One-liner:

curl -L -o vscode-afx.vsix https://github.com/rixrix/afx/releases/download/v2.1.0/vscode-afx-2.0.0-alpha.1.vsix && code --install-extension vscode-afx.vsix

Or from VS Code UI:

1. Download the .vsix from the assets below
2. Cmd+Shift+P → Extensions: Install from VSIX...

Other Changes

• README: Added INSTALL section to the news table
• README: Added macOS/WSL tested notice

Full Changelog: https://github.com/rixrix/afx/blob/main/CHANGELOG.md#210---2026-03-15

v2.0.1 — Agent selection & BSD compatibility fixes

Fixed

• Agent selection prompt: Install and update now always prompt for agent selection unless --yes or explicit flags (--no-claude-md, --no-agents-md, --with-gemini-md) are provided. Previously, --update silently reused saved config without prompting.
• BSD sed compatibility: Rewrote update_agent_config() to use awk instead of multiline sed insert, fixing failures on macOS (BSD sed).
• .claude directory tracking: Added .claude to .gitignore exclusions so skill assets are properly tracked.

v2.0.0

Breaking Changes

• Script renamed: install.sh → afx-cli
• Skill targets: Two targets replace the old 5-provider model:
  • .claude/skills/ — Claude Code
  • .agents/skills/ — Codex, Copilot, Antigravity
• Canonical skill store: .afx/skills/{category}/{name}/ replaces .afx/packs/{pack}/{provider}/skills/
• Removed flags: --commands-only, --no-copilot-md, --pack-enable, --pack-disable
• New flags: --skills-only, --with-gemini-md, --yes
• GEMINI.md: Changed from opt-out to opt-in (--with-gemini-md)
• copilot-instructions.md: Removed — Copilot now reads AGENTS.md

Added

• Interactive Agent Selection: Install and update now prompt users to select which AI agents they use (Claude Code, Codex/Copilot/Antigravity, Gemini CLI). Skills and context files are only created for selected agents.

Changed

• Dual skill sync: skill_sync() conditionally syncs to both .claude/skills/ and .agents/skills/ based on user selection.
• Documentation: Updated all references to reflect new skill targets and agent selection model.
• Removed prompts/copilot.md: Copilot now shares AGENTS.md, separate snippet file deleted.

v1.7.0 — Provider-aware pack installation

Highlights

• Provider Selection for Packs: Pack install now prompts users to select their AI coding tools — no more installing for every provider at once.
• Starter Pack (afx-pack-starter): New afx-hello skill to verify AFX installation and multi-provider routing.
• Upstream Fixes: Updated pack manifests for renamed Anthropic repos and skills.

Added

• afx-pack-starter with afx-hello vibe check skill (all providers)
• webapp-testing from anthropics/skills added to QA pack
• Local manifest fallback for dev/testing
• Provider-gated routing in route_item() and pack_copy_to_providers()

Fixed

• Bash 3.x compatibility on macOS (replaced ${var^^} syntax)
• Dead upstream references (anthropics/antigravity-awesome-skills → anthropics/skills)
• security-scanner → security-guidance in security pack

Changed

• Pack install always prompts for provider selection (upstream packs may add new providers)
• Updated packs/index.json upstream registry with current repo names

Full Changelog: https://github.com/rixrix/afx/blob/main/CHANGELOG.md

v1.6.0

Pack System for Curated Skill Distribution

AFX now supports curated skill packs — bundled collections of AI skills distributed across Claude Code, Codex CLI, Antigravity, GitHub Copilot, and Gemini CLI.

Highlights

• Pack manifests (afx-pack-qa, afx-pack-security) with provider-aware skill mapping
• Pack index (packs/index.json) for remote discovery and version checking
• New install.sh options: --pack, --update-packs, --reset, --branch, --version, and fine-grained --skill-enable/--skill-disable
• 4 new AFX-built skills: QA methodology, security audit, OWASP top 10, spec-driven test planning
• Antigravity provider support: .agent/skills/ with 15 skills
• Gemini TOML migration: All Gemini commands converted from Markdown to TOML format

Install / Update

# Fresh install with QA pack
curl -sL https://raw.githubusercontent.com/rixrix/afx/main/install.sh | bash -s -- --pack qa .

# Update existing installation
curl -sL https://raw.githubusercontent.com/rixrix/afx/main/install.sh | bash -s -- --update .

# Update all installed packs
curl -sL https://raw.githubusercontent.com/rixrix/afx/main/install.sh | bash -s -- --update-packs .

See CHANGELOG.md for full details.