docs: prepare release v2.12.0
v2.12.0
Fix critical skill path resolution bug and separate init/setup responsibilities for reliability.
Highlights
- New
/afc:setupskill — Dedicated command for managing the AFC routing block in~/.claude/CLAUDE.md. Run once after install, again after updates. Idempotent. - Fixed stale cache bug — Skills were referencing
${CLAUDE_PLUGIN_ROOT}which Claude Code doesn't substitute in SKILL.md files. Replaced with${CLAUDE_SKILL_DIR}/../..across all 14 skill files. - Init is now project-local only —
/afc:initno longer touches~/.claude/CLAUDE.md. Cleaner separation following industry conventions (git init, terraform init).
What's Changed
Added
/afc:setupskill for global~/.claude/CLAUDE.mdconfiguration
Changed
- Init/Setup separation: init = project-local, setup = global config
${CLAUDE_PLUGIN_ROOT}→${CLAUDE_SKILL_DIR}/../..in all SKILL.md files- Doctor now prints version header and plugin root path
- Fix suggestions correctly route to
/afc:setupvs/afc:init
Fixed
- Skills running from stale cached plugin versions
- Init trying to execute nonexistent
afc-init.shscript - Doctor example output mismatched actual script output
Breaking Changes
None. /afc:init still works for project setup. Global CLAUDE.md management is now available via /afc:setup.
Full Changelog: v2.11.0...v2.12.0