# Big Plan

> Good AI output depends on a great plan.

The plan is where the real decisions get made: what to build, how, and why.
Plans are a big deal, and Big Plan treats them like one: it makes plan review a first-class experience so people and agents reach agreement before the agent acts.

## Intro

- [What is Big Plan?](https://bigplan.dev/intro/what-is-big-plan.md): Big Plan turns your agent's MDX plan into a document built for review.
- [Demo](https://bigplan.dev/intro/demo.md): See a fully rendered big plan in light and dark appearances, with typed components in action.
- [Features](https://bigplan.dev/intro/features.md): Everything the Big Plan viewer ships today, at a glance.
- [Installation](https://bigplan.dev/intro/installation.md): Give your agent one stable prompt and it sets up the current Big Plan workflow.
- [Big Plan vs. Other](https://bigplan.dev/intro/vs-other.md): How Big Plan compares to Lavish and Agent-Native Plans, and the two bets it makes differently.

## Architecture

- [How Big Plan works](https://bigplan.dev/architecture.md): Why Big Plan treats a plan as a compiled document, and how that design produces machine-readable JSON, a self-contained review document, or portable Markdown.

## Components

- [Components](https://bigplan.dev/components.md): The component library that renders each kind of plan information in a first-class way.
- [Callout](https://bigplan.dev/components/callout.md): An accent-bordered panel with a typed icon and title, for the notes, tips, warnings, and dangers a plan reviewer must not miss.
- [CodeDiff](https://bigplan.dev/components/code-diff.md): A reviewable single-file unified diff with line numbers, counts, and line-anchored annotations.
- [CodeSnippet](https://bigplan.dev/components/code-snippet.md): A component for code excerpts with optional file identity, file-absolute line numbers, and line-anchored notes.
- [DataTable](https://bigplan.dev/components/data-table.md): A component for a dataset the reviewer queries in place - sortable columns, optional search, selectable columns, group-by, a table-wide summary, and a text-fit choice instead of a horizontal scrollbar.
- [DatabaseTableSchema](https://bigplan.dev/components/database-table-schema.md): A component for one database table's schema, rendered as a psql-style columns grid with keys, indexes, checks, and titled verbatim-DDL bands.
- [Decision](https://bigplan.dev/components/decision.md): A compact option-by-option choice with inline considerations.
- [DecisionAnalysis](https://bigplan.dev/components/decision-analysis.md): A keyed criteria matrix for auditing or interactively choosing a weighty decision.
- [FileTree](https://bigplan.dev/components/file-tree.md): A component for a plain project file hierarchy, with directories, files, and optional per-entry notes.
- [FileTreeDiff](https://bigplan.dev/components/file-tree-diff.md): A component for comparing project file hierarchies in combined or side-by-side views.
- [FlowDiagram](https://bigplan.dev/components/flow-diagram.md): A staged diagram of tinted node cards joined by verb-labeled, directed connectors, with an explicit fork when one node feeds several.
- [MermaidDiagram](https://bigplan.dev/components/mermaid-diagram.md): A compile-time Mermaid diagram rendered as static, reviewable light and dark SVGs without a browser Mermaid runtime.
- [GraphqlOperation](https://bigplan.dev/components/graphql-operation.md): A component that renders one GraphQL query, mutation, or subscription as a kind-badged review card with arguments, return type, and executable examples.
- [GrpcMethod](https://bigplan.dev/components/grpc-method.md): A component that renders one gRPC method as a review card headed by the authentic proto signature with streaming badges, field lists, and canonical error codes.
- [HttpEndpoint](https://bigplan.dev/components/http-endpoint.md): A component that renders one HTTP endpoint as a structured API review card with parameters, request, and responses.
- [Part](https://bigplan.dev/components/part.md): The self-closing act divider - a numbered band that groups the sections after it into one act of the deck.
- [QuickSummary](https://bigplan.dev/components/quick-summary.md): A standout card of the plan's key points, capped at five bullets and six hundred characters so it stays a summary.
- [QuickDecision](https://bigplan.dev/components/quick-decision.md): One small brief-format question without a comparison expander.
- [Slide](https://bigplan.dev/components/slide.md): The self-closing type marker that connects a recurring slide role to its specific authoring guidance and structural name.
- [TableOfContents](https://bigplan.dev/components/table-of-contents.md): The plan in one look - one linked row per section, each carrying the section's one-line gist.
- [Wireframe](https://bigplan.dev/components/wireframe.md): True-size product screens with honest device proportions, safe content growth, an open drawing vocabulary, and short walkable prototypes.

## Reference

- [CLI reference](https://bigplan.dev/reference/cli.md): Reference the complete Big Plan command surface, defaults, results, and errors.
- [Reviewing a plan](https://bigplan.dev/reference/reviewing.md): Review, revise, and approve a plan through the local runtime.
- [Linting rules](https://bigplan.dev/reference/lint-rules.md): Every authoring lint rule Big Plan enforces, with the exact boundaries that keep each one conservative.
- [Security](https://bigplan.dev/reference/security.md): How to report a vulnerability in Big Plan, what is supported, and how the local review runtime and the published package are designed.

## For Agents

- [For Agents](https://bigplan.dev/for-agents.md): Documentation written for coding agents that operate Big Plan; humans are welcome, but it is not written for them.
- [Use the skill](https://bigplan.dev/for-agents/use-the-skill.md): Install Big Plan's thin agent skill shell and keep authoring rules fresh via the CLI.
- [Render a plan for human review](https://bigplan.dev/for-agents/render-a-plan.md): Follow the exact operational workflow an agent uses to hand a rendered plan to a person.
- [Authoring plans](https://bigplan.dev/for-agents/authoring-plans.md): What a Big Plan document is, how the guidance gate works, and where each kind of authoring rule actually lives.

## Other

- [Why Big Plan?](https://bigplan.dev/intro/why-big-plan.md): The big decisions happen in the plan, while they're still cheap to change; reviewing them deserves a first-class experience.