Welcome.

SpecGraph turns a rough idea into a complete, agent-ready specification document. It walks a project through nine governed phases — vision, features, brief, design, architecture, quality, security, handoff, progress — and produces one Markdown file an AI coding agent can execute end-to-end.

These docs cover what's in the app today. They live as plain Markdown in content/help/ and are versioned alongside the code, so anyone can edit a page through a normal pull request.

How these docs are organised #

• Start here — the welcome page and a 5-minute tour for new accounts.
• Concepts — the mental model: projects, phases, the knowledge base.
• Workspace — the dashboard, portfolio, knowledge browser, address book, and settings.
• Inside a project — the panels, flows, and pages you'll live in once a project is open.
• Tools — the command palette and the AI Improve menu.
• Guides — task-shaped walkthroughs: inviting teammates, collecting wishes from external reviewers, picking AI models.
• Reference — keyboard shortcuts and a glossary you can scan.

When something is missing #

If a page doesn't answer your question, that's a gap worth closing. Open a pull request that adds a Markdown file under content/help/<section>/ and append it to content/help/_meta.ts. The new page appears in the sidebar on the next deploy — no build steps, no database, no special tooling.

What this is not #

This isn't internal engineering documentation. Architecture decisions, operational runbooks, and the product requirements document live in the top-level docs/ folder of the repository and are read only by contributors. These pages are written for the people using the app.