Skip to content

AICAM v1.2.1 Release Notes (2026-04-24)

Choose a tag to compare

@cham-space cham-space released this 24 Apr 05:46

πŸš€ 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.