Before you pick up a project, find one that's ready, and read what it asks for. You can do this yourself, or ask your coding agent: "What projects are ready to build in Grove?"

This lists every project you can see, grouped by initiative. Each row shows the project's ID (such as P-003), its short and long names, status, priority, target date, and lead. The project assigned in this worktree is marked [assigned].

Narrow the list with filters:

Repeat a filter to match any of its values, such as --status ready --status building. Use different filters together to match all of them.

After the list, Grove shows the command to pick up each project.

The statuses are Unplanned, Planning, Ready to build, Building, and Built. Pick up projects that are Ready to build.

A project's spec is two documents:

Grove prints the summary first, then the requirements. To print only one, add --summary or --requirements. Reading a spec doesn't pick up the project, and writes nothing to your computer.

If a document is missing, Grove says why, such as "This project's summary has not been written yet."

For the project's details, such as its lead, members, and dates, run grove project show P-003.

A project is one piece of a bigger initiative. To understand the whole problem, read the initiative's plan:

grove initiative view prints the initiative's Opportunity and Solution, its Scope with the projects it holds, and its other documents.

A project can also have Scratchpad files, such as research notes and mockups.