ai-sdlc 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/agents/implementation.d.ts

@@ -1,7 +1,85 @@
-import { AgentProgressCallback } from '../core/client.js';
-import { AgentResult } from '../types/index.js';
+import { runAgentQuery, AgentProgressCallback } from '../core/client.js';
+import { Story, AgentResult, TDDTestCycle } from '../types/index.js';
 import { AgentOptions } from './research.js';
 export type { AgentProgressCallback };
+/**
+ * Result from a TDD phase execution
+ */
+export interface TDDPhaseResult {
+    testName: string;
+    testFile: string;
+    timestamp: string;
+    output: string;
+    success: boolean;
+}
+/**
+ * Options for TDD phase execution (allows mocking for tests)
+ */
+export interface TDDPhaseOptions {
+    workingDir: string;
+    runAgentQuery?: typeof runAgentQuery;
+    onProgress?: AgentProgressCallback;
+}
+/**
+ * Options for full TDD implementation (allows mocking for tests)
+ */
+export interface TDDImplementationOptions {
+    runAgentQuery?: typeof runAgentQuery;
+    runSingleTest?: typeof runSingleTest;
+    runAllTests?: typeof runAllTests;
+    onProgress?: AgentProgressCallback;
+}
+export declare const TDD_SYSTEM_PROMPT = "You are practicing strict Test-Driven Development.\n\nYour workflow MUST follow this exact cycle:\n\n**RED Phase**:\n1. Write ONE test that expresses the next acceptance criterion\n2. The test MUST fail because the functionality doesn't exist\n3. Run the test and verify it fails\n4. Explain why it fails and what it's testing\n\n**GREEN Phase**:\n1. Write the MINIMUM code to make this ONE test pass\n2. Do NOT add extra features\n3. Run the test to verify it passes\n4. Run ALL tests to ensure nothing broke\n\n**REFACTOR Phase**:\n1. Look for improvements (DRY, clarity, performance)\n2. Make changes ONLY if tests stay green\n3. Run ALL tests after each change\n\nComplete one full cycle before starting the next test.\nNever write code before writing a test.\nNever write multiple tests before making the first one pass.";
+/**
+ * Run a single test file and return pass/fail result
+ */
+export declare function runSingleTest(testFile: string, workingDir: string, testTimeout: number): Promise<{
+    passed: boolean;
+    output: string;
+}>;
+/**
+ * Run all tests and return pass/fail result
+ */
+export declare function runAllTests(workingDir: string, testTimeout: number): Promise<{
+    passed: boolean;
+    output: string;
+}>;
+/**
+ * RED Phase: Write a failing test
+ *
+ * Creates a test that expresses the next acceptance criterion.
+ * The test MUST fail because the functionality doesn't exist yet.
+ */
+export declare function executeRedPhase(story: Story, cycleNumber: number, options: TDDPhaseOptions): Promise<TDDPhaseResult>;
+/**
+ * GREEN Phase: Write minimum code to pass the test
+ *
+ * Implements just enough code to make the failing test pass.
+ * Does NOT add extra features or optimizations.
+ */
+export declare function executeGreenPhase(story: Story, cycleNumber: number, testFile: string, options: TDDPhaseOptions): Promise<TDDPhaseResult>;
+/**
+ * REFACTOR Phase: Improve code while keeping tests green
+ *
+ * Improves code quality without changing behavior.
+ * All tests must remain passing after each change.
+ */
+export declare function executeRefactorPhase(story: Story, cycleNumber: number, testFile: string, options: TDDPhaseOptions): Promise<TDDPhaseResult>;
+/**
+ * Record a completed TDD cycle to the story frontmatter
+ */
+export declare function recordTDDCycle(cycleNumber: number, redResult: TDDPhaseResult, greenResult: TDDPhaseResult, refactorResult: TDDPhaseResult): TDDTestCycle;
+/**
+ * Check if all acceptance criteria have been covered (checked off)
+ */
+export declare function checkACCoverage(story: Story): boolean;
+/**
+ * Run the full TDD implementation loop
+ *
+ * Executes Red-Green-Refactor cycles until all acceptance criteria are covered
+ * or the maximum number of cycles is reached.
+ */
+export declare function runTDDImplementation(story: Story, sdlcRoot: string, options?: TDDImplementationOptions): Promise<AgentResult>;
 /**
  * Implementation Agent
  *

package/dist/agents/implementation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../src/agents/implementation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAS,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAgBtC;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA4GtB"}
+{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../src/agents/implementation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAa,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED,eAAO,MAAM,iBAAiB,8zBAuB+B,CAAC;AAgB9D;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgD9C;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgD9C;AAmDD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAqCzB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAoCzB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAwCzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,cAAc,EACzB,WAAW,EAAE,cAAc,EAC3B,cAAc,EAAE,cAAc,GAC7B,YAAY,CAYd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAuBrD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,WAAW,CAAC,CA2HtB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAgJtB"}

package/dist/agents/implementation.js

@@ -1,7 +1,32 @@
-import { execSync } from 'child_process';
+import { execSync, spawn } from 'child_process';
 import path from 'path';
 import { parseStory, writeStory, moveStory, updateStoryField } from '../core/story.js';
 import { runAgentQuery } from '../core/client.js';
+import { loadConfig, DEFAULT_TDD_CONFIG } from '../core/config.js';
+export const TDD_SYSTEM_PROMPT = `You are practicing strict Test-Driven Development.
+
+Your workflow MUST follow this exact cycle:
+
+**RED Phase**:
+1. Write ONE test that expresses the next acceptance criterion
+2. The test MUST fail because the functionality doesn't exist
+3. Run the test and verify it fails
+4. Explain why it fails and what it's testing
+
+**GREEN Phase**:
+1. Write the MINIMUM code to make this ONE test pass
+2. Do NOT add extra features
+3. Run the test to verify it passes
+4. Run ALL tests to ensure nothing broke
+
+**REFACTOR Phase**:
+1. Look for improvements (DRY, clarity, performance)
+2. Make changes ONLY if tests stay green
+3. Run ALL tests after each change
+
+Complete one full cycle before starting the next test.
+Never write code before writing a test.
+Never write multiple tests before making the first one pass.`;
 const IMPLEMENTATION_SYSTEM_PROMPT = `You are a senior software engineer implementing features based on a detailed plan. Your job is to execute each phase of the implementation plan.
 
 When implementing:
@@ -15,6 +40,415 @@ When implementing:
 8. Do NOT commit changes - that happens in the review phase
 
 You have access to tools for reading and writing files, running commands, and searching the codebase.`;
+/**
+ * Run a single test file and return pass/fail result
+ */
+export async function runSingleTest(testFile, workingDir, testTimeout) {
+    return new Promise((resolve) => {
+        const outputChunks = [];
+        let killed = false;
+        const child = spawn('npm', ['test', '--', testFile], {
+            cwd: workingDir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const timeoutId = setTimeout(() => {
+            killed = true;
+            child.kill('SIGTERM');
+            setTimeout(() => child.kill('SIGKILL'), 5000);
+        }, testTimeout);
+        child.stdout?.on('data', (data) => {
+            outputChunks.push(data.toString());
+        });
+        child.stderr?.on('data', (data) => {
+            outputChunks.push(data.toString());
+        });
+        child.on('close', (code) => {
+            clearTimeout(timeoutId);
+            const output = outputChunks.join('');
+            if (killed) {
+                resolve({
+                    passed: false,
+                    output: output + `\n[Command timed out after ${Math.round(testTimeout / 1000)} seconds]`,
+                });
+            }
+            else {
+                resolve({
+                    passed: code === 0,
+                    output,
+                });
+            }
+        });
+        child.on('error', (error) => {
+            clearTimeout(timeoutId);
+            resolve({
+                passed: false,
+                output: outputChunks.join('') + `\n[Command error: ${error.message}]`,
+            });
+        });
+    });
+}
+/**
+ * Run all tests and return pass/fail result
+ */
+export async function runAllTests(workingDir, testTimeout) {
+    return new Promise((resolve) => {
+        const outputChunks = [];
+        let killed = false;
+        const child = spawn('npm', ['test'], {
+            cwd: workingDir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const timeoutId = setTimeout(() => {
+            killed = true;
+            child.kill('SIGTERM');
+            setTimeout(() => child.kill('SIGKILL'), 5000);
+        }, testTimeout);
+        child.stdout?.on('data', (data) => {
+            outputChunks.push(data.toString());
+        });
+        child.stderr?.on('data', (data) => {
+            outputChunks.push(data.toString());
+        });
+        child.on('close', (code) => {
+            clearTimeout(timeoutId);
+            const output = outputChunks.join('');
+            if (killed) {
+                resolve({
+                    passed: false,
+                    output: output + `\n[Command timed out after ${Math.round(testTimeout / 1000)} seconds]`,
+                });
+            }
+            else {
+                resolve({
+                    passed: code === 0,
+                    output,
+                });
+            }
+        });
+        child.on('error', (error) => {
+            clearTimeout(timeoutId);
+            resolve({
+                passed: false,
+                output: outputChunks.join('') + `\n[Command error: ${error.message}]`,
+            });
+        });
+    });
+}
+/**
+ * Extract test file path from agent output
+ */
+function extractTestFile(agentOutput) {
+    // Look for common patterns in agent output
+    const patterns = [
+        /(?:created|wrote|added|test file[:\s]+)[\s`'"]*([^\s`'"]+\.test\.[tj]sx?)/i,
+        /([^\s`'"]+\.test\.[tj]sx?)/i,
+        /([^\s`'"]+\.spec\.[tj]sx?)/i,
+    ];
+    for (const pattern of patterns) {
+        const match = agentOutput.match(pattern);
+        if (match) {
+            return match[1];
+        }
+    }
+    // Default fallback
+    return 'src/unknown.test.ts';
+}
+/**
+ * Extract test name from agent output or story content
+ */
+function extractTestName(agentOutput, story) {
+    // Try to extract from agent output
+    const patterns = [
+        /(?:test|it|describe)[(\s]+['"`]([^'"`]+)['"`]/i,
+        /testing[:\s]+([^\n]+)/i,
+        /for[:\s]+([^\n]+)/i,
+    ];
+    for (const pattern of patterns) {
+        const match = agentOutput.match(pattern);
+        if (match) {
+            return match[1].trim();
+        }
+    }
+    // Fallback: extract first unchecked AC
+    const acMatch = story.content.match(/- \[ \] ([^\n]+)/);
+    if (acMatch) {
+        return acMatch[1].trim();
+    }
+    return 'Unknown test';
+}
+/**
+ * RED Phase: Write a failing test
+ *
+ * Creates a test that expresses the next acceptance criterion.
+ * The test MUST fail because the functionality doesn't exist yet.
+ */
+export async function executeRedPhase(story, cycleNumber, options) {
+    const agentQuery = options.runAgentQuery || runAgentQuery;
+    const timestamp = new Date().toISOString();
+    const prompt = `You are in the RED phase of TDD (cycle ${cycleNumber}).
+
+Story: ${story.frontmatter.title}
+
+Current acceptance criteria (unchecked = not yet implemented):
+${story.content}
+
+Your task:
+1. Look at the FIRST unchecked acceptance criterion (- [ ])
+2. Write ONE failing test that validates this criterion
+3. The test should be minimal but meaningful
+4. Return the test file path where you created/modified the test
+
+Remember: The test MUST fail because no implementation exists yet.
+Write the test now.`;
+    const output = await agentQuery({
+        prompt,
+        systemPrompt: TDD_SYSTEM_PROMPT,
+        workingDirectory: options.workingDir,
+        onProgress: options.onProgress,
+    });
+    const testFile = extractTestFile(output);
+    const testName = extractTestName(output, story);
+    return {
+        testName,
+        testFile,
+        timestamp,
+        output,
+        success: true,
+    };
+}
+/**
+ * GREEN Phase: Write minimum code to pass the test
+ *
+ * Implements just enough code to make the failing test pass.
+ * Does NOT add extra features or optimizations.
+ */
+export async function executeGreenPhase(story, cycleNumber, testFile, options) {
+    const agentQuery = options.runAgentQuery || runAgentQuery;
+    const timestamp = new Date().toISOString();
+    const prompt = `You are in the GREEN phase of TDD (cycle ${cycleNumber}).
+
+Story: ${story.frontmatter.title}
+Test file: ${testFile}
+
+The test you wrote in the RED phase is now failing.
+
+Your task:
+1. Write the MINIMUM code to make this ONE test pass
+2. Do NOT add extra features or optimizations
+3. Do NOT refactor yet - that comes in the next phase
+4. Keep the implementation simple and focused
+
+Remember: Only write enough code to make the test pass. Nothing more.
+Implement the code now.`;
+    const output = await agentQuery({
+        prompt,
+        systemPrompt: TDD_SYSTEM_PROMPT,
+        workingDirectory: options.workingDir,
+        onProgress: options.onProgress,
+    });
+    const testName = extractTestName(output, story);
+    return {
+        testName,
+        testFile,
+        timestamp,
+        output,
+        success: true,
+    };
+}
+/**
+ * REFACTOR Phase: Improve code while keeping tests green
+ *
+ * Improves code quality without changing behavior.
+ * All tests must remain passing after each change.
+ */
+export async function executeRefactorPhase(story, cycleNumber, testFile, options) {
+    const agentQuery = options.runAgentQuery || runAgentQuery;
+    const timestamp = new Date().toISOString();
+    const prompt = `You are in the REFACTOR phase of TDD (cycle ${cycleNumber}).
+
+Story: ${story.frontmatter.title}
+Test file: ${testFile}
+
+The test is now passing. Time to improve the code.
+
+Your task:
+1. Look for opportunities to improve the code:
+   - Remove duplication (DRY)
+   - Improve naming and clarity
+   - Simplify complex logic
+   - Performance improvements (if obvious)
+2. Make changes incrementally
+3. Ensure ALL tests stay green after each change
+4. If no refactoring is needed, that's fine - skip to the next cycle
+
+Remember: The goal is cleaner code, not new features.
+Refactor now (or skip if the code is already clean).`;
+    const output = await agentQuery({
+        prompt,
+        systemPrompt: TDD_SYSTEM_PROMPT,
+        workingDirectory: options.workingDir,
+        onProgress: options.onProgress,
+    });
+    const testName = extractTestName(output, story);
+    return {
+        testName,
+        testFile,
+        timestamp,
+        output,
+        success: true,
+    };
+}
+/**
+ * Record a completed TDD cycle to the story frontmatter
+ */
+export function recordTDDCycle(cycleNumber, redResult, greenResult, refactorResult) {
+    return {
+        test_name: redResult.testName,
+        test_file: redResult.testFile,
+        red_timestamp: redResult.timestamp,
+        green_timestamp: greenResult.timestamp,
+        refactor_timestamp: refactorResult.timestamp,
+        test_output_red: redResult.output,
+        test_output_green: greenResult.output,
+        all_tests_green: true,
+        cycle_number: cycleNumber,
+    };
+}
+/**
+ * Check if all acceptance criteria have been covered (checked off)
+ */
+export function checkACCoverage(story) {
+    // Find the Acceptance Criteria section
+    const acSectionMatch = story.content.match(/## Acceptance Criteria\s*\n([\s\S]*?)(?=\n##|$)/i);
+    if (!acSectionMatch) {
+        // No AC section = nothing to check = done
+        return true;
+    }
+    const acSection = acSectionMatch[1];
+    // Find all checkbox items
+    const uncheckedItems = acSection.match(/- \[ \]/g);
+    const checkedItems = acSection.match(/- \[x\]/gi);
+    // If there are unchecked items, coverage is incomplete
+    if (uncheckedItems && uncheckedItems.length > 0) {
+        return false;
+    }
+    // If there are checked items (and no unchecked), coverage is complete
+    // If there are no checkboxes at all, consider it complete
+    return true;
+}
+/**
+ * Run the full TDD implementation loop
+ *
+ * Executes Red-Green-Refactor cycles until all acceptance criteria are covered
+ * or the maximum number of cycles is reached.
+ */
+export async function runTDDImplementation(story, sdlcRoot, options = {}) {
+    const workingDir = path.dirname(sdlcRoot);
+    const config = loadConfig(workingDir);
+    const tddConfig = config.tdd || DEFAULT_TDD_CONFIG;
+    const changesMade = [];
+    const agentQuery = options.runAgentQuery || runAgentQuery;
+    const singleTest = options.runSingleTest || runSingleTest;
+    const allTests = options.runAllTests || runAllTests;
+    const testTimeout = config.timeouts?.testTimeout || 300000;
+    // Get starting cycle number from history
+    let cycleNumber = (story.frontmatter.tdd_test_history?.length || 0) + 1;
+    while (cycleNumber <= tddConfig.maxCycles) {
+        changesMade.push(`Starting TDD cycle ${cycleNumber}`);
+        // RED Phase: Write failing test
+        const redResult = await executeRedPhase(story, cycleNumber, {
+            workingDir,
+            runAgentQuery: agentQuery,
+            onProgress: options.onProgress,
+        });
+        // Verify test fails (expected in RED phase)
+        const redTestResult = await singleTest(redResult.testFile, workingDir, testTimeout);
+        if (redTestResult.passed) {
+            return {
+                success: false,
+                story,
+                changesMade,
+                error: `TDD Violation: Test passed immediately in RED phase (cycle ${cycleNumber}). Tests must fail before implementation.`,
+            };
+        }
+        changesMade.push(`RED: Test "${redResult.testName}" fails as expected`);
+        // GREEN Phase: Write minimum code
+        const greenResult = await executeGreenPhase(story, cycleNumber, redResult.testFile, {
+            workingDir,
+            runAgentQuery: agentQuery,
+            onProgress: options.onProgress,
+        });
+        // Verify test now passes
+        const greenTestResult = await singleTest(redResult.testFile, workingDir, testTimeout);
+        if (!greenTestResult.passed) {
+            return {
+                success: false,
+                story,
+                changesMade,
+                error: `TDD Violation: Test still failing in GREEN phase (cycle ${cycleNumber}). Implementation must make test pass.`,
+            };
+        }
+        changesMade.push(`GREEN: Test "${redResult.testName}" now passes`);
+        // Verify no regression (all tests still pass)
+        const regressionCheck = await allTests(workingDir, testTimeout);
+        if (!regressionCheck.passed) {
+            return {
+                success: false,
+                story,
+                changesMade,
+                error: `TDD Violation: Regression detected after GREEN phase (cycle ${cycleNumber}). New code broke existing tests.`,
+            };
+        }
+        changesMade.push('GREEN: No regression - all tests pass');
+        // REFACTOR Phase: Improve code
+        const refactorResult = await executeRefactorPhase(story, cycleNumber, redResult.testFile, {
+            workingDir,
+            runAgentQuery: agentQuery,
+            onProgress: options.onProgress,
+        });
+        // Verify tests still pass after refactoring
+        const refactorCheck = await allTests(workingDir, testTimeout);
+        if (!refactorCheck.passed) {
+            return {
+                success: false,
+                story,
+                changesMade,
+                error: `TDD Violation: Refactoring broke tests (cycle ${cycleNumber}). Undo changes and refactor more carefully.`,
+            };
+        }
+        changesMade.push('REFACTOR: All tests still pass');
+        // Record the completed cycle
+        const cycle = recordTDDCycle(cycleNumber, redResult, greenResult, refactorResult);
+        // Update story with cycle history
+        const history = story.frontmatter.tdd_test_history || [];
+        history.push(cycle);
+        // Trim to last 100 cycles to prevent unbounded growth
+        story.frontmatter.tdd_test_history = history.slice(-100);
+        story.frontmatter.tdd_current_test = cycle;
+        // Persist the TDD cycle history to disk
+        writeStory(story);
+        changesMade.push(`Completed TDD cycle ${cycleNumber}`);
+        // Check if all AC are now covered
+        // Re-read story to get latest content (agent may have updated checkboxes)
+        const updatedStory = parseStory(story.path);
+        if (checkACCoverage(updatedStory)) {
+            changesMade.push('All acceptance criteria covered');
+            return {
+                success: true,
+                story: updatedStory,
+                changesMade,
+            };
+        }
+        cycleNumber++;
+    }
+    // Max cycles reached
+    return {
+        success: false,
+        story,
+        changesMade,
+        error: `TDD: Maximum cycles (${tddConfig.maxCycles}) reached without completing all acceptance criteria.`,
+    };
+}
 /**
  * Implementation Agent
  *
@@ -27,7 +461,7 @@ export async function runImplementationAgent(storyPath, sdlcRoot, options = {})
     const workingDir = path.dirname(sdlcRoot);
     try {
         // Create a feature branch for this story
-        const branchName = `agentic-sdlc/${story.slug}`;
+        const branchName = `ai-sdlc/${story.slug}`;
         try {
             // Check if we're in a git repo
             execSync('git rev-parse --git-dir', { cwd: workingDir, stdio: 'pipe' });
@@ -59,6 +493,37 @@ export async function runImplementationAgent(storyPath, sdlcRoot, options = {})
             currentStoryPath = story.path;
             changesMade.push('Moved story to in-progress/');
         }
+        // Check if TDD is enabled for this story
+        const config = loadConfig(workingDir);
+        const tddEnabled = story.frontmatter.tdd_enabled ?? config.tdd?.enabled ?? false;
+        if (tddEnabled) {
+            changesMade.push('TDD mode enabled - using Red-Green-Refactor implementation');
+            // Run TDD implementation loop
+            const tddResult = await runTDDImplementation(story, sdlcRoot, {
+                onProgress: options.onProgress,
+            });
+            // Merge changes
+            changesMade.push(...tddResult.changesMade);
+            if (tddResult.success) {
+                // Mark implementation as complete
+                updateStoryField(tddResult.story, 'implementation_complete', true);
+                changesMade.push('Marked implementation_complete: true');
+                return {
+                    success: true,
+                    story: parseStory(currentStoryPath),
+                    changesMade,
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    story: tddResult.story,
+                    changesMade,
+                    error: tddResult.error,
+                };
+            }
+        }
+        // Standard implementation (non-TDD mode)
         let prompt = `Implement this story based on the plan:
 
 Title: ${story.frontmatter.title}

package/dist/agents/implementation.js.map

@@ -1 +1 @@
-{"version":3,"file":"implementation.js","sourceRoot":"","sources":["../../src/agents/implementation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"implementation.js","sourceRoot":"","sources":["../../src/agents/implementation.ts"],"names":[],"mappings":"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"}

package/dist/agents/planning.d.ts

@@ -1,5 +1,24 @@
-import { AgentResult } from '../types/index.js';
+import { Story, AgentResult } from '../types/index.js';
 import { AgentOptions } from './research.js';
+/**
+ * System prompt for the planning agent
+ */
+export declare const PLANNING_SYSTEM_PROMPT = "You are a technical planning specialist. Your job is to create detailed, step-by-step implementation plans for user stories.\n\nWhen creating a plan, you should:\n1. Break the work into phases (setup, implementation, testing, etc.)\n2. Create specific, actionable tasks within each phase\n3. Use checkbox format for tracking progress\n4. Consider test-driven development (write tests first)\n5. Include verification steps\n\nOutput your plan in markdown format with checkboxes. Each task should be small enough to complete in one focused session.";
+/**
+ * TDD-specific planning instructions
+ * When TDD is enabled, this is appended to the planning prompt to ensure
+ * the plan follows the Red-Green-Refactor cycle structure.
+ */
+export declare const TDD_PLANNING_INSTRUCTIONS = "\n**TDD Mode Enabled - Use Red-Green-Refactor Cycle Structure**\n\nStructure your plan using the TDD cycle for EACH feature/acceptance criterion:\n\nFor each task that involves writing code:\n- \uD83D\uDD34 RED: Write a failing test first that expresses the expected behavior\n- \uD83D\uDFE2 GREEN: Write the MINIMUM code to make the test pass\n- \uD83D\uDD35 REFACTOR: Improve the code while keeping all tests green\n\nExample TDD task structure:\n### Feature: User Login\n- [ ] \uD83D\uDD34 Write failing test for successful login with valid credentials (expect fail)\n- [ ] \uD83D\uDFE2 Implement login function to make test pass (expect pass)\n- [ ] \uD83D\uDD35 Refactor login code if needed (keep passing)\n\n- [ ] \uD83D\uDD34 Write failing test for login rejection with invalid password (expect fail)\n- [ ] \uD83D\uDFE2 Implement password validation to make test pass (expect pass)\n- [ ] \uD83D\uDD35 Refactor validation code if needed (keep passing)\n\nIMPORTANT TDD Rules:\n1. NEVER write implementation code before writing a test\n2. Each test should verify ONE specific behavior\n3. Tests must fail before implementation (verify the test is actually testing something)\n4. After GREEN phase, run ALL tests to check for regressions\n5. REFACTOR phase is optional but should not change behavior";
+/**
+ * Build a planning prompt for a story, optionally with TDD instructions
+ *
+ * @param story - The story to create a plan for
+ * @param tddEnabledInConfig - Whether TDD is enabled in the global config
+ * @param reworkContext - Optional context from a failed review
+ * @returns The complete planning prompt
+ */
+export declare function buildPlanningPrompt(story: Story, tddEnabledInConfig: boolean, reworkContext?: string): string;
 /**
  * Planning Agent
  *

package/dist/agents/planning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../src/agents/planning.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAa7C;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAsEtB"}
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../src/agents/planning.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,sBAAsB,uiBASuF,CAAC;AAE3H;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,+xCAyBuB,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,kBAAkB,EAAE,OAAO,EAC3B,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CA+CR;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA8CtB"}