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
Suivez les instructions du dépôt pour votre agent. Consultez les fichiers et dépendances avant l’installation.
Voir la source ↗GuidesInstructions
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
Exemples
Consultez les exemples du dépôt source.
Voir la source ↗Historique source
- Date d’indexation
- 2026-01-20
- Mise à jour de l’index
- 2026-01-28
- Branch
- main
Les dates concernent ce répertoire. Consultez le dépôt pour l’historique du code.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!