Management

The Management department produces all upstream documents that every other department depends on. Nothing else can start without a PRD and SRS from Management.

---

What Management produces

Document	Purpose	Template
idea_v<N>.md	Problem definition, target segment, why-now	templates/idea_requirement.md
prd_v<N>.md	Features, personas, goals, rollout plan	templates/prd.md
srs_v<N>.md	Technical requirements, data model, API contracts	templates/srs.md
user_story_v<N>.md	Acceptance criteria per epic	templates/user_story.md
roadmap_v<N>.md	Now / Next / Later feature plan	templates/roadmap.md

All outputs go to nepwalk-docs/docs/management/mvp/.

---

How to operate

Setup (one time)

cd ~/code/nepwalk
git clone <nepwalk-docs-url> nepwalk-docs
git clone <nepwalk-management-url> nepwalk-management
cd nepwalk-management
./scripts/sync-from-docs.sh
```text

> **Windows users:** Run these commands in **Git Bash** or **WSL** — not PowerShell or CMD.

Open `nepwalk-management/` in your AI tool. The AI reads `AGENTS.md` automatically.

### Session loop

**Check what exists:**

management_status:

Shows which docs are present, which are missing, and whether any downstream dept is blocked.

**Start a new document:**

management: start prd management: start srs management: start user-stories

The AI loads the relevant template, reads prior docs for context, and drafts the document in `nepwalk-docs/docs/management/mvp/`.

**Review and iterate:**
Edit the draft directly in `nepwalk-docs`. Ask the AI to revise specific sections:

management: revise srs section 3 — add push notification requirements

**Publish for review:**

management: publish prd_v1.md

Opens a PR. Once approved, Design and QA can use it as a confirmed input.

---

## Dependency order within Management

Write in this order — each doc feeds the next:

idea → PRD → SRS → user stories → roadmap

You can draft all in the same session. The AI reads prior docs automatically when starting the next one.

---

## Specialist agents

| Agent | When to use |
|---|---|
| `product-manager` | Drafting PRD — feature prioritisation, personas, success metrics |
| `product-sprint-prioritizer` | Idea doc — prioritisation, scope decisions, why-now |
| `project-management-project-shepherd` | Roadmap — milestone sequencing, dependency mapping |

management: agent product-manager "draft PRD section 5 — feature requirements"

```text

---

Current work

Browse mvp/ for the latest versions of each document.