FrkAk/piyaz

Brainstorm turns a vague software idea into a concise project brief before tasks are created. Use it when a user is exploring what to build and needs scope, features, and flow clarified.

Brainstorm dispatches the Piyaz brainstorm subagent through the Task tool when invoked directly with /piyaz:brainstorm. Use it for that explicit command path; natural-language idea requests are handled by the /piyaz skill or the assistant dispatcher.

Brainstorm turns a rough software idea into a brief with scope, features, users, and constraints before task decomposition. Use it when a project is new, vague, or exploratory and needs clearer direction.

Brainstorm turns a raw software idea into a brief with scope, users, features, and constraints so a project can be decomposed into tasks. Use it when the user has an early or ambiguous idea and needs help shaping it before planning work.

Composer orchestrates Piyaz tasks end to end, from picking ready work through research, implementation, review, and merge. Use it for backlog runs, single-task execution, or rework loops on PR feedback.

Decompose breaks an existing Piyaz project into an implementable task graph when it has a clear description but few or no tasks. It is used to turn a project brief into dependencies, task order, and concrete work items.

Decompose dispatches the Piyaz decompose subagent through the Task tool when called directly as /piyaz:decompose. Use it for explicit subagent invocation; natural-language task breakdowns are handled by the /piyaz skill or assistant routing.

Decompose Feature dispatches the decompose-feature subagent through the Task tool when invoked directly with /piyaz:decompose-feature. It is for explicit skill calls, not natural-language feature requests handled by the assistant or /piyaz skill.

Decompose Task splits an oversize active Piyaz task into smaller child tasks and rewires dependencies so the graph stays consistent. Use it when a task is too large to fit one iteration and needs to be broken into implementable pieces.

Decompose Task dispatches the decompose-task subagent through the Task tool for direct /piyaz:decompose-task requests. Use it to split a target taskRef into smaller pieces without duplicating the agent workflow.

Manage dispatches the Piyaz manage subagent through the Task tool when the user invokes /piyaz:manage directly. Use it to pass a full request to the canonical manage workflow without duplicating the agent logic here.

Onboarding reads an existing codebase and turns only what can be grounded in the code into a Piyaz project and task inventory. Use it when adopting Piyaz for a repo that already exists and needs to be mapped before decomposition.

Onboarding dispatches the onboarding subagent through the Task tool when a user explicitly types /piyaz:onboarding. It is not for natural-language import requests, which should be handled by the /piyaz skill or assistant routing.

Piyaz helps plan, decompose, track, and resume multi-task projects across sessions. Use it to manage task graphs, dependencies, decisions, and handoffs when work spans multiple people or sessions.

Piyaz Brain handles deep CTO-mode reviews of a Piyaz project, including graph health audits, dependency rebalancing, pruning orphans, and consolidating tags or categories. Use it for strategic navigation sessions, not routine status updates.

Piyaz Decompose Feature turns a new capability request for an active Piyaz project into a coherent cluster of tasks. It reuses the project’s existing categories and tags, adds internal and existing-task edges, and leaves project status unchanged.

Piyaz Review produces a structured approval, request-changes, or block verdict for tasks at in_review and their linked PRs. Use it to judge implementation against the plan, acceptance criteria, and review lenses.