bmad-method-test-architecture-enterprise 1.2.2 → 1.2.3

package/src/workflows/testarch/ci/checklist.md

@@ -4,11 +4,23 @@
 
 - [ ] Git repository initialized (`.git/` exists)
 - [ ] Git remote configured (`git remote -v` shows origin)
-- [ ] Test framework configured (`playwright.config._` or `cypress.config._`)
-- [ ] Local tests pass (`npm run test:e2e` succeeds)
+- [ ] Test framework configured (appropriate config for detected stack type)
+- [ ] Local tests pass (test command succeeds)
 - [ ] Team agrees on CI platform
 - [ ] Access to CI platform settings (if updating)
 
+### Multi-Stack Detection
+
+- [ ] Test stack type detected or configured (`frontend`, `backend`, `fullstack`)
+- [ ] Test framework detected or configured (Playwright, Cypress, Jest, Vitest, etc.)
+- [ ] Stack-appropriate test commands identified
+
+### Multi-Platform Detection
+
+- [ ] CI platform detected or configured
+- [ ] Supported platform: GitHub Actions, GitLab CI, Jenkins, Azure DevOps, Harness, or Circle CI
+- [ ] Platform-specific template selected
+
 Note: CI setup is typically a one-time task per repo and can be run any time after the test framework is configured.
 
 ## Process Steps
@@ -24,11 +36,21 @@ Note: CI setup is typically a one-time task per repo and can be run any time aft
 
 ### Step 2: CI Pipeline Configuration
 
-- [ ] CI configuration file created (`.github/workflows/test.yml` or `.gitlab-ci.yml`)
-- [ ] File is syntactically valid (no YAML errors)
-- [ ] Correct framework commands configured
+- [ ] CI configuration file created at platform-correct path
+  - GitHub Actions: `.github/workflows/test.yml`
+  - GitLab CI: `.gitlab-ci.yml`
+  - Jenkins: `Jenkinsfile`
+  - Azure DevOps: `azure-pipelines.yml`
+  - Harness: `.harness/pipeline.yaml`
+  - Circle CI: `.circleci/config.yml`
+- [ ] File is syntactically valid (no YAML/Groovy errors)
+- [ ] Correct framework commands configured for detected stack type
 - [ ] Node version matches project
 - [ ] Test directory paths correct
+- [ ] Stack-conditional steps applied:
+  - [ ] Browser install included for frontend/fullstack stacks
+  - [ ] Browser install omitted for backend-only stacks
+  - [ ] Test commands match detected framework
 
 ### Step 3: Parallel Sharding
 
@@ -39,11 +61,12 @@ Note: CI setup is typically a one-time task per repo and can be run any time aft
 
 ### Step 4: Burn-In Loop
 
-- [ ] Burn-in job created
-- [ ] 10 iterations configured
+- [ ] Burn-in job created (frontend/fullstack stacks) or intentionally skipped (backend-only)
+- [ ] 10 iterations configured (when enabled)
 - [ ] Proper exit on failure (`|| exit 1`)
 - [ ] Runs on appropriate triggers (PR, cron)
 - [ ] Failure artifacts uploaded
+- [ ] Backend-only stacks: burn-in skipped by default (documented reason: targets UI flakiness)
 
 ### Step 5: Caching Configuration
 
@@ -237,6 +260,24 @@ If workflow fails:
 - Runners: Shared or project-specific
 - Pipeline quota: 400 minutes/month free tier
 
+**Jenkins:**
+
+- Credentials: Manage Jenkins → Manage Credentials
+- Agents: Configure build agents with Node.js
+- Plugins: Pipeline, JUnit, HTML Publisher recommended
+
+**Azure DevOps:**
+
+- Variables: Pipelines → Library → Variable groups
+- Agent pools: Azure-hosted or self-hosted
+- Parallel jobs: 1 free (Microsoft-hosted)
+
+**Harness:**
+
+- Connectors: Configure container registry and code repo connectors
+- Delegates: Install Harness delegate in target infrastructure
+- Steps: Use Run steps with appropriate container images
+
 ---
 
 **Checklist Complete**: Sign off when all items validated.

package/src/workflows/testarch/ci/github-actions-template.yaml

@@ -1,6 +1,14 @@
 # GitHub Actions CI/CD Pipeline for Test Execution
 # Generated by BMad TEA Agent - Test Architect Module
-# Optimized for: Playwright/Cypress, Parallel Sharding, Burn-In Loop
+# Optimized for: Parallel Sharding, Burn-In Loop
+# Stack: {test_stack_type} | Framework: {test_framework}
+#
+# Variables to customize per project:
+#   INSTALL_CMD       - dependency install command (e.g., npm ci, pnpm install --frozen-lockfile, yarn --frozen-lockfile)
+#   TEST_CMD          - main test command (e.g., npm run test:e2e, npm test, npx vitest)
+#   LINT_CMD          - lint command (e.g., npm run lint)
+#   BROWSER_INSTALL   - browser install command (frontend/fullstack only; omit for backend)
+#   BROWSER_CACHE_PATH - browser cache path (frontend/fullstack only; omit for backend)
 
 name: Test Pipeline
 
@@ -45,10 +53,10 @@ jobs:
           cache: "npm"
 
       - name: Install dependencies
-        run: npm ci
+        run: npm ci # Replace with INSTALL_CMD
 
       - name: Run linter
-        run: npm run lint
+        run: npm run lint # Replace with LINT_CMD
 
   # Test stage - Parallel execution with sharding
   test:
@@ -91,13 +99,14 @@ jobs:
             ${{ runner.os }}-playwright-
 
       - name: Install dependencies
-        run: npm ci
+        run: npm ci # Replace with INSTALL_CMD
 
+      # Frontend/Fullstack only — remove this step for backend-only stacks
       - name: Install Playwright browsers
-        run: npx playwright install --with-deps chromium
+        run: npx playwright install --with-deps chromium # Replace with BROWSER_INSTALL
 
       - name: Run tests (shard ${{ matrix.shard }}/4)
-        run: npm run test:e2e -- --shard=${{ matrix.shard }}/4
+        run: npm run test:e2e -- --shard=${{ matrix.shard }}/4 # Replace with TEST_CMD + shard args
 
       - name: Upload test results
         if: failure()
@@ -138,18 +147,21 @@ jobs:
           node-version: ${{ steps.node-version.outputs.value }}
           cache: "npm"
 
+      # Frontend/Fullstack only — remove this step for backend-only stacks
       - name: Cache Playwright browsers
         uses: actions/cache@v4
         with:
-          path: ~/.cache/ms-playwright
+          path: ~/.cache/ms-playwright # Replace with BROWSER_CACHE_PATH
           key: ${{ runner.os }}-playwright-${{ hashFiles('**/package-lock.json') }}
 
       - name: Install dependencies
-        run: npm ci
+        run: npm ci # Replace with INSTALL_CMD
 
+      # Frontend/Fullstack only — remove this step for backend-only stacks
       - name: Install Playwright browsers
-        run: npx playwright install --with-deps chromium
+        run: npx playwright install --with-deps chromium # Replace with BROWSER_INSTALL
 
+      # Note: Burn-in targets UI flakiness. For backend-only stacks, remove this job entirely.
       - name: Run burn-in loop (10 iterations)
         run: |
           echo "🔥 Starting burn-in loop - detecting flaky tests"
@@ -157,7 +169,7 @@ jobs:
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
             echo "🔥 Burn-in iteration $i/10"
             echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-            npm run test:e2e || exit 1
+            npm run test:e2e || exit 1  # Replace with TEST_CMD
           done
           echo "✅ Burn-in complete - no flaky tests detected"
 

package/src/workflows/testarch/ci/gitlab-ci-template.yaml

@@ -1,6 +1,14 @@
 # GitLab CI/CD Pipeline for Test Execution
 # Generated by BMad TEA Agent - Test Architect Module
-# Optimized for: Playwright/Cypress, Parallel Sharding, Burn-In Loop
+# Optimized for: Parallel Sharding, Burn-In Loop
+# Stack: {test_stack_type} | Framework: {test_framework}
+#
+# Variables to customize per project:
+#   INSTALL_CMD       - dependency install command (e.g., npm ci, pnpm install --frozen-lockfile)
+#   TEST_CMD          - main test command (e.g., npm run test:e2e, npm test, npx vitest)
+#   LINT_CMD          - lint command (e.g., npm run lint)
+#   BROWSER_INSTALL   - browser install command (frontend/fullstack only; omit for backend)
+#   BROWSER_CACHE_PATH - browser cache path (frontend/fullstack only; omit for backend)
 
 stages:
   - lint
@@ -39,9 +47,9 @@ lint:
       npm install -g n
       n "$NODE_VERSION"
       node -v
-    - npm ci
+    - npm ci # Replace with INSTALL_CMD
   script:
-    - npm run lint
+    - npm run lint # Replace with LINT_CMD
   timeout: 5 minutes
 
 # Test stage - Parallel execution with sharding
@@ -57,8 +65,8 @@ lint:
       npm install -g n
       n "$NODE_VERSION"
       node -v
-    - npm ci
-    - npx playwright install --with-deps chromium
+    - npm ci # Replace with INSTALL_CMD
+    - npx playwright install --with-deps chromium # Replace with BROWSER_INSTALL; remove for backend-only
   artifacts:
     when: on_failure
     paths:
@@ -70,22 +78,22 @@ lint:
 test:shard-1:
   <<: *test-template
   script:
-    - npm run test:e2e -- --shard=1/4
+    - npm run test:e2e -- --shard=1/4 # Replace with TEST_CMD + shard args
 
 test:shard-2:
   <<: *test-template
   script:
-    - npm run test:e2e -- --shard=2/4
+    - npm run test:e2e -- --shard=2/4 # Replace with TEST_CMD + shard args
 
 test:shard-3:
   <<: *test-template
   script:
-    - npm run test:e2e -- --shard=3/4
+    - npm run test:e2e -- --shard=3/4 # Replace with TEST_CMD + shard args
 
 test:shard-4:
   <<: *test-template
   script:
-    - npm run test:e2e -- --shard=4/4
+    - npm run test:e2e -- --shard=4/4 # Replace with TEST_CMD + shard args
 
 # Burn-in stage - Flaky test detection
 burn-in:
@@ -107,8 +115,9 @@ burn-in:
       npm install -g n
       n "$NODE_VERSION"
       node -v
-    - npm ci
-    - npx playwright install --with-deps chromium
+    - npm ci # Replace with INSTALL_CMD
+    - npx playwright install --with-deps chromium # Replace with BROWSER_INSTALL; remove for backend-only
+  # Note: Burn-in targets UI flakiness. For backend-only stacks, remove this job entirely.
   script:
     - |
       echo "🔥 Starting burn-in loop - detecting flaky tests"
@@ -116,7 +125,7 @@ burn-in:
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
         echo "🔥 Burn-in iteration $i/10"
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-        npm run test:e2e || exit 1
+        npm run test:e2e || exit 1  # Replace with TEST_CMD
       done
       echo "✅ Burn-in complete - no flaky tests detected"
   artifacts:

package/src/workflows/testarch/ci/harness-pipeline-template.yaml

@@ -0,0 +1,159 @@
+# Harness CI Pipeline for Test Execution
+# Generated by BMad TEA Agent - Test Architect Module
+# Optimized for: Parallel Sharding, Burn-In Loop
+# Stack: {test_stack_type} | Framework: {test_framework}
+#
+# Variables to customize per project:
+#   INSTALL_CMD       - dependency install command (e.g., npm ci, pnpm install --frozen-lockfile)
+#   TEST_CMD          - main test command (e.g., npm run test:e2e, npm test, npx vitest)
+#   LINT_CMD          - lint command (e.g., npm run lint)
+#   BROWSER_INSTALL   - browser install command (frontend/fullstack only; omit for backend)
+
+pipeline:
+  name: Test Pipeline
+  identifier: test_pipeline
+  projectIdentifier: default
+  orgIdentifier: default
+  stages:
+    # Lint stage - Code quality checks
+    - stage:
+        name: Lint
+        identifier: lint
+        type: CI
+        spec:
+          cloneCodebase: true
+          infrastructure:
+            type: KubernetesDirect
+            spec:
+              connectorRef: account.harnessImage
+              namespace: default
+          execution:
+            steps:
+              - step:
+                  type: Run
+                  name: Install dependencies
+                  identifier: install
+                  spec:
+                    connectorRef: account.harnessImage
+                    image: node:24
+                    shell: Sh
+                    command: npm ci # Replace with INSTALL_CMD
+
+              - step:
+                  type: Run
+                  name: Run linter
+                  identifier: lint
+                  spec:
+                    connectorRef: account.harnessImage
+                    image: node:24
+                    shell: Sh
+                    command: npm run lint # Replace with LINT_CMD
+
+    # Test stage - Parallel execution with sharding
+    - stage:
+        name: Test
+        identifier: test
+        type: CI
+        spec:
+          cloneCodebase: true
+          infrastructure:
+            type: KubernetesDirect
+            spec:
+              connectorRef: account.harnessImage
+              namespace: default
+          execution:
+            steps:
+              - step:
+                  type: Run
+                  name: Install dependencies
+                  identifier: install
+                  spec:
+                    connectorRef: account.harnessImage
+                    image: node:24
+                    shell: Sh
+                    command: npm ci # Replace with INSTALL_CMD
+
+              # Frontend/Fullstack only — remove this step for backend-only stacks
+              - step:
+                  type: Run
+                  name: Install browsers
+                  identifier: browsers
+                  spec:
+                    connectorRef: account.harnessImage
+                    image: mcr.microsoft.com/playwright:v1.50.0-noble
+                    shell: Sh
+                    command: npx playwright install --with-deps chromium # Replace with BROWSER_INSTALL
+
+              - parallel:
+                  - step:
+                      type: Run
+                      name: Test Shard 1
+                      identifier: shard_1
+                      spec:
+                        connectorRef: account.harnessImage
+                        image: mcr.microsoft.com/playwright:v1.50.0-noble
+                        shell: Sh
+                        command: npm run test:e2e -- --shard=1/4 # Replace with TEST_CMD + shard args
+                  - step:
+                      type: Run
+                      name: Test Shard 2
+                      identifier: shard_2
+                      spec:
+                        connectorRef: account.harnessImage
+                        image: mcr.microsoft.com/playwright:v1.50.0-noble
+                        shell: Sh
+                        command: npm run test:e2e -- --shard=2/4 # Replace with TEST_CMD + shard args
+                  - step:
+                      type: Run
+                      name: Test Shard 3
+                      identifier: shard_3
+                      spec:
+                        connectorRef: account.harnessImage
+                        image: mcr.microsoft.com/playwright:v1.50.0-noble
+                        shell: Sh
+                        command: npm run test:e2e -- --shard=3/4 # Replace with TEST_CMD + shard args
+                  - step:
+                      type: Run
+                      name: Test Shard 4
+                      identifier: shard_4
+                      spec:
+                        connectorRef: account.harnessImage
+                        image: mcr.microsoft.com/playwright:v1.50.0-noble
+                        shell: Sh
+                        command: npm run test:e2e -- --shard=4/4 # Replace with TEST_CMD + shard args
+
+    # Burn-in stage - Flaky test detection
+    # Note: Burn-in targets UI flakiness. For backend-only stacks, remove this stage entirely.
+    - stage:
+        name: Burn-In
+        identifier: burn_in
+        type: CI
+        when:
+          condition: <+pipeline.triggerType> == "WEBHOOK" || <+pipeline.triggerType> == "SCHEDULER"
+        spec:
+          cloneCodebase: true
+          infrastructure:
+            type: KubernetesDirect
+            spec:
+              connectorRef: account.harnessImage
+              namespace: default
+          execution:
+            steps:
+              - step:
+                  type: Run
+                  name: Install and burn-in
+                  identifier: burn_in_loop
+                  spec:
+                    connectorRef: account.harnessImage
+                    image: mcr.microsoft.com/playwright:v1.50.0-noble
+                    shell: Sh
+                    command: |
+                      npm ci
+                      npx playwright install --with-deps chromium
+                      echo "Starting burn-in loop - detecting flaky tests"
+                      for i in $(seq 1 10); do
+                        echo "Burn-in iteration $i/10"
+                        npm run test:e2e || exit 1
+                      done
+                      echo "Burn-in complete - no flaky tests detected"
+                    # Replace npm ci with INSTALL_CMD, npm run test:e2e with TEST_CMD

package/src/workflows/testarch/ci/jenkins-pipeline-template.groovy

@@ -0,0 +1,129 @@
+// Jenkinsfile CI/CD Pipeline for Test Execution
+// Generated by BMad TEA Agent - Test Architect Module
+// Optimized for: Parallel Sharding, Burn-In Loop
+// Stack: {test_stack_type} | Framework: {test_framework}
+//
+// Variables to customize per project:
+//   INSTALL_CMD       - dependency install command (e.g., npm ci, pnpm install --frozen-lockfile)
+//   TEST_CMD          - main test command (e.g., npm run test:e2e, npm test, npx vitest)
+//   LINT_CMD          - lint command (e.g., npm run lint)
+//   BROWSER_INSTALL   - browser install command (frontend/fullstack only; omit for backend)
+//
+// Node.js version management — choose one:
+//   Option A (recommended): Configure NodeJS Plugin in Jenkins Global Tool Configuration,
+//     then add to pipeline:  tools { nodejs 'NodeJS-24' }
+//   Option B: Use nvm (pre-installed on agent) — this template uses nvm as the default
+//   Option C: Use a Docker agent — agent { docker { image 'node:24' } }
+
+pipeline {
+    agent any
+
+    environment {
+        CI = 'true'
+    }
+
+    options {
+        timeout(time: 45, unit: 'MINUTES')
+        disableConcurrentBuilds()
+    }
+
+    stages {
+        stage('Checkout') {
+            steps {
+                checkout scm
+            }
+        }
+
+        stage('Install') {
+            steps {
+                // Detect and apply Node.js version from .nvmrc (falls back to v24)
+                // If using NodeJS Plugin instead, remove this block and add: tools { nodejs 'NodeJS-24' }
+                sh '''
+                    export NVM_DIR="$HOME/.nvm"
+                    [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
+                    NODE_VERSION=$(cat .nvmrc 2>/dev/null || echo "24")
+                    nvm install "$NODE_VERSION" 2>/dev/null || true
+                    nvm use "$NODE_VERSION" 2>/dev/null || true
+                    node --version
+                    npm ci
+                ''' // Replace npm ci with INSTALL_CMD
+                // Stash installed dependencies so parallel shards can restore them
+                stash includes: 'node_modules/**', name: 'deps'
+            }
+        }
+
+        stage('Lint') {
+            steps {
+                sh 'npm run lint' // Replace with LINT_CMD
+            }
+        }
+
+        // Test stage - Parallel execution with sharding
+        // Each shard restores dependencies via unstash for workspace safety
+        stage('Test') {
+            parallel {
+                stage('Shard 1') {
+                    steps {
+                        unstash 'deps'
+                        // Frontend/Fullstack only — remove browser install for backend-only stacks
+                        sh 'npx playwright install --with-deps chromium' // Replace with BROWSER_INSTALL
+                        sh 'npm run test:e2e -- --shard=1/4' // Replace with TEST_CMD + shard args
+                    }
+                }
+                stage('Shard 2') {
+                    steps {
+                        unstash 'deps'
+                        sh 'npx playwright install --with-deps chromium' // Replace with BROWSER_INSTALL
+                        sh 'npm run test:e2e -- --shard=2/4' // Replace with TEST_CMD + shard args
+                    }
+                }
+                stage('Shard 3') {
+                    steps {
+                        unstash 'deps'
+                        sh 'npx playwright install --with-deps chromium' // Replace with BROWSER_INSTALL
+                        sh 'npm run test:e2e -- --shard=3/4' // Replace with TEST_CMD + shard args
+                    }
+                }
+                stage('Shard 4') {
+                    steps {
+                        unstash 'deps'
+                        sh 'npx playwright install --with-deps chromium' // Replace with BROWSER_INSTALL
+                        sh 'npm run test:e2e -- --shard=4/4' // Replace with TEST_CMD + shard args
+                    }
+                }
+            }
+        }
+
+        // Burn-in stage - Flaky test detection
+        // Note: Burn-in targets UI flakiness. For backend-only stacks, remove this stage entirely.
+        stage('Burn-In') {
+            when {
+                anyOf {
+                    changeRequest()
+                    triggeredBy 'TimerTrigger'
+                }
+            }
+            steps {
+                sh '''
+                    echo "Starting burn-in loop - detecting flaky tests"
+                    for i in $(seq 1 10); do
+                        echo "Burn-in iteration $i/10"
+                        npm run test:e2e || exit 1
+                    done
+                    echo "Burn-in complete - no flaky tests detected"
+                ''' // Replace npm run test:e2e with TEST_CMD
+            }
+        }
+    }
+
+    post {
+        always {
+            // Archive test results and reports
+            archiveArtifacts artifacts: 'test-results/**,playwright-report/**', allowEmptyArchive: true
+            junit testResults: 'test-results/**/*.xml', allowEmptyResults: true
+        }
+        failure {
+            echo 'Pipeline failed - check test results and artifacts'
+        }
+    }
+}

package/src/workflows/testarch/ci/steps-c/step-01-preflight.md

@@ -45,43 +45,84 @@ If missing: **HALT** with "Git repository required for CI/CD setup."
 
 ---
 
-## 2. Verify Test Framework
+## 2. Detect Test Stack Type
 
-- `playwright.config.*` or `cypress.config.*` exists
-- Framework installed in `package.json`
+Determine the project's test stack type (`test_stack_type`) using the following algorithm:
+
+1. If `test_stack_type` is explicitly set in config (not `"auto"`), use that value.
+2. Otherwise, auto-detect by scanning project manifests:
+   - **Frontend indicators**: `playwright.config.*`, `cypress.config.*`, `vite.config.*`, `next.config.*`, `src/components/`, `src/pages/`, `src/app/`
+   - **Backend indicators**: `pyproject.toml`, `pom.xml`/`build.gradle`, `go.mod`, `*.csproj`/`*.sln`, `Gemfile`, `Cargo.toml`, `jest.config.*`, `vitest.config.*`, `src/routes/`, `src/controllers/`, `src/api/`, `Dockerfile`, `serverless.yml`
+   - **Both present** → `fullstack`
+   - **Only frontend** → `frontend`
+   - **Only backend** → `backend`
+   - **Cannot determine** → default to `fullstack` and note assumption
+
+Record detected `test_stack_type` in step output.
+
+---
+
+## 3. Verify Test Framework
+
+- Check for framework configuration based on detected stack:
+  - **Frontend/Fullstack**: `playwright.config.*` or `cypress.config.*` exists
+  - **Backend (Node.js)**: `jest.config.*` or `vitest.config.*` or test scripts in `package.json`
+  - **Backend (Python)**: `pyproject.toml` with `[tool.pytest]` or `pytest.ini` or `setup.cfg` with pytest config
+  - **Backend (Java/Kotlin)**: `pom.xml` with surefire/failsafe plugins or `build.gradle` with test task
+  - **Backend (Go)**: `*_test.go` files present (Go convention — no config file needed)
+  - **Backend (C#/.NET)**: `*.csproj` with xUnit/NUnit/MSTest references
+  - **Backend (Ruby)**: `Gemfile` with rspec or `.rspec` config file
+- If `test_framework` is `"auto"`, detect from config files and project manifests found
+- Verify test dependencies are installed (language-appropriate package manager)
 
 If missing: **HALT** with "Run `framework` workflow first."
 
 ---
 
-## 3. Ensure Tests Pass Locally
+## 4. Ensure Tests Pass Locally
 
-- Run the main test command (e.g., `npm run test:e2e`)
+- Run the main test command based on detected stack and framework:
+  - **Node.js**: `npm test` or `npm run test:e2e`
+  - **Python**: `pytest` or `python -m pytest`
+  - **Java**: `mvn test` or `gradle test`
+  - **Go**: `go test ./...`
+  - **C#/.NET**: `dotnet test`
+  - **Ruby**: `bundle exec rspec`
 - If failing: **HALT** and request fixes before CI setup
 
 ---
 
-## 4. Detect CI Platform
+## 5. Detect CI Platform
 
-- Check for existing CI config:
-  - `.github/workflows/*.yml` (GitHub Actions)
-  - `.gitlab-ci.yml` (GitLab CI)
-  - `.circleci/config.yml` (Circle CI)
-  - `Jenkinsfile`
+- If `ci_platform` is explicitly set in config (not `"auto"`), use that value.
+- Otherwise, scan for existing CI configuration files:
+  - `.github/workflows/*.yml` → `github-actions`
+  - `.gitlab-ci.yml` → `gitlab-ci`
+  - `Jenkinsfile` → `jenkins`
+  - `azure-pipelines.yml` → `azure-devops`
+  - `.harness/*.yaml` → `harness`
+  - `.circleci/config.yml` → `circle-ci`
 - If found, ask whether to update or replace
-- If not found, infer from git remote (github.com → GitHub Actions)
-- Respect `ci_platform` if explicitly set
+- If not found, infer from git remote (github.com → `github-actions`, gitlab.com → `gitlab-ci`)
+- If still unresolved, default to `github-actions`
+
+Record detected `ci_platform` in step output.
 
 ---
 
-## 5. Read Environment Context
+## 6. Read Environment Context
 
-- Read `.nvmrc` if present (default to Node 24+ LTS if missing)
-- Read `package.json` for dependency caching strategy
+- Read environment context based on detected stack:
+  - **Node.js**: Read `.nvmrc` if present (default to Node 24+ LTS if missing); read `package.json` for dependency caching strategy
+  - **Python**: Read `.python-version` or `pyproject.toml` for Python version; note `pip`/`poetry`/`pipenv` for caching
+  - **Java**: Read `pom.xml`/`build.gradle` for Java version; note Maven/Gradle for caching
+  - **Go**: Read `go.mod` for Go version; note Go module cache path
+  - **C#/.NET**: Read `*.csproj`/`global.json` for .NET SDK version; note NuGet cache
+  - **Ruby**: Read `.ruby-version` or `Gemfile` for Ruby version; note Bundler cache
 
 ---
 
-### 6. Save Progress
+### 7. Save Progress
 
 **Save this step's accumulated work to `{outputFile}`.**