Skip to main content
From an empty folder to Claude Code building your PRD, on one page. Each step links to the page with the detail.

1. Requirements

  • Claude Code, installed and signed in. Run claude once to sign in. Every AI call TaskGraph makes runs through it, so there are no API keys or provider accounts to set up. See Authentication.
  • Node.js 22.19 or later, from nodejs.org or your package manager. npm comes with it.

2. Install

This gives you the taskgraph command. Installation has the detail: the Claude Code plugin, the optional MCP server and staying up to date.

3. Set up your project

From your project folder:
It creates .taskgraph/ (tasks, docs, config) and adds an import to CLAUDE.md that loads TaskGraph’s workflow guide in Claude Code. It asks one question: whether to store tasks in Git. Running it again is safe: it says the project is already set up and adds only what is missing. To check the setup at any point, run taskgraph doctor. It prints one line per check and the fix under each one that failed.

4. Write a PRD

A PRD (product requirements document) says what you want to build and why. Save it as .taskgraph/docs/prd.md. It can cover a whole app or only the next feature, and a project can have several. The more context it gives (the goal, what already exists, constraints, why you chose this approach), the better the tasks. init puts two examples in .taskgraph/templates/, and Writing a PRD says when to use each and how to draft one with Claude.

5. Build it

go plans the PRD into tasks with dependencies, then runs loop: Claude Code works the tasks in order, one fresh session per task, and commits after each. If it stops partway, run the same command again and it picks up from the task statuses. loop always runs Claude Code with permission prompts off, so it can read, edit and run anything in the project without asking. It asks you to allow that first. --trust skips the question, for scripts, and --sandbox runs each session in Docker instead. See Loop Permissions and From a PRD to built tasks. With the plugin installed, /taskgraph:go .taskgraph/docs/prd.md does the same from inside Claude Code.

Or go step by step

To review the plan before anything is built, and stay in each session yourself, run the steps one at a time.
  1. Plan. Turn the PRD into tasks. --clarify asks about gaps in the PRD first:
  2. Review. taskgraph list shows the plan and taskgraph show 3 one task in full. To change a task, run taskgraph update 3 --prompt='use Postgres instead of MongoDB'.
  3. Work. Find the next unblocked task and claim it:
    Have Claude Code implement it, then mark it done. A task has acceptance criteria, and set-status --status=done refuses it until each one is checked off.
  4. Repeat. Next, implement, done, next.
With the plugin installed you can ask Claude for each step in plain language, or use the slash commands:

Where to go next

  • Tutorial: the step-by-step workflow in depth, with tags, subtasks and research.
  • Loop: presets, cost caps, parallel runs and resuming.
  • Configuration: models, settings and environment variables.
  • CLI Commands: every command, and the slash command for each.
  • FAQ: troubleshooting.