> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ref.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Ref vs Notion & Google Docs

> Why general-purpose document tools are different from Ref's plan-to-agent workflow.

Looking for a Notion alternative or Google Docs alternative for engineering specs, planning, or spec review? Teams often start there because those tools are familiar document editors, but they were not built for the plan -> do -> plan rhythm that AI-assisted engineering creates. Ref is built for teams doing more planning and spec review: a focused place for engineers and cross-functional partners to review the plan, launch coding agents, and track the resulting PRs.

## Snapshot

|                    | Notion & Google Docs                                                                       | Ref                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
| Best for           | Full-featured document editing for many kinds of teams and docs                            | Focused engineering plans that drive agent implementation                  |
| Scope              | Broad editor features for writing, publishing, databases, wikis, and general collaboration | Scoped to the engineering plan -> agent -> PR loop                         |
| Developer workflow | Comments, suggestions, and collaborative editing                                           | Comment -> review -> resolve workflow modeled after PR review              |
| Codebase awareness | Manual links, pasted snippets, or context you add yourself                                 | Reads connected repos to research and ground plans in your code            |
| Agent handoff      | Copy a doc or prompt into an external agent                                                | Launch and track Cursor, Devin, Codex, Claude Code, and more from the plan |
| Progress tracking  | Separate from the doc unless you build a custom process                                    | Agent status, updates, and PR links flow back into the plan                |

## General Docs vs Engineering Plans

Notion and Google Docs are excellent document editors. They have broad feature sets for writing, publishing, databases, wikis, and general collaboration across many kinds of teams. Ref is intentionally narrower: it is scoped specifically for engineers moving work through the plan -> agent -> PR loop.

### Notion and Google Docs' Approach

Notion and Google Docs give teams familiar, full-featured document editing surfaces.

**Strengths:**

* Fast collaborative editing for prose and specs
* Flexible formatting, comments, and sharing
* Broad document-editor features that support many non-engineering workflows
* Strong fit for evergreen company docs, meeting notes, and broad knowledge bases

**Limitations for this workflow:**

* Many document-editor features are useful in other contexts but unnecessary for engineering planning and agent orchestration
* Comments and suggestions are not connected to an engineering review state, task handoff, or PR outcome
* The document does not know your codebase unless someone manually pastes links and snippets
* Coding agents do not launch from the doc or report progress back into it by default

### Ref's Approach

Ref treats the plan as the live workspace for in-flight engineering work. It does not try to be a general document editor; it focuses on the pieces engineers need to review decisions, start agents, and track what comes back.

Ref emphasizes three pieces that general-purpose docs do not try to own:

1. **Developer workflow** - Ref's comment -> review -> resolve loop works more like a PR review than an open-ended document thread. Feedback can be tied to plan changes before implementation starts.
2. **Codebase indexing** - Ref reads connected repos, researches existing patterns, and grounds the plan in your actual code instead of relying only on manually pasted context.
3. **Coding-agent integration** - Launch Cursor, Devin, Codex, Claude Code, and more from the plan. Agents read the plan as context, work from the same source of truth, and report progress back through MCP tools.

## Why Ref Wins for This Job

**Plan review before implementation:** Ref gives teams a place to review the important decisions before a diff exists. That moves alignment earlier, when it is cheaper to change direction.

**Code-aware planning:** Because Ref can read your connected repos, plans can reference real file paths, architecture, APIs, and existing patterns. The plan starts closer to the code the agent will change.

**Agent-native handoff:** The same document that captures the decision can launch the implementation agent. There is less copy/paste between a planning doc, a chat thread, and a PR.

**Progress comes back to the source of truth:** Agents can send status, questions, and PR links back to the plan, keeping the coordination surface in one place.

**Scoped for engineers:** Notion and Google Docs remain great tools for prose and general docs. Ref is deliberately scoped to collaborative engineering plans that become agent work and PRs, without carrying a broad document editor's full feature surface into that workflow.

## Learn more

Learn more about [writing your first plan](/plans/getting-started/your-first-plan), [reviewing plans](/plans/collaboration/reviews), and [orchestrating multiple agents](/plans/workflows/multi-agent).