Generating docs

Docs are written by the AI from your actual code. Have Modus propose and draft a whole set at once, or ask for a single doc on demand.

Bootstrapping from empty

On an empty project, the Docs chapter shows suggested docs (README, Architecture, API, Runbook) with a Generate all docs button. Hit it and Modus analyzes the workspace, proposes a set of three to six docs, and drafts them in order. The rail fills in as each one saves.

Proposing a set

Behind the scenes, Modus looks at the project title, the PRD summary, the workspace file list, and any contracts, then proposes a doc set, each with a slug, title, path, and one-line purpose. README maps to README.md; everything else lands under docs/.

Drafting one doc

You can also just ask: "Draft the API documentation". The agent reads the relevant files, detects what it needs (endpoints, payloads), writes the markdown, and saves it. The rail picks up the new doc automatically.

The docs chat

On its first turn, the chat is handed a summary of your current docs and their statuses, so it knows what exists and what's stale before you ask.