moai-adk 0.10.1__py3-none-any.whl → 0.11.1__py3-none-any.whl

moai_adk/templates/workflows/go-tag-validation.yml

@@ -0,0 +1,130 @@
+# @CODE:LANG-001-GO | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/test_workflows.py
+# Go Project TAG Validation Workflow
+# Automatically validates TAGs with go test, golangci-lint, and coverage
+
+name: TAG Validation (Go)
+
+on:
+  push:
+    branches: [main, develop, feature/**]
+  pull_request:
+    branches: [main, develop]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    name: Validate TAGs - Go ${{ matrix.go-version }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        go-version: ['1.22', '1.23']
+      fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Go ${{ matrix.go-version }}
+        uses: actions/setup-go@v6
+        with:
+          go-version: ${{ matrix.go-version }}
+          cache: true
+
+      - name: Cache Go modules
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/go-build
+            ~/go/pkg/mod
+          key: go-${{ runner.os }}-${{ matrix.go-version }}-${{ hashFiles('**/go.sum') }}
+          restore-keys: |
+            go-${{ runner.os }}-${{ matrix.go-version }}-
+            go-${{ runner.os }}-
+
+      - name: Download dependencies
+        run: go mod download
+
+      - name: Verify dependencies
+        run: go mod verify
+
+      - name: Run go fmt
+        run: |
+          FMT_OUTPUT=$(gofmt -l .)
+          if [ -n "$FMT_OUTPUT" ]; then
+            echo "Files need formatting:"
+            echo "$FMT_OUTPUT"
+            exit 1
+          fi
+
+      - name: Run golangci-lint
+        uses: golangci/golangci-lint-action@v6
+        with:
+          version: latest
+          args: --timeout=5m
+
+      - name: Run tests with coverage
+        run: |
+          go test -v -race -coverprofile=coverage.out -covermode=atomic ./...
+          go tool cover -func=coverage.out
+
+      - name: Check coverage threshold
+        run: |
+          COVERAGE=$(go tool cover -func=coverage.out | grep total | awk '{print $3}' | sed 's/%//')
+          echo "Total coverage: ${COVERAGE}%"
+          if (( $(echo "$COVERAGE < 75" | bc -l) )); then
+            echo "❌ Coverage ${COVERAGE}% is below 75% threshold"
+            exit 1
+          fi
+          echo "✅ Coverage ${COVERAGE}% meets 75% threshold"
+
+      - name: Upload coverage reports
+        if: matrix.go-version == '1.23'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report-go
+          path: coverage.out
+
+      - name: Comment PR with coverage
+        if: github.event_name == 'pull_request' && matrix.go-version == '1.23'
+        uses: codecov/codecov-action@v5
+        with:
+          files: ./coverage.out
+          flags: go
+          fail_ci_if_error: false
+
+      - name: Run go vet
+        run: go vet ./...
+
+      - name: Build project
+        run: go build -v ./...
+
+  quality-gate:
+    name: Quality Gate Summary
+    needs: validate
+    runs-on: ubuntu-latest
+    if: always()
+
+    steps:
+      - name: Check validation results
+        run: |
+          if [ "${{ needs.validate.result }}" != "success" ]; then
+            echo "❌ TAG validation failed"
+            exit 1
+          fi
+          echo "✅ TAG validation passed"
+
+      - name: Quality metrics summary
+        run: |
+          echo "## Quality Metrics Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Go tests passed" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Code coverage ≥ 75%" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Linting passed (golangci-lint)" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Formatting checked (gofmt)" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Build successful" >> $GITHUB_STEP_SUMMARY

moai_adk/templates/workflows/javascript-tag-validation.yml

@@ -0,0 +1,135 @@
+# @CODE:LANG-001-JAVASCRIPT | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/test_workflows.py
+# JavaScript Project TAG Validation Workflow
+# Automatically validates TAGs in JavaScript projects with npm/yarn/pnpm auto-detection
+
+name: TAG Validation (JavaScript)
+
+on:
+  push:
+    branches: [main, develop, feature/**]
+  pull_request:
+    branches: [main, develop]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    name: Validate TAGs - Node ${{ matrix.node-version }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: ['20', '22']
+      fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Detect package manager
+        id: detect-pm
+        run: |
+          if [ -f "bun.lockb" ]; then
+            echo "manager=bun" >> $GITHUB_OUTPUT
+            echo "lockfile=bun.lockb" >> $GITHUB_OUTPUT
+          elif [ -f "pnpm-lock.yaml" ]; then
+            echo "manager=pnpm" >> $GITHUB_OUTPUT
+            echo "lockfile=pnpm-lock.yaml" >> $GITHUB_OUTPUT
+          elif [ -f "yarn.lock" ]; then
+            echo "manager=yarn" >> $GITHUB_OUTPUT
+            echo "lockfile=yarn.lock" >> $GITHUB_OUTPUT
+          else
+            echo "manager=npm" >> $GITHUB_OUTPUT
+            echo "lockfile=package-lock.json" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Setup package manager cache
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: ${{ steps.detect-pm.outputs.manager }}
+
+      - name: Install pnpm (if needed)
+        if: steps.detect-pm.outputs.manager == 'pnpm'
+        run: npm install -g pnpm
+
+      - name: Install Bun (if needed)
+        if: steps.detect-pm.outputs.manager == 'bun'
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: |
+          case "${{ steps.detect-pm.outputs.manager }}" in
+            npm)
+              npm ci
+              ;;
+            yarn)
+              yarn install --frozen-lockfile
+              ;;
+            pnpm)
+              pnpm install --frozen-lockfile
+              ;;
+            bun)
+              bun install --frozen-lockfile
+              ;;
+          esac
+
+      - name: Run linting
+        run: |
+          if [ -f "biome.json" ]; then
+            npx @biomejs/biome check src/
+          elif command -v eslint &> /dev/null; then
+            npm run lint || npx eslint src/
+          fi
+        continue-on-error: false
+
+      - name: Run tests with coverage
+        run: npm test -- --coverage --coverage-threshold=80
+        continue-on-error: false
+
+      - name: Upload coverage reports
+        if: matrix.node-version == '22'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report-javascript
+          path: coverage/
+
+      - name: Comment PR with coverage
+        if: github.event_name == 'pull_request' && matrix.node-version == '22'
+        uses: ArtiomTr/jest-coverage-report-action@v2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          threshold: 80
+
+  quality-gate:
+    name: Quality Gate Summary
+    needs: validate
+    runs-on: ubuntu-latest
+    if: always()
+
+    steps:
+      - name: Check validation results
+        run: |
+          if [ "${{ needs.validate.result }}" != "success" ]; then
+            echo "❌ TAG validation failed"
+            exit 1
+          fi
+          echo "✅ TAG validation passed"
+
+      - name: Quality metrics summary
+        run: |
+          echo "## Quality Metrics Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ JavaScript tests passed" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Code coverage ≥ 80%" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Linting passed" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ TAG chain validated" >> $GITHUB_STEP_SUMMARY

moai_adk/templates/workflows/python-tag-validation.yml

@@ -0,0 +1,118 @@
+# @CODE:LANG-001-PYTHON | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/test_workflows.py
+# Python Project TAG Validation Workflow
+# Automatically validates TAGs in Python projects with pytest, ruff, and mypy
+
+name: TAG Validation (Python)
+
+on:
+  push:
+    branches: [main, develop, feature/**]
+  pull_request:
+    branches: [main, develop]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    name: Validate TAGs - Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13']
+      fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Cache uv dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/uv
+          key: uv-${{ runner.os }}-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            uv-${{ runner.os }}-${{ matrix.python-version }}-
+            uv-${{ runner.os }}-
+
+      - name: Install dependencies with uv
+        run: uv sync --all-extras --dev
+
+      - name: Run TAG validation
+        run: |
+          uv run pytest tests/ -v \
+            --cov=src \
+            --cov-report=term-missing \
+            --cov-report=html:htmlcov \
+            --cov-report=xml:coverage.xml \
+            --cov-fail-under=85
+        continue-on-error: false
+
+      - name: Run linting with ruff
+        run: uv run ruff check src/ tests/
+        continue-on-error: false
+
+      - name: Run type checking with mypy
+        run: uv run mypy src/ --ignore-missing-imports
+        continue-on-error: true
+
+      - name: Upload coverage reports
+        if: matrix.python-version == '3.13'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report-python
+          path: |
+            htmlcov/
+            coverage.xml
+
+      - name: Comment PR with coverage
+        if: github.event_name == 'pull_request' && matrix.python-version == '3.13'
+        uses: py-cov-action/python-coverage-comment-action@v3
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          MINIMUM_GREEN: 85
+          MINIMUM_ORANGE: 75
+
+      - name: Check TAG chain integrity
+        run: |
+          echo "Validating TAG chain integrity..."
+          uv run python -m moai_adk.core.tags.validator --validate-chain
+        continue-on-error: true
+
+  quality-gate:
+    name: Quality Gate Summary
+    needs: validate
+    runs-on: ubuntu-latest
+    if: always()
+
+    steps:
+      - name: Check validation results
+        run: |
+          if [ "${{ needs.validate.result }}" != "success" ]; then
+            echo "❌ TAG validation failed"
+            exit 1
+          fi
+          echo "✅ TAG validation passed"
+
+      - name: Quality metrics summary
+        run: |
+          echo "## Quality Metrics Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Python tests passed" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Code coverage ≥ 85%" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Linting passed (ruff)" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Type checking passed (mypy)" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ TAG chain validated" >> $GITHUB_STEP_SUMMARY

moai_adk/templates/workflows/typescript-tag-validation.yml

@@ -0,0 +1,154 @@
+# @CODE:LANG-001-TYPESCRIPT | SPEC: SPEC-LANGUAGE-DETECTION-001.md | TEST: tests/test_workflows.py
+# TypeScript Project TAG Validation Workflow
+# Automatically validates TAGs with type checking, linting, and testing
+
+name: TAG Validation (TypeScript)
+
+on:
+  push:
+    branches: [main, develop, feature/**]
+  pull_request:
+    branches: [main, develop]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    name: Validate TAGs - Node ${{ matrix.node-version }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: ['20', '22']
+      fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Detect package manager
+        id: detect-pm
+        run: |
+          if [ -f "bun.lockb" ]; then
+            echo "manager=bun" >> $GITHUB_OUTPUT
+            echo "lockfile=bun.lockb" >> $GITHUB_OUTPUT
+          elif [ -f "pnpm-lock.yaml" ]; then
+            echo "manager=pnpm" >> $GITHUB_OUTPUT
+            echo "lockfile=pnpm-lock.yaml" >> $GITHUB_OUTPUT
+          elif [ -f "yarn.lock" ]; then
+            echo "manager=yarn" >> $GITHUB_OUTPUT
+            echo "lockfile=yarn.lock" >> $GITHUB_OUTPUT
+          else
+            echo "manager=npm" >> $GITHUB_OUTPUT
+            echo "lockfile=package-lock.json" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Setup package manager cache
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: ${{ steps.detect-pm.outputs.manager }}
+
+      - name: Install pnpm (if needed)
+        if: steps.detect-pm.outputs.manager == 'pnpm'
+        run: npm install -g pnpm
+
+      - name: Install Bun (if needed)
+        if: steps.detect-pm.outputs.manager == 'bun'
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: |
+          case "${{ steps.detect-pm.outputs.manager }}" in
+            npm)
+              npm ci
+              ;;
+            yarn)
+              yarn install --frozen-lockfile
+              ;;
+            pnpm)
+              pnpm install --frozen-lockfile
+              ;;
+            bun)
+              bun install --frozen-lockfile
+              ;;
+          esac
+
+      - name: Run type checking
+        run: |
+          if [ -f "tsconfig.json" ]; then
+            npx tsc --noEmit
+          else
+            npm run type-check || npx tsc --noEmit
+          fi
+        continue-on-error: false
+
+      - name: Run linting
+        run: |
+          if [ -f "biome.json" ]; then
+            npx @biomejs/biome check src/
+          elif command -v eslint &> /dev/null; then
+            npm run lint || npx eslint src/
+          fi
+        continue-on-error: false
+
+      - name: Run tests with coverage
+        run: npm test -- --coverage --coverage-threshold=85
+        continue-on-error: false
+
+      - name: Upload coverage reports
+        if: matrix.node-version == '22'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report-typescript
+          path: coverage/
+
+      - name: Comment PR with coverage
+        if: github.event_name == 'pull_request' && matrix.node-version == '22'
+        uses: ArtiomTr/jest-coverage-report-action@v2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          threshold: 85
+
+      - name: Build project
+        run: |
+          if grep -q '"build"' package.json; then
+            npm run build
+          else
+            npx tsc
+          fi
+        continue-on-error: true
+
+  quality-gate:
+    name: Quality Gate Summary
+    needs: validate
+    runs-on: ubuntu-latest
+    if: always()
+
+    steps:
+      - name: Check validation results
+        run: |
+          if [ "${{ needs.validate.result }}" != "success" ]; then
+            echo "❌ TAG validation failed"
+            exit 1
+          fi
+          echo "✅ TAG validation passed"
+
+      - name: Quality metrics summary
+        run: |
+          echo "## Quality Metrics Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ TypeScript tests passed" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Type checking passed (tsc)" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Code coverage ≥ 85%" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Linting passed" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ TAG chain validated" >> $GITHUB_STEP_SUMMARY

{moai_adk-0.10.1.dist-info → moai_adk-0.11.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.10.1
+Version: 0.11.1
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -14,17 +14,21 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
-Requires-Python: >=3.13
+Requires-Python: >=3.11
 Requires-Dist: click>=8.1.0
 Requires-Dist: gitpython>=3.1.45
+Requires-Dist: jinja2>=3.0.0
 Requires-Dist: packaging>=21.0
 Requires-Dist: pyfiglet>=1.0.2
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: questionary>=2.0.0
+Requires-Dist: requests>=2.28.0
 Requires-Dist: rich>=13.0.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.7.0; extra == 'dev'
@@ -158,6 +162,22 @@ From the moment you adopt MoAI-ADK, you'll feel:
 
 ---
 
+## 🖥️ Platform Support
+
+### Supported Platforms
+- ✅ **macOS** (11.0+)
+- ✅ **Linux** (Ubuntu 20.04+, Debian 11+, etc.)
+- ✅ **Windows** (10/11) - Full support as of v0.11.0
+  - Note: Hooks system requires Python 3.11+
+  - All hook features work seamlessly on Windows with cross-platform timeout handling
+
+### System Requirements
+- **Python**: 3.11 or higher
+- **Git**: 2.30+
+- **GitHub CLI** (`gh`): Optional, required for PR automation in team mode
+
+---
+
 ## ⚡ 3-Minute Lightning Start
 
 Get your first MoAI-ADK project running in **3 simple steps**. Beginners can finish in under 5 minutes.
@@ -299,6 +319,48 @@ In this section you'll experience:
 
 ---
 
+## Language Support
+
+MoAI-ADK automatically detects and supports **15 programming languages** with dedicated CI/CD workflows:
+
+### Core Languages (v0.11.0+)
+- **Python** (pytest, mypy, ruff, 85% coverage target)
+- **JavaScript** (npm/yarn/pnpm/bun auto-detect, 80% coverage target)
+- **TypeScript** (tsc type checking, biome/eslint, 85% coverage target)
+- **Go** (golangci-lint, gofmt, 75% coverage target)
+
+### Extended Languages (v0.11.1+)
+- **Ruby** (RSpec, Rubocop, bundle)
+- **PHP** (PHPUnit, PHPCS, composer)
+- **Java** (JUnit 5, Jacoco, Maven/Gradle auto-detection)
+- **Rust** (cargo test, clippy, rustfmt)
+- **Dart** (flutter test, dart analyze)
+- **Swift** (XCTest, SwiftLint, SPM)
+- **Kotlin** (JUnit 5, ktlint, Gradle)
+- **C#** (xUnit, StyleCop, dotnet CLI)
+- **C** (gcc/clang, cppcheck, CMake)
+- **C++** (g++/clang++, Google Test, cpplint)
+- **Shell** (shellcheck, bats-core)
+
+### How Language Detection Works
+
+When you run `/alfred:2-run SPEC-XXX`, MoAI-ADK automatically:
+1. Scans your project for configuration files (package.json, pyproject.toml, go.mod, Cargo.toml, pom.xml, build.gradle, etc.)
+2. Detects your project's primary language using priority-based detection (Rust → Dart → Swift → ... → Shell)
+3. Auto-detects build tools (Maven/Gradle for Java, CMake for C/C++, SPM for Swift, etc.)
+4. Selects the appropriate CI/CD workflow template
+5. Generates language-specific testing and linting configuration
+
+### Supported Languages
+
+For detailed language detection priority and build tool detection, see [Language Detection Guide](.moai/docs/language-detection-guide.md)
+
+### Customization
+
+For advanced workflow customization, see [Workflow Templates Guide](.moai/docs/workflow-templates.md)
+
+---
+
 ## Earlier Detailed Guide (Optional Reading)
 
 Need more explanations? See detailed guides below.
@@ -390,11 +452,6 @@ my-project/
 │   ├── hooks/                      # Event-driven automation
 │   │   └── alfred/
 │   │       └── alfred_hooks.py     # 5 hooks (Session, PreTool, etc.)
-│   ├── output-styles/              # Response styles
-│   │   └── alfred/
-│   │       ├── agentic-coding.md       # Professional development mode
-│   │       ├── moai-adk-learning.md    # Educational explanations mode
-│   │       └── study-with-alfred.md    # Interactive learning mode
 │   └── settings.json               # Claude Code settings
 ├── src/                            # Implementation code
 ├── tests/                          # Test code
@@ -1770,7 +1827,7 @@ The **implementation-planner** Sub-agent decides:
 
 ```python
 # tests/test_todo_api.py
-# @TEST:TODO-001 | SPEC: SPEC-TODO-001.md
+# @TEST:README-EXAMPLE-TODO | SPEC: SPEC-TODO-001.md
 
 import pytest
 from src.todo.api import create_todo, get_todos
@@ -1911,7 +1968,7 @@ git commit -m "♻️ refactor(TODO-001): add database models and validation"
 
    ```bash
    ✅ @SPEC:TODO-001 → .moai/specs/SPEC-TODO-001/spec.md
-   ✅ @TEST:TODO-001 → tests/test_todo_api.py
+   ✅ @TEST:README-EXAMPLE-TODO → tests/test_todo_api.py
    ✅ @CODE:TODO-001 → src/todo/ (3 files)
    ✅ @DOC:TODO-001 → docs/api/todo.md (auto-generated)
 
@@ -1937,7 +1994,7 @@ git commit -m "♻️ refactor(TODO-001): add database models and validation"
    - Request: {"title": "string (1-200 chars)"}
    - Response: 201 Created with todo object
    - Implemented in: @CODE:TODO-001:API
-   - Tested in: @TEST:TODO-001
+   - Tested in: @TEST:README-EXAMPLE-TODO
 
    ### Get All Todos
 
@@ -1988,7 +2045,7 @@ rg '@(SPEC|TEST|CODE|DOC):TODO-001' -n
 
 # Output:
 # .moai/specs/SPEC-TODO-001/spec.md:1: # @SPEC:TODO-001: Todo Management API
-# tests/test_todo_api.py:2: # @TEST:TODO-001 | SPEC: SPEC-TODO-001.md
+# tests/test_todo_api.py:2: # @TEST:README-EXAMPLE-TODO | SPEC: SPEC-TODO-001.md
 # src/todo/api.py:5: # @CODE:TODO-001:API | SPEC: SPEC-TODO-001.md
 # src/todo/models.py:5: # @CODE:TODO-001:MODEL | SPEC: SPEC-TODO-001.md
 # docs/api/todo.md:1: # @DOC:TODO-001: Todo Management API
@@ -2028,7 +2085,7 @@ git log --oneline | head -5
    └─ 🔴 RED: Tests written first
    └─ 🟢 GREEN: Minimal implementation
    └─ ♻️ REFACTOR: Quality improvement
-   └─ @TEST:TODO-001, @CODE:TODO-001 TAGs assigned
+   └─ @TEST:README-EXAMPLE-TODO, @CODE:TODO-001 TAGs assigned
    └─ 87% coverage, TRUST 5 principles verified
 
 ✅ Documentation sync (1 minute)
@@ -2599,7 +2656,7 @@ rg '@SPEC:HELLO-001' -n .moai/specs/
 /alfred:1-plan "feature description"
 
 # Or fix TAG in test file
-# Edit tests/test_hello.py: @TEST:HELLO-001 → @TEST:HELLO-002
+# Edit tests/test_hello.py: @TEST:HELLO-001 → @TEST:README-EXAMPLE-HELLO
 
 # 4. Sync
 /alfred:3-sync