wave-planner-skill
Transform Linear project issues into execution-ready wave plans with risk prediction and specialist agent assignments. Orders work by risk,
Open source Repository Open in the app JSON README (API)
About
Transform Linear project issues into execution-ready wave plans with risk prediction and specialist agent assignments. Orders work by risk, not readiness.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- wrsmith108
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-03-04T01:12:04Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
wrsmith108/wave-planner-claude-skill/wave-planner-skill
README
# Wave Planner Skill for Claude Code
Transform project issues into execution-ready implementation plans with wave-based organization, specialist agent assignments, token estimates, and TDD workflow integration.
## Installation
```bash
git clone https://github.com/wrsmith108/wave-planner-claude-skill.git ~/.claude/skills/wave-planner
```
## Features
- **Discovery**: Fetches issues from PM tools (Linear, GitHub Issues)
- **Architecture Decisions**: Surfaces decisions requiring clarification
- **Risk Prediction**: Identifies blockers and generates mitigations
- **Wave Organization**: Groups issues by shared context
- **Token Estimation**: Dynamic codebase analysis for accurate estimates
- **Agent Assignment**: Assigns specialist agents via LLM inference
- **Artifact Generation**: Creates implementation plans, hive configs, ADRs
## Quick Start
```
# Explicit invocation
/wave-planner "Project Name"
# Natural language
"Plan the implementation for the authentication system"
"Break down the API redesign into waves"
```
## Behavioral Classification
**Type**: Guided Decision
**Directive**: ASK, THEN EXECUTE
The skill asks structured questions upfront, then executes based on your choices.
## Requirements
- Claude Code CLI
- Linear skill (for Linear integration) or GitHub CLI
- claude-flow MCP server (for execution)
## Configuration
Create `~/.claude/skills/wave-planner/config.yaml`:
```yaml
wave-planner:
defaults:
max_waves: 6
max_issues_per_wave: 5
token_budget_per_wave: 150000
adapters:
preferred: auto # or: linear, github
```
## Environment Variables
```bash
# For Linear integration
LINEAR_API_KEY=lin_api_xxx
# For GitHub integration
GITHUB_TOKEN=ghp_xxx
```
## Documentation
- [SKILL.md](SKILL.md) - Core skill documentation
- [preflight.md](preflight.md) - Pre-flight check script
- [execution.md](execution.md) - Wave execution guide
- [reference.md](reference.md) - Detailed reference documentation
## Changelog
### 1.0.1 (2026-02-10)
- **Fixed**: Reverted cross-skill Linear references to absolute paths (required for inter-skill dependencies)
## License
MIT