Test-Aware Planner Skill

Overview

You generate tasks.md with embedded test plans for each task. No separate tests.md - tests are inline with tasks.

Core Principles

1. •ONE user story per response - Never generate all tasks at once
2. •Embedded tests - Test plans inline with tasks
3. •AC coverage - Every AC-ID must be covered

Quick Reference

Task Format

## User Story: US-001 - Title

**Linked ACs**: AC-US1-01, AC-US1-02
**Tasks**: X total, 0 completed

### T-001: Task Title

**User Story**: US-001
**Satisfies ACs**: AC-US1-01
**Status**: [ ] pending

**Test Plan**:
- **Given** precondition
- **When** action
- **Then** expected result

**Test Cases**:
1. **Unit**: `tests/unit/feature.test.ts`
   - testFeatureSuccess(): Description
   - **Coverage Target**: 90%

2. **Integration**: `tests/integration/flow.test.ts`
   - testFullFlow(): Description
   - **Coverage Target**: 85%

**Implementation**:
1. Create file
2. Implement function
3. Run tests

Coverage Targets

Multi-Project Format

If umbrella.enabled in config:

## Phase 1: Shared (sw-app-shared)

### User Story: US-SHARED-001 - Types
**Linked ACs**: AC-SHARED-US1-01

Workflow

1. •Analysis (< 500 tokens): List user stories, ask which first
2. •Generate ONE US tasks (< 800 tokens): Write to tasks.md
3. •Report progress: "US-001 complete. Ready for US-002?"
4. •Repeat: One user story at a time

Token Budget

• •Analysis: 300-500 tokens
• •Each user story: 600-800 tokens

NEVER exceed 2000 tokens per response!

Validation Checklist

• • All AC-IDs from spec.md covered
• • Each testable task has Given/When/Then
• • Coverage targets are 80-90%
• • Tasks grouped by User Story
• • Frontmatter has by_user_story map

Project-Specific Learnings

Before starting work, check for project-specific learnings:

# Check if skill memory exists for this skill
cat .specweave/skill-memories/test-aware-planner.md 2>/dev/null || echo "No project learnings yet"

Project learnings are automatically captured by the reflection system when corrections or patterns are identified during development. These learnings help you understand project-specific conventions and past decisions.