Plan a Project
Brainstorm and decompose a new project from your coding agent with the /piyaz skills.
Plan a Project
You plan a project from your coding agent, not from a web form. The /piyaz skill runs the brainstorm and decompose flow inside your harness (Claude Code, Codex, Cursor, or Antigravity) and writes the result to your project graph. The web app at app.piyaz.ai is where you watch the project take shape and manage it afterward.
Install the plugin first. See the connect guides for your harness.
Describe the idea
Reach for the skill with /piyaz, then say what you want to build in your own words.
/piyaz i want a cli that generates changelogs from conventional commits, with monorepo supportThe skill also picks up on its own when you talk about a new project, so the prefix is optional after the first turn.
Brainstorm the brief
Piyaz brainstorms with you. It restates the idea, then asks one focused question at a time about the gaps: who the user is, the main features, the technical direction, and the constraints. It pushes back on weak choices and proposes a default where you have none.
A solid brief runs three to five sentences: the problem, the user, the main features, the technical direction, and the constraints. Piyaz waits for your approval before it writes anything.
Decompose into a task graph
Once you approve the brief, Piyaz decomposes it in the same flow. It proposes tasks, each with a title (verb plus noun), a short description, two to four testable acceptance criteria, a category, and the dependency edges that wire them into the right order. You approve, and it saves the graph.
New tasks land as drafts. See Decompose into tasks for the granularity and edge rules.
Work from the graph
From here you stay in your agent. Ask what is next, refine a task, or hand the loop to composer on Claude Code. The quickstart walks that loop end to end.
Open the project at app.piyaz.ai to watch it fill in: the task workspace for the list and detail, and Graph mode for the dependency network.
Jump to one phase
The /piyaz skill routes the whole flow for you. To jump straight to a single phase on Claude Code, use the explicit commands:
/piyaz:brainstormshapes a raw idea into a brief./piyaz:decomposebreaks an approved brief into tasks.
Other harnesses ship the same skills with their own prefix (Codex uses $piyaz), and Cursor's MCP-only setup runs the flow through plain natural language. See Skills and agents for the full list and your connect guide for the invocation.