/red-frontend-api - Write Frontend API Client Test (Red Phase)

Orchestrates red-agent for frontend-api layer.

Usage

/red-frontend-api "Story name" "Scenario name"
/red-frontend-api 2 "Registration API call"
/red-frontend-api                                      # Interactive selection

CRITICAL TDD RULE

Test MUST be run WITHOUT .skip first to verify failure. Only after confirming failure is correct, add .skip marker.

Workflow

1. •Parse user input (story, scenario)
2. •Load agent instructions from .claude/agents/red-agent.md
3. •Load layer template from .claude/templates/frontend/api-test.md
4. •Execute the following steps:
   • •Identify API endpoints from ProductSpecification/ and backend controllers
   • •Predict expected failure (document before writing test)
   • •Write ONE test with MSW handler WITHOUT .skip initially
   • •Run test using Skill tool: skill="test-frontend", args="{test-file-pattern}"
   • •Verify failure matches prediction
   • •Add .skip to the test
   • •Verify test is now SKIPPED
5. •Return result summary with predicted vs actual failure

Key Rules

• •ONE test per invocation
• •MUST verify failure before adding .skip
• •Use MSW (Mock Service Worker) for HTTP mocking (analogous to WireMock on backend)
• •MSW handlers define expected request/response pairs
• •Use Skill tool for test execution (not npx directly)

Expected Failure Patterns

Story Mapping

Next Step

After red phase: /green-frontend-api "Story name" "Scenario name"