cc-devflow 1.0.1

package/.claude/tests/constitution/run_all_constitution_tests.sh

@@ -0,0 +1,111 @@
+#!/usr/bin/env bash
+
+# run_all_constitution_tests.sh - 运行所有 Constitution 测试套件
+#
+# 执行所有 Constitution 一致性验证测试
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# 颜色代码
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# ============================================================================
+# 测试套件列表
+# ============================================================================
+
+declare -a TEST_SUITES=(
+    "test_version_consistency.sh"
+    "test_article_coverage.sh"
+    "test_template_completeness.sh"
+    "test_agent_assignment.sh"
+)
+
+# ============================================================================
+# 运行测试
+# ============================================================================
+
+echo -e "${CYAN}═══════════════════════════════════════════════════════════${NC}"
+echo -e "${CYAN}  CC-DevFlow Constitution Test Suite${NC}"
+echo -e "${CYAN}═══════════════════════════════════════════════════════════${NC}"
+echo ""
+
+total_suites=0
+passed_suites=0
+failed_suites=0
+skipped_suites=0
+
+for test_suite in "${TEST_SUITES[@]}"; do
+    test_file="$SCRIPT_DIR/$test_suite"
+
+    if [[ ! -f "$test_file" ]]; then
+        echo -e "${YELLOW}⚠${NC}  Skipping $test_suite (not found)"
+        ((skipped_suites++))
+        continue
+    fi
+
+    ((total_suites++))
+
+    echo -e "${BLUE}▶${NC}  Running $test_suite..."
+    echo ""
+
+    # 给脚本添加执行权限
+    chmod +x "$test_file"
+
+    # 运行测试
+    if bash "$test_file"; then
+        echo -e "${GREEN}✅${NC}  $test_suite PASSED"
+        ((passed_suites++))
+    else
+        echo -e "${RED}❌${NC}  $test_suite FAILED"
+        ((failed_suites++))
+    fi
+
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+done
+
+# ============================================================================
+# 总结报告
+# ============================================================================
+
+echo -e "${CYAN}═══════════════════════════════════════════════════════════${NC}"
+echo -e "${CYAN}  Test Summary${NC}"
+echo -e "${CYAN}═══════════════════════════════════════════════════════════${NC}"
+echo ""
+echo "  Total Test Suites: $total_suites"
+echo -e "  ${GREEN}Passed: $passed_suites${NC}"
+if [[ $failed_suites -gt 0 ]]; then
+    echo -e "  ${RED}Failed: $failed_suites${NC}"
+fi
+if [[ $skipped_suites -gt 0 ]]; then
+    echo -e "  ${YELLOW}Skipped: $skipped_suites${NC}"
+fi
+echo ""
+
+# 计算成功率
+if [[ $total_suites -gt 0 ]]; then
+    success_rate=$((passed_suites * 100 / total_suites))
+    echo "  Success Rate: $success_rate%"
+    echo ""
+fi
+
+if [[ $failed_suites -eq 0 ]]; then
+    echo -e "${GREEN}✅ All Constitution tests passed!${NC}"
+    echo ""
+    exit 0
+else
+    echo -e "${RED}❌ Some Constitution tests failed${NC}"
+    echo ""
+    echo "Fix the failing tests and run again:"
+    echo "  bash $0"
+    echo ""
+    exit 1
+fi

package/.claude/tests/constitution/test_agent_assignment.sh

@@ -0,0 +1,207 @@
+#!/usr/bin/env bash
+
+# test_agent_assignment.sh - 测试代理 Article 分工
+#
+# 验证每个代理是否明确分配了负责的 Articles
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# 加载测试框架
+if [[ -f "$REPO_ROOT/.claude/tests/test-framework.sh" ]]; then
+    source "$REPO_ROOT/.claude/tests/test-framework.sh"
+else
+    echo "❌ Test framework not found"
+    exit 1
+fi
+
+# ============================================================================
+# 测试用例
+# ============================================================================
+
+test_prd_writer_enforces_article_I() {
+    # prd-writer 应该执行 Article I (Quality First)
+    local agent="$REPO_ROOT/.claude/agents/prd-writer.md"
+
+    assert_file_exists "$agent" "prd-writer.md should exist"
+    assert_file_contains "$agent" "Article I" "prd-writer should reference Article I"
+}
+
+test_prd_writer_enforces_article_III() {
+    # prd-writer 应该执行 Article III (Security First)
+    local agent="$REPO_ROOT/.claude/agents/prd-writer.md"
+
+    assert_file_contains "$agent" "Article III" "prd-writer should reference Article III"
+}
+
+test_prd_writer_enforces_article_X() {
+    # prd-writer 应该执行 Article X (Requirement Boundary)
+    local agent="$REPO_ROOT/.claude/agents/prd-writer.md"
+
+    assert_file_contains "$agent" "Article X" "prd-writer should reference Article X"
+}
+
+test_planner_enforces_article_VII() {
+    # planner 应该执行 Article VII (Simplicity Gate)
+    local agent="$REPO_ROOT/.claude/agents/planner.md"
+
+    assert_file_exists "$agent" "planner.md should exist"
+    assert_file_contains "$agent" "Article VII" "planner should reference Article VII (Simplicity Gate)"
+}
+
+test_planner_enforces_article_VIII() {
+    # planner 应该执行 Article VIII (Anti-Abstraction)
+    local agent="$REPO_ROOT/.claude/agents/planner.md"
+
+    assert_file_contains "$agent" "Article VIII" "planner should reference Article VIII (Anti-Abstraction)"
+}
+
+test_planner_enforces_article_IX() {
+    # planner 应该执行 Article IX (Integration-First)
+    local agent="$REPO_ROOT/.claude/agents/planner.md"
+
+    assert_file_contains "$agent" "Article IX" "planner should reference Article IX (Integration-First)"
+}
+
+test_qa_tester_enforces_article_I() {
+    # qa-tester 应该执行 Article I (Quality First - Testing)
+    local agent="$REPO_ROOT/.claude/agents/qa-tester.md"
+
+    assert_file_exists "$agent" "qa-tester.md should exist"
+    assert_file_contains "$agent" "Article I" "qa-tester should reference Article I"
+}
+
+test_qa_tester_enforces_article_VI() {
+    # qa-tester 应该执行 Article VI (Test-First Development)
+    local agent="$REPO_ROOT/.claude/agents/qa-tester.md"
+
+    assert_file_contains "$agent" "Article VI" "qa-tester should reference Article VI (Test-First)"
+}
+
+test_security_reviewer_enforces_article_III() {
+    # security-reviewer 应该执行 Article III (Security First)
+    local agent="$REPO_ROOT/.claude/agents/security-reviewer.md"
+
+    assert_file_exists "$agent" "security-reviewer.md should exist"
+    assert_file_contains "$agent" "Article III" "security-reviewer should reference Article III"
+}
+
+test_security_reviewer_checks_hardcoded_secrets() {
+    # security-reviewer 应该明确检查 NO HARDCODED SECRETS (Article III.1)
+    local agent="$REPO_ROOT/.claude/agents/security-reviewer.md"
+
+    assert_file_contains "$agent" "NO HARDCODED SECRETS|Article III.1" "security-reviewer should check for hardcoded secrets"
+}
+
+test_all_agents_reference_constitution() {
+    local agents_dir="$REPO_ROOT/.claude/agents"
+    local agents_without_constitution=()
+
+    for agent in "$agents_dir"/*.md; do
+        if [[ -f "$agent" ]] && ! grep -q "Constitution" "$agent"; then
+            agents_without_constitution+=("$(basename "$agent")")
+        fi
+    done
+
+    # 允许一些代理不引用 Constitution (如 bug-analyzer, impact-analyzer 等工具型代理)
+    local allowed_without=(
+        "bug-analyzer.md"
+        "impact-analyzer.md"
+        "compatibility-checker.md"
+        "consistency-checker.md"
+        "release-manager.md"
+    )
+
+    # 检查数组是否为空（安全处理）
+    if [[ ${#agents_without_constitution[@]} -eq 0 ]]; then
+        # 所有代理都引用了 Constitution，测试通过
+        return 0
+    fi
+
+    for agent_name in "${agents_without_constitution[@]}"; do
+        local is_allowed=false
+        for allowed in "${allowed_without[@]}"; do
+            if [[ "$agent_name" == "$allowed" ]]; then
+                is_allowed=true
+                break
+            fi
+        done
+
+        if [[ "$is_allowed" == "false" ]]; then
+            log_error "Agent $agent_name does not reference Constitution"
+            return 1
+        fi
+    done
+
+    # 所有未引用 Constitution 的代理都在允许列表中
+    return 0
+}
+
+test_agents_reference_current_version() {
+    local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/constitution/project-constitution.md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
+
+    local agents=(
+        "$REPO_ROOT/.claude/agents/prd-writer.md"
+        "$REPO_ROOT/.claude/agents/planner.md"
+        "$REPO_ROOT/.claude/agents/qa-tester.md"
+        "$REPO_ROOT/.claude/agents/security-reviewer.md"
+    )
+
+    for agent in "${agents[@]}"; do
+        if grep -q "Constitution.*v" "$agent"; then
+            # 使用精确的版本号匹配（v数字.数字.数字）
+            local agent_version=$(grep -o "Constitution.*v[0-9]\+\.[0-9]\+\.[0-9]\+" "$agent" | head -1 | grep -o "v[0-9]\+\.[0-9]\+\.[0-9]\+" | sed 's/v//')
+            if [[ -n "$agent_version" ]]; then
+                assert_equals "$agent_version" "$constitution_version" "$(basename "$agent") should reference v$constitution_version"
+            fi
+        fi
+    done
+}
+
+test_agent_article_coverage_complete() {
+    # 验证所有 10 个 Articles 都有至少一个代理负责
+
+    local articles_with_agents=()
+
+    for article in I II III IV V VI VII VIII IX X; do
+        local has_agent=false
+
+        for agent in "$REPO_ROOT/.claude/agents"/*.md; do
+            if [[ -f "$agent" ]] && grep -q "Article $article" "$agent"; then
+                has_agent=true
+                break
+            fi
+        done
+
+        if [[ "$has_agent" == "true" ]]; then
+            articles_with_agents+=("$article")
+        else
+            log_warning "Article $article has no dedicated agent enforcement"
+        fi
+    done
+
+    # 至少要有 7 个 Articles 有代理负责 (允许一些 Articles 只在模板中执行)
+    local count=${#articles_with_agents[@]}
+    assert_gte "$count" "7" "At least 7 Articles should have agent enforcement (found $count)"
+}
+
+# ============================================================================
+# 运行测试
+# ============================================================================
+
+run_tests \
+    test_prd_writer_enforces_article_I \
+    test_prd_writer_enforces_article_III \
+    test_prd_writer_enforces_article_X \
+    test_planner_enforces_article_VII \
+    test_planner_enforces_article_VIII \
+    test_planner_enforces_article_IX \
+    test_qa_tester_enforces_article_I \
+    test_qa_tester_enforces_article_VI \
+    test_security_reviewer_enforces_article_III \
+    test_security_reviewer_checks_hardcoded_secrets \
+    test_all_agents_reference_constitution \
+    test_agents_reference_current_version \
+    test_agent_article_coverage_complete

package/.claude/tests/constitution/test_article_coverage.sh

@@ -0,0 +1,201 @@
+#!/usr/bin/env bash
+
+# test_article_coverage.sh - 测试 Article 覆盖率
+#
+# 验证每个 Article 是否都有执行点（enforcement points）
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# 加载测试框架
+if [[ -f "$REPO_ROOT/.claude/tests/test-framework.sh" ]]; then
+    source "$REPO_ROOT/.claude/tests/test-framework.sh"
+else
+    echo "❌ Test framework not found"
+    exit 1
+fi
+
+# ============================================================================
+# 测试用例
+# ============================================================================
+
+test_article_I_has_enforcement_points() {
+    # Article I: Quality First
+    # 应该在 PRD, EPIC, TASKS 模板和 prd-writer, qa-tester 代理中被引用
+
+    local count=0
+    local files=(
+        "$REPO_ROOT/.claude/docs/templates/PRD_TEMPLATE.md"
+        "$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+        "$REPO_ROOT/.claude/docs/templates/TASKS_TEMPLATE.md"
+        "$REPO_ROOT/.claude/agents/prd-writer.md"
+        "$REPO_ROOT/.claude/agents/qa-tester.md"
+    )
+
+    for file in "${files[@]}"; do
+        if [[ -f "$file" ]] && grep -q "Article I" "$file"; then
+            ((count++))
+        fi
+    done
+
+    assert_gte "$count" "4" "Article I should have at least 4 enforcement points (found $count)"
+}
+
+test_article_III_has_enforcement_points() {
+    # Article III: Security First
+    # 应该在模板和 security-reviewer, prd-writer 代理中被引用
+
+    local count=0
+    local files=(
+        "$REPO_ROOT/.claude/docs/templates/PRD_TEMPLATE.md"
+        "$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+        "$REPO_ROOT/.claude/agents/prd-writer.md"
+        "$REPO_ROOT/.claude/agents/security-reviewer.md"
+    )
+
+    for file in "${files[@]}"; do
+        if [[ -f "$file" ]] && grep -q "Article III" "$file"; then
+            ((count++))
+        fi
+    done
+
+    assert_gte "$count" "3" "Article III should have at least 3 enforcement points (found $count)"
+}
+
+test_article_VI_has_enforcement_points() {
+    # Article VI: Test-First Development
+    # 应该在 TASKS 模板和 qa-tester 代理中被引用
+
+    local count=0
+    local files=(
+        "$REPO_ROOT/.claude/docs/templates/TASKS_TEMPLATE.md"
+        "$REPO_ROOT/.claude/agents/qa-tester.md"
+    )
+
+    for file in "${files[@]}"; do
+        if [[ -f "$file" ]] && grep -q "Article VI" "$file"; then
+            ((count++))
+        fi
+    done
+
+    assert_gte "$count" "2" "Article VI should have at least 2 enforcement points (found $count)"
+}
+
+test_article_VII_has_enforcement_points() {
+    # Article VII: Simplicity Gate
+    # 应该在 EPIC 模板和 planner 代理中被引用
+
+    local count=0
+    local files=(
+        "$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+        "$REPO_ROOT/.claude/agents/planner.md"
+    )
+
+    for file in "${files[@]}"; do
+        if [[ -f "$file" ]] && grep -q "Article VII" "$file"; then
+            ((count++))
+        fi
+    done
+
+    assert_gte "$count" "2" "Article VII should have at least 2 enforcement points (found $count)"
+}
+
+test_article_VIII_has_enforcement_points() {
+    # Article VIII: Anti-Abstraction
+    # 应该在 EPIC 模板和 planner 代理中被引用
+
+    local count=0
+    local files=(
+        "$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+        "$REPO_ROOT/.claude/agents/planner.md"
+    )
+
+    for file in "${files[@]}"; do
+        if [[ -f "$file" ]] && grep -q "Article VIII" "$file"; then
+            ((count++))
+        fi
+    done
+
+    assert_gte "$count" "2" "Article VIII should have at least 2 enforcement points (found $count)"
+}
+
+test_article_IX_has_enforcement_points() {
+    # Article IX: Integration-First Testing
+    # 应该在 EPIC 模板和 planner 代理中被引用
+
+    local count=0
+    local files=(
+        "$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+        "$REPO_ROOT/.claude/agents/planner.md"
+    )
+
+    for file in "${files[@]}"; do
+        if [[ -f "$file" ]] && grep -q "Article IX" "$file"; then
+            ((count++))
+        fi
+    done
+
+    assert_gte "$count" "2" "Article IX should have at least 2 enforcement points (found $count)"
+}
+
+test_article_X_has_enforcement_points() {
+    # Article X: Requirement Boundary
+    # 应该在 PRD 模板和 prd-writer 代理中被引用
+
+    local count=0
+    local files=(
+        "$REPO_ROOT/.claude/docs/templates/PRD_TEMPLATE.md"
+        "$REPO_ROOT/.claude/agents/prd-writer.md"
+        "$REPO_ROOT/.claude/scripts/validate-scope-boundary.sh"
+    )
+
+    for file in "${files[@]}"; do
+        if [[ -f "$file" ]] && grep -q "Article X" "$file"; then
+            ((count++))
+        fi
+    done
+
+    assert_gte "$count" "2" "Article X should have at least 2 enforcement points (found $count)"
+}
+
+test_all_articles_documented_in_constitution() {
+    local constitution="$REPO_ROOT/.claude/constitution/project-constitution.md"
+
+    for article in I II III IV V VI VII VIII IX X; do
+        assert_file_contains "$constitution" "## Article $article:" "Constitution should document Article $article"
+    done
+}
+
+test_all_articles_documented_in_claude_md() {
+    local claude_md="$REPO_ROOT/CLAUDE.md"
+
+    for article in I II III IV V VI VII VIII IX X; do
+        assert_file_contains "$claude_md" "Article $article" "CLAUDE.md should mention Article $article"
+    done
+}
+
+test_impact_report_shows_all_articles() {
+    local output=$(bash "$REPO_ROOT/.claude/scripts/manage-constitution.sh" impact 2>&1)
+
+    for article in I II III IV V VI VII VIII IX X; do
+        assert_contains "$output" "Article $article:" "Impact report should include Article $article"
+    done
+}
+
+# ============================================================================
+# 运行测试
+# ============================================================================
+
+run_tests \
+    test_article_I_has_enforcement_points \
+    test_article_III_has_enforcement_points \
+    test_article_VI_has_enforcement_points \
+    test_article_VII_has_enforcement_points \
+    test_article_VIII_has_enforcement_points \
+    test_article_IX_has_enforcement_points \
+    test_article_X_has_enforcement_points \
+    test_all_articles_documented_in_constitution \
+    test_all_articles_documented_in_claude_md \
+    test_impact_report_shows_all_articles

package/.claude/tests/constitution/test_template_completeness.sh

@@ -0,0 +1,150 @@
+#!/usr/bin/env bash
+
+# test_template_completeness.sh - 测试模板完整性
+#
+# 验证所有模板是否包含必需的 Constitution Check 部分
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# 加载测试框架
+if [[ -f "$REPO_ROOT/.claude/tests/test-framework.sh" ]]; then
+    source "$REPO_ROOT/.claude/tests/test-framework.sh"
+else
+    echo "❌ Test framework not found"
+    exit 1
+fi
+
+# ============================================================================
+# 测试用例
+# ============================================================================
+
+test_prd_template_has_constitution_check() {
+    local template="$REPO_ROOT/.claude/docs/templates/PRD_TEMPLATE.md"
+
+    assert_file_exists "$template" "PRD_TEMPLATE.md should exist"
+    assert_file_contains "$template" "## Constitution Check" "PRD template should have Constitution Check section"
+    assert_file_contains "$template" ".claude/constitution/project-constitution.md" "PRD template should reference Constitution file"
+}
+
+test_epic_template_has_constitution_check() {
+    local template="$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+
+    assert_file_exists "$template" "EPIC_TEMPLATE.md should exist"
+    assert_file_contains "$template" "## Constitution Check" "EPIC template should have Constitution Check section"
+    assert_file_contains "$template" ".claude/constitution/project-constitution.md" "EPIC template should reference Constitution file"
+}
+
+test_tasks_template_has_constitution_alignment() {
+    local template="$REPO_ROOT/.claude/docs/templates/TASKS_TEMPLATE.md"
+
+    assert_file_exists "$template" "TASKS_TEMPLATE.md should exist"
+    assert_file_contains "$template" "Constitution Alignment|Constitution Compliance" "TASKS template should have Constitution section"
+    assert_file_contains "$template" ".claude/constitution/project-constitution.md" "TASKS template should reference Constitution file"
+}
+
+test_prd_template_has_article_references() {
+    local template="$REPO_ROOT/.claude/docs/templates/PRD_TEMPLATE.md"
+
+    # PRD 应该引用 Article I, III, X
+    assert_file_contains "$template" "Article I" "PRD template should reference Article I (Quality)"
+    assert_file_contains "$template" "Article III" "PRD template should reference Article III (Security)"
+    assert_file_contains "$template" "Article X" "PRD template should reference Article X (Requirement Boundary)"
+}
+
+test_epic_template_has_phase_minus_one_gates() {
+    local template="$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+
+    # EPIC 应该有 Phase -1 Gates
+    assert_file_contains "$template" "Phase -1.*Gate|Phase -1.*Constitutional" "EPIC template should have Phase -1 Gates"
+    assert_file_contains "$template" "Article VII" "EPIC template should reference Article VII (Simplicity Gate)"
+    assert_file_contains "$template" "Article VIII" "EPIC template should reference Article VIII (Anti-Abstraction)"
+    assert_file_contains "$template" "Article IX" "EPIC template should reference Article IX (Integration-First)"
+}
+
+test_tasks_template_has_tdd_enforcement() {
+    local template="$REPO_ROOT/.claude/docs/templates/TASKS_TEMPLATE.md"
+
+    # TASKS 应该强制执行 TDD (Article VI)
+    assert_file_contains "$template" "Article VI" "TASKS template should reference Article VI (TDD)"
+    assert_file_contains "$template" "Test.*First|TDD" "TASKS template should mention Test-First or TDD"
+}
+
+test_epic_template_has_complexity_tracking() {
+    local template="$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+
+    # EPIC 应该有 Complexity Tracking 表格
+    assert_file_contains "$template" "Complexity Tracking" "EPIC template should have Complexity Tracking section"
+    assert_file_contains "$template" "Constitutional Violations|违规" "EPIC template should have violations table"
+}
+
+test_all_templates_reference_current_version() {
+    local constitution_version=$(grep -E '^\*\*Version\*\*:|^> \*\*Version\*\*:' "$REPO_ROOT/.claude/constitution/project-constitution.md" | head -1 | sed 's/.*v\([0-9.]*\).*/\1/')
+
+    local templates=(
+        "$REPO_ROOT/.claude/docs/templates/PRD_TEMPLATE.md"
+        "$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+        "$REPO_ROOT/.claude/docs/templates/TASKS_TEMPLATE.md"
+    )
+
+    for template in "${templates[@]}"; do
+        if grep -q "Constitution.*v" "$template"; then
+            # 使用精确的版本号匹配（v数字.数字.数字）
+            local template_version=$(grep -o "Constitution.*v[0-9]\+\.[0-9]\+\.[0-9]\+" "$template" | head -1 | grep -o "v[0-9]\+\.[0-9]\+\.[0-9]\+" | sed 's/v//')
+            if [[ -n "$template_version" ]]; then
+                assert_equals "$template_version" "$constitution_version" "$(basename "$template") should reference v$constitution_version"
+            fi
+        fi
+    done
+}
+
+test_templates_have_validation_checklists() {
+    local templates=(
+        "$REPO_ROOT/.claude/docs/templates/PRD_TEMPLATE.md"
+        "$REPO_ROOT/.claude/docs/templates/EPIC_TEMPLATE.md"
+    )
+
+    for template in "${templates[@]}"; do
+        # 检查是否有 checklist 格式的 Constitution checks
+        if grep -qE "Constitution Check|Constitution Compliance" "$template"; then
+            # 检查是否有 Article 相关的 checklist（罗马数字格式: I., II., III. 等）
+            local checklist_count=$(grep -cE "^- \[ \] \*\*(I{1,3}|IV|V|VI{0,3}|IX|X)\." "$template" 2>/dev/null || echo "0")
+            # 去除可能的空白字符和换行
+            checklist_count=$(echo "$checklist_count" | tr -d ' \n\r')
+            assert_gt "$checklist_count" "0" "$(basename "$template") should have Article checklist items"
+        fi
+    done
+}
+
+test_no_orphaned_old_templates() {
+    # 检查是否有旧版模板文件（如 v2.1.1 的 TASKS_TEMPLATE_OLD.md）
+    local templates_dir="$REPO_ROOT/.claude/docs/templates"
+    local old_templates=$(find "$templates_dir" -name "*_OLD.md" -o -name "*_old.md" -o -name "*.backup.md" 2>/dev/null || echo "")
+
+    if [[ -n "$old_templates" ]]; then
+        log_warning "Found old template files: $old_templates"
+        log_warning "Consider cleaning up old templates to avoid version confusion"
+        return 1
+    fi
+
+    # 如果没有旧模板，测试通过
+    return 0
+}
+
+# ============================================================================
+# 运行测试
+# ============================================================================
+
+run_tests \
+    test_prd_template_has_constitution_check \
+    test_epic_template_has_constitution_check \
+    test_tasks_template_has_constitution_alignment \
+    test_prd_template_has_article_references \
+    test_epic_template_has_phase_minus_one_gates \
+    test_tasks_template_has_tdd_enforcement \
+    test_epic_template_has_complexity_tracking \
+    test_all_templates_reference_current_version \
+    test_templates_have_validation_checklists \
+    test_no_orphaned_old_templates