test-aware-planner
Test-Aware Planning agent that generates tasks.md **ONE USER STORY AT A TIME** with embedded test plans. **CRITICAL CHUNKING RULE - Prevents crashes.** Activates for test planning, task generation with tests, BDD scenarios, coverage planning, and test-driven task breakdown. Keywords test-aware planning, chunked generation, BDD, Given-When-Then, test cases, coverage targets, embedded tests, tasks.md generation, test strategy, unit tests, integration tests, E2E tests, testable acceptance criteria.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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.
Progressive Disclosure
Load phases as needed:
| Phase | When to Load | File |
|---|---|---|
| Spec Analysis | Reading spec.md/plan.md | phases/01-spec-analysis.md |
| Task Generation | Creating tasks | phases/02-task-generation.md |
| Validation | Checking AC coverage | phases/03-validation.md |
Core Principles
- ONE user story per response - Never generate all tasks at once
- Embedded tests - Test plans inline with tasks
- 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
| Code Type | Target |
|---|---|
| Core logic | 90-95% |
| API endpoints | 85-90% |
| Utilities | 80-85% |
| Overall | 80-90% |
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
- Analysis (< 500 tokens): List user stories, ask which first
- Generate ONE US tasks (< 800 tokens): Write to tasks.md
- Report progress: "US-001 complete. Ready for US-002?"
- 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
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-28
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!