/fix-e2e command
       │
       │  For EACH item (sequentially):
       ▼
┌─────────────────────────────────────────┐
│         e2e-item-tester agent           │
│                                         │
│  1. Verify solution is running          │
│  2. Execute tests for the item          │
│  3. Capture errors if any               │
│  4. If PASS: persist test file          │
│  5. Report PASS/FAIL with details       │
└─────────────────────────────────────────┘
       │
       ▼
  Main logic analyzes result
       │
       ├── PASS → move to next item
       └── FAIL → spawn fix agents → re-test

# GET request
curl -s http://localhost:{port}/api/v1/endpoint

# POST with JSON
curl -s -X POST http://localhost:{port}/api/v1/endpoint \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

# POST with file
curl -s -X POST http://localhost:{port}/api/v1/import \
  -F "file=@test-data.csv"

# Check recent logs
tail -n 50 .local-logs/{container}/combined.log

# Search for patterns
grep "completed\|success\|error" .local-logs/{container}/combined.log

./scripts/local-status.sh

RESULT: FAIL

Error: Solution is not running.
Start with: ./scripts/local-start-all.sh

RESULT: PASS

All acceptance criteria verified successfully.

Tested steps:
- [✓] {criterion 1}: {how verified}
- [✓] {criterion 2}: {how verified}
- [✓] {criterion 3}: {how verified}

Test file created: tests/{category}/{id}-{slug}.{test|spec}.{ext}

RESULT: FAIL

Failed criteria:
- [✗] {criterion}: {error details}

Error details:
- Source: {source}
- Error: {error message}
- Container: {container name}
- File (if known): {filename:line}
- Log context:

Passed criteria:
- [✓] {criterion 1}
- [✓] {criterion 2}

ls tests/requirements/{id}-*.test.* 2>/dev/null
ls tests/ai-capabilities/{id}-*.test.* 2>/dev/null
ls tests/user-journeys/{id}-*.spec.* 2>/dev/null

#!/bin/bash
# Test: {ID} - {Title}
# Source: .product/{REQUIREMENTS|AI_CAPABILITIES|USER_JOURNEYS}.md
# Approach: {API | API + Logs}
# Prerequisites: Solution running (./scripts/local-start-all.sh)

set -e

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"

# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
NC='\033[0m'

echo "=========================================="
echo "Test: {ID} - {Title}"
echo "=========================================="

# Verify solution is running
if ! "$PROJECT_ROOT/scripts/local-status.sh" > /dev/null 2>&1; then
    echo -e "${RED}ERROR: Solution not running${NC}"
    echo "Start with: ./scripts/local-start-all.sh"
    exit 1
fi

# Test 1: {Criterion 1}
echo -n "Testing {criterion 1}... "
RESPONSE=$(curl -s {request})
if echo "$RESPONSE" | grep -q "{expected}"; then
    echo -e "${GREEN}PASS${NC}"
else
    echo -e "${RED}FAIL${NC}"
    echo "Response: $RESPONSE"
    exit 1
fi

# Additional tests...

echo ""
echo -e "${GREEN}All tests passed!${NC}"
exit 0

/**
 * Test: {ID} - {Title}
 * Source: .product/USER_JOURNEYS.md
 * Approach: Playwright
 * Prerequisites: Solution running (./scripts/local-start-all.sh)
 */

import { test, expect } from '@playwright/test';
import { execSync } from 'child_process';
import * as path from 'path';

const PROJECT_ROOT = path.resolve(__dirname, '../..');

test.beforeAll(async () => {
  try {
    execSync(`${PROJECT_ROOT}/scripts/local-status.sh`, { stdio: 'ignore' });
  } catch {
    throw new Error('Solution not running. Start with: ./scripts/local-start-all.sh');
  }
});

test.describe('{ID}: {Title}', () => {
  test.beforeEach(async ({ page }) => {
    await page.goto('{frontend-url}');
  });

  test('should {criterion 1}', async ({ page }) => {
    // Test implementation
  });

  test('should {criterion 2}', async ({ page }) => {
    // Test implementation
  });
});

| {ID} | {Title} | {Type} | {category}/{id}-{slug}.{ext} | ✓ |

# For shell scripts
chmod +x tests/{category}/{id}-{slug}.test.sh
./tests/{category}/{id}-{slug}.test.sh

# For Playwright
cd tests && npx playwright test {category}/{id}-{slug}.spec.ts

tests/
├── README.md                           # Test suite index
├── run-all.sh                          # Run all tests
├── run-all.ps1                         # Windows version
├── requirements/                       # FR-xxx tests
│   └── fr-{n}-{slug}.test.sh
├── ai-capabilities/                    # AI-xxx tests
│   └── ai-{n}-{slug}.test.sh
├── user-journeys/                      # UJ-xxx tests
│   └── uj-{n}-{slug}.spec.ts
├── fixtures/                           # Shared test data
│   └── test-*.{json|csv}
└── playwright.config.ts                # Playwright config (if UI tests)

.local-logs/
├── .running                    # Lock file (solution is running)
├── pids.txt                    # Process IDs
├── {container}/
│   ├── stdout.log              # Standard output
│   ├── stderr.log              # Error output
│   └── combined.log            # Timestamped combined output
└── startup-summary.log

# After triggering operation, wait and check logs
sleep 5
grep "processing.*completed" .local-logs/{container}/combined.log

// Trigger action
await page.click('[data-testid="submit"]');

// Wait for response indicator
await expect(page.locator('[data-testid="success"]')).toBeVisible({ timeout: 10000 });

# Example: Testing a score/confidence value from an API
RESPONSE=$(curl -s -X POST http://localhost:{port}/api/v1/process \
  -H "Content-Type: application/json" \
  -d '{"input": "test data"}')

SCORE=$(echo "$RESPONSE" | jq -r '.score')
if (( $(echo "$SCORE > 0.7" | bc -l) )); then
    echo "PASS: Score $SCORE > 0.7"
else
    echo "FAIL: Score $SCORE <= 0.7"
fi

RESULT: PASS | FAIL

{Details as specified above}