# Recursive Planning

> How to decompose projects into wave plans -- module identification, dependency mapping, wave assignment, contract guidance, deliverables.

- **Type:** Skill
- **Install:** `agentstack add skill-jartan-llc-grimoire-recursive-planning`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Jartan-LLC](https://agentstack.voostack.com/s/jartan-llc)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Jartan-LLC](https://github.com/Jartan-LLC)
- **Source:** https://github.com/Jartan-LLC/grimoire/tree/main/plugins/recursio/skills/recursive-planning

## Install

```sh
agentstack add skill-jartan-llc-grimoire-recursive-planning
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Recursive Planning

## Decomposition Process

1. **Survey** -- greenfield or existing? For existing: read README, types, error classes, test setup, conventions. These are constraints.
2. **Identify domains** -- genuinely different kinds of work (parsing vs querying vs aggregating vs formatting)
3. **Map dependencies** -- which domains need outputs from others? Dependencies flow through interfaces only.
4. **Assign waves** -- no dependencies -> Wave 1. Depends on Wave 1 -> Wave 2. Wave 0 is always contracts/setup. Integration is final wave.
5. **Assign scopes** -- each module gets a directory or file set. Zero overlap between parallel modules.
6. **Specify conventions** -- language, test framework, type system, DI pattern, path handling, package manager
7. **Plan deliverables** -- README, CHANGELOG, `--version`, runtime version access, coverage config

## Module Split Criteria

See `recursive-development` skill for split principle and examples. Goal: natural, best-practice file structure.

## Contract Guidance

Wave 0 agent designs contracts. The plan specifies what they should cover:

- **Enumerate capabilities** -- list all operations/formats/modes, not just common ones
- **Error handling** -- "Parsers yield Record | ParseError" not "Parsers raise on bad input"
- **Batch interfaces** -- "Aggregator takes list[AggregationSpec]" not single-item
- **Injectable I/O** -- "Formatters accept a write callable"
- **Types only** -- contracts file has protocols, dataclasses, enums, type aliases, constants. No callable stubs.
- **Exception hierarchy** -- base exception + subtypes per failure domain
- **Logging** -- modules use named loggers, CLI configures at entry point

For existing projects: extend existing contracts, match established patterns.

## Wave Plan Format

Save to `.claude/workspace/wave-plan-.md`.

```text
## Implementation Plan -- `` 
### Issue Summary
### Language & Conventions
### Language-Specific Standards
(Standards shaped to this project's language and domain -- specifics that all agents must follow.
These go beyond generic conventions. Think about what a senior developer in this language would
insist on in a code review.)
### Existing Patterns (existing projects only)
### Chosen Approach

## Wave 0: Contracts & Project Setup
## Wave 1:  (N parallel)
### Module A -- Owns: , Responsibility: 
## Wave 2: 
### Module C -- Owns: , Depends on: , Responsibility: 
## Wave N: Integration + Documentation (README.md, CHANGELOG.md)

## File Ownership Map
### Complexity: Simple | Moderate | Complex
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Jartan-LLC](https://github.com/Jartan-LLC)
- **Source:** [Jartan-LLC/grimoire](https://github.com/Jartan-LLC/grimoire)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jartan-llc-grimoire-recursive-planning
- Seller: https://agentstack.voostack.com/s/jartan-llc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.