# Swarm Planner

[EXPLICIT INVOCATION ONLY] Creates dependency-aware implementation plans optimized for...

- Repository: https://github.com/am-will/codex-skills (1040 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-07-14
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add am-will/codex-skills --skill swarm-planner -g -a claude-code -y`
Codex: `npx skills add am-will/codex-skills --skill swarm-planner -g -a codex -y`
Cursor: `npx skills add am-will/codex-skills --skill swarm-planner -g -a cursor -y`
Gemini CLI: `npx skills add am-will/codex-skills --skill swarm-planner -g -a gemini-cli -y`

## Description

[EXPLICIT INVOCATION ONLY] Creates dependency-aware implementation plans optimized for parallel multi-agent execution.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Swarm-Ready Planner

Create implementation plans with explicit task dependencies optimized for parallel agent execution. This skill can be ran inside or outside of Plan Mode. 

## Core Principles

1. **Explore Codebase**: Investigate architecture, patterns, existing implementations, dependencies, and frameworks in use.
2. **Fresh Documentation First**: Use Context7 for ANY external library, framework, or API before planning tasks
3. **Ask Questions**: Clarify ambiguities and seek clarification on scope, constraints, or priorities throughout the planning process. At any time.
4. **Explicit Dependencies**: Every task declares what it depends on, enabling maximum parallelization
5. **Atomic Tasks**: Each task is independently executable by a single agent
6. **Review Before Yield**: A subagent reviews the plan for gaps before finalizing

## Process

### 1. Research

**Codebase investigation:**
- Architecture, patterns, existing implementations
- Dependencies and frameworks in use

### 1a. Optional: Stop to Clarification Questions

- If the architecture is unclear or missing STOP AND YIELD to the user, and request user input (AskUserQuestions) before moving on. Always offer recommendations for clarification questions.
- If architecture is present, skip 1a and move onto next step. 

### 2. Documentation

**Documentation retrieval (REQUIRED for external dependencies):**

Use Context7 skill or MCP to fetch current docs for any libraries/frameworks or APIs that are or will be used in project. If Context7 is not available, use web search.

This ensures version-accurate APIs, correct parameters, and current best practices.

### 3. STOP and Request User Input

The rest: https://github.com/am-will/codex-skills/blob/HEAD/skills/swarm-planner/SKILL.md