v2.8.0
v2.8.0
This release introduces /afc:learner, a new pattern learning and rule promotion system that captures recurring user preferences and corrections during Claude Code sessions and promotes them to persistent project rules. It also includes targeted accuracy improvements across the implement, plan, review, and validate phases.
Highlights
/afc:learner— When you keep telling Claude the same thing ("always use named exports", "never use var"), learner captures those patterns in the background and lets you review and promote them to.claude/rules/afc-learned.mdas permanent project rules. Enable it once and corrections accumulate automatically.- Smarter parallel mode selection — Implement phase now requires ≥3 genuinely independent tasks before spinning up parallel workers, reducing context-loss failures from unnecessary delegation.
- Plan path validation — File Change Map paths are now verified against the actual codebase at plan time, with auto-correction for near-matches and ambiguity prompts for multi-match cases.
What's Changed
Added
/afc:learnercommand: pattern learning and rule promotion (review, status, reset, enable, disable)- Background
UserPromptSubmithook for signal collection (async, non-blocking, 5s timeout) - Korean language support for correction patterns (앞으로는, 항상, 절대, 쓰지마, 기억해)
- Secret redaction and queue cap (50 entries) in learner signal collection
- Learner queue notification at session start
- Learner health check category in
/afc:doctor
Changed
- Implement parallel batch threshold raised to ≥3 tasks; config.gate empty-string guard added
- Plan File Change Map: auto-correct close matches, ambiguity prompt for multi-match, sibling directory boundary check
- Review: external dependency/test imports skipped in callee re-reads; standalone review loads spec context
- Expert consultation write scope explicitly limited to
.claude/afc/and.claude/agent-memory/ - Critic loop: stale evidence from prior passes is invalid unless re-verified in current pass
- Validate: loads
context.md, verifies AC completeness before cross-checking - Auto fast-path: SIDE_EFFECT_SAFETY criterion added at Step 3.6
- Spec research findings persist to
.claude/afc/memory/research/to survive compaction - Triage risk classification considers change semantics, not just file type
afc-auto-format.sh: format errors now emit stderr warning instead of silently discarding
Fixed
- Silent failure in async format hook when timeout occurs
Breaking Changes
None.
Full Changelog: v2.7.1...v2.8.0