Specs & Docs

Specs & Docs is a built-in set of guided agent workflows for creating and maintaining repository documentation. Instead of generating a generic document in one click, each workflow targets a specific kind of project knowledge.

Available workflows

• Foundation: initialize agent docs, refresh the documentation map, or audit existing documentation.
• System knowledge: document domain terminology, architecture, data flows, interfaces, testing, and operations.
• Decisions & work: record an ADR, create a feature specification, or prepare an implementation plan.

Run a Specs & Docs workflow

1. Open the Supercode menu and select Specs & Docs.
2. Select the documentation task that matches your goal from the submenu.
3. Let the agent inspect the repository and existing documentation.
4. Review its concise change preview and confirm before it writes files.

The workflows answer technical questions from the repository whenever possible and ask only for product intent or decisions that cannot be discovered locally. A documentation request never silently becomes a code change.