{
  "markdown": "# Wave Planner Skill for Claude Code\n\nTransform project issues into execution-ready implementation plans with wave-based organization, specialist agent assignments, token estimates, and TDD workflow integration.\n\n## Installation\n\n```bash\ngit clone https://github.com/wrsmith108/wave-planner-claude-skill.git ~/.claude/skills/wave-planner\n```\n\n## Features\n\n- **Discovery**: Fetches issues from PM tools (Linear, GitHub Issues)\n- **Architecture Decisions**: Surfaces decisions requiring clarification\n- **Risk Prediction**: Identifies blockers and generates mitigations\n- **Wave Organization**: Groups issues by shared context\n- **Token Estimation**: Dynamic codebase analysis for accurate estimates\n- **Agent Assignment**: Assigns specialist agents via LLM inference\n- **Artifact Generation**: Creates implementation plans, hive configs, ADRs\n\n## Quick Start\n\n```\n# Explicit invocation\n/wave-planner \"Project Name\"\n\n# Natural language\n\"Plan the implementation for the authentication system\"\n\"Break down the API redesign into waves\"\n```\n\n## Behavioral Classification\n\n**Type**: Guided Decision\n**Directive**: ASK, THEN EXECUTE\n\nThe skill asks structured questions upfront, then executes based on your choices.\n\n## Requirements\n\n- Claude Code CLI\n- Linear skill (for Linear integration) or GitHub CLI\n- claude-flow MCP server (for execution)\n\n## Configuration\n\nCreate `~/.claude/skills/wave-planner/config.yaml`:\n\n```yaml\nwave-planner:\n  defaults:\n    max_waves: 6\n    max_issues_per_wave: 5\n    token_budget_per_wave: 150000\n  adapters:\n    preferred: auto  # or: linear, github\n```\n\n## Environment Variables\n\n```bash\n# For Linear integration\nLINEAR_API_KEY=lin_api_xxx\n\n# For GitHub integration\nGITHUB_TOKEN=ghp_xxx\n```\n\n## Documentation\n\n- [SKILL.md](SKILL.md) - Core skill documentation\n- [preflight.md](preflight.md) - Pre-flight check script\n- [execution.md](execution.md) - Wave execution guide\n- [reference.md](reference.md) - Detailed reference documentation\n\n## Changelog\n\n### 1.0.1 (2026-02-10)\n\n- **Fixed**: Reverted cross-skill Linear references to absolute paths (required for inter-skill dependencies)\n\n## License\n\nMIT\n",
  "bytes": 2131,
  "sha": "3c96db598e193fff922d687320395ed183db2a9f50f43e2c6a7e07dd1d9927d0",
  "repo_slug": "wrsmith108/wave-planner-claude-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_wrsmith108_wave_planner_claude_skill_wav_c3765af2/readme"
}