AICAM v1.2.1 Release Notes (2026-04-24)
π New Features
/hotfix Command
- New emergency fix command β skip Phase 1 planning, jump directly to
TDD fix flow - Smoke Test + Code Review gates still apply, ensuring quality is not
compromised - Command count updated 12 β 13 across all documentation
Smoke Test Mandatory Gate in /execute
- After all validation commands pass, Smoke Test Checklist must be
executed before Phase can proceed - Missing ## Smoke Test Checklist in plan β hard STOP, requires user
written confirmation to skip - Any β entry β enters bug fix flow, re-runs full Smoke Test after fix
- Results written to summary.md ## Smoke Test Log
ACβTask Mapping Check in /execute
- Cross-checks Spec-Lite AC list against plan Tasks
- β AC-{N} has no corresponding Task β potential feature gap
- β Task "{name}" not linked to any AC β scope creep risk
- Warning only, does not block execution
Critical Workspace Size Warning in /plan-feature
β 300KB: WARNING β suggests running /close-phase
β 500KB: CRITICAL β planning quality will degrade significantly,
β prompts immediate archival before continuing
Phase Number Automatic Derivation
- /close-phase and /verify-phase now auto-detect Phase number from:
a. Plan filename prefix: phase{N}- β use N
b. Plan content: # Phase N or Phase N: declaration
c. Falls back to asking the user if undetermined - Eliminates manual Phase number input for archive file naming
Flat Archive Structure
- archive/Phase{N}/ subdirectories replaced with flat files:
- archive/PHASE{N}_VERIFICATION_REPORT.md
- archive/phase{n}-code-review.md
- archive/phase{n}-*.md
- Traceability chain updated: plans β .agents/plans/archive/,
reports β archive/
MCP Installation & Configuration Guide
- Added complete setup instructions for serena and typescript-lsp:
- Prerequisites table (uv, Node.js + npm)
- Step-by-step install commands
- serena hooks configuration (PreToolUse, SessionStart, Stop)
- Verification command claude mcp list
π Documentation
TypeScript-LSP Capability Update
- Description expanded: AST search, diagnostics, refactoring, call/type
hierarchy analysis - Added note: requires tsconfig.json in project root to activate
e2e-test SKILL English Translation
- All remaining Chinese content in .claude/skills/e2e-test/SKILL.md
translated to English
Cross-File Consistency Sync
- Command count 12β13, /hotfix added to all command lists
- test-strategies/ row added to directory comparison tables in
README.en.md and README.zh.md - CLAUDE-template description aligned across all files
- WORKFLOW.md, README.en.md, README.zh.md fully synchronized
.gitignore Update
- Added .serena/ (local MCP runtime config)
π Commit History (since v1.2.0)
| Commit | Message |
|---|---|
91857ae |
enhance(workflow): add hotfix skill, smoke test gate, flat archive structure |
379575d |
docs: sync command count, hotfix, test-strategies across WORKFLOW and READMEs |
0a25e73 |
docs(workflow): add MCP installation guide, update ts-lsp capabilities, gitignore .serena/ |
efea792 |
docs: release v1.2.1 β update version header and changelog across all files |
Quick Start
git clone https://github.com/cham-space/AICAM.git
cp -r AICAM/.claude/ /path/to/your/project/
Then in Claude Code, run /discover to begin.