Skip to content
Subaya

Plan your project

Once a project exists and is Git-backed, the next step is planning: turning the idea into design and plan documents and a tracked tree of work items. Subaya’s planning surface is what AI agents drive against, and what you review and approve.

Capture requirements

Section titled “Capture requirements”

Start by recording what the design must do:

Terminal window
suya req add        # add a requirement to the current project
suya req list       # list the project's requirements

Design and plan documents

Section titled “Design and plan documents”

Design and plan documents move through review before work begins. List them, read one, and approve it (or a single section) when it’s ready:

Terminal window
suya plan docs list
suya plan docs show <doc-id>
suya plan docs approve <doc-id>            # approve the whole document
suya plan docs approve <doc-id> --section <section>

Reviews are first-class. Open a round, comment, and resolve:

Terminal window
suya review create <doc-id>
suya review show <review-id>
suya review comment <review-id> ...
suya review approve <review-id>

Work items

Section titled “Work items”

An approved plan produces a tree of work items (epics → stories → tasks). Walk it:

Terminal window
suya plan items list           # the work-item tree
suya plan items show <item-id> # a single item's detail

Open a planning session

Section titled “Open a planning session”

To work interactively (or to let an agent drive), open a session:

Terminal window
suya plan session   # prints how to open a planner session
suya attach         # attach to your session pod

Next steps

Section titled “Next steps”