# functional-planner

functional-planner turns product requirement documents into validated work-item hierarchies for Azure DevOps, GitHub, or Jira.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1627 repo stars
- Author: microsoft
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/microsoft/hve-core/tree/HEAD/.github/skills/project-planning/functional-planner/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/functional-planner

## What it does

The skill inspects PRDs and translates them into epics, features, user stories, or tasks. Before finalizing the structure, it inspects your issue tracker in read-only mode to verify allowed issue types and fields. You can shape the decomposition through one of three lenses: `generic`, `scrum`, or `kanban`.

All planning strictly respects a read-only boundary. The skill never writes, comments on, transitions, or creates issues in your remote repository. Instead, it generates local tracking files like `handoff.md` and `planning-log.md` for review.

Targeting Jira requires `JIRA_BASE_URL` alongside `JIRA_API_TOKEN` or `JIRA_PAT`. If tracker credentials or the PRD file cannot be resolved, execution halts immediately.

## Requirements
- Works with: GitHub, Azure DevOps, Jira

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill functional-planner -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/functional-planner/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/functional-planner/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill functional-planner -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/functional-planner/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill functional-planner -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/functional-planner/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/hve-core .github/skills/project-planning/functional-planner
```

2. **Manually: put the files in place**
- File: `.github/skills/functional-planner/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill functional-planner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/microsoft/hve-core --path .github/skills/project-planning/functional-planner
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/functional-planner/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/microsoft/hve-core/tree/HEAD/.github/skills/project-planning/functional-planner/SKILL.md

## When to use it
- convert PRD files into structured work-item hierarchies
- validate tracker issue types before attempting batch creation
- shape task decomposition through Scrum or Kanban lenses
- produce a reviewable handoff file for backlog execution

## Example prompts
- Decompose docs/prd.md for Jira using the scrum lens
- Plan a work item hierarchy for GitHub issues from the open specification
- Generate an Azure DevOps handoff.md from specs/billing.md

## Similar
- [project-management](https://affpapa.org/en/nevibecode/skills/project-management.md) — skill · 399 installs
- [leanspec](https://affpapa.org/en/nevibecode/skills/leanspec.md) — skill · 1100 installs
- [azure-boards](https://affpapa.org/en/nevibecode/skills/azure-boards.md) — skill · 242 installs
- [debate-review](https://affpapa.org/en/nevibecode/skills/debate-review.md) — skill · 705 installs
- [project-session-manager](https://affpapa.org/en/nevibecode/skills/project-session-manager.md) — skill · 937 installs
- [daily-meeting-update](https://affpapa.org/en/nevibecode/skills/daily-meeting-update.md) — skill · 70 installs

From the same set: [microsoft/hve-core](https://affpapa.org/en/nevibecode/by/microsoft/hve-core.md) — 148 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
