overview

name	overview
description	Generate or update project overview document. Use when user wants a project overview, system architecture, big picture, high-level view, or says 'overview', 'architecture overview', 'project summary', 'how does everything connect'.
allowed-tools	Read Grep Glob Bash Write Edit

Generate Project Overview

Create a single document that gives a bird's-eye view of the entire system — all modules, how they connect, tech stack, and current status.

Process

Step 1: Scan Everything

1. Read project root structure (all top-level directories)
2. Read each module's config (package.json, pyproject.toml, etc.)
3. Read docs/00_idea/ for the vision
4. Read docs/02_prd/__00_index.md for all planned work
5. Read docs/04_context/ for quick summaries of each module
6. Read existing overview in docs/01_overview/ if updating

Step 2: Build Overview

Use the template in references/overview-template.md.

The overview should:

• Show the full system at a glance — every module, every connection
• Use mermaid diagrams for architecture and module relationships
• Be the first document a new team member reads
• Stay high-level — link to PRDs and impl plans for details
• Include current status of each module

Step 3: Save File

• Save to docs/01_overview/overview.md
• If docs/01_overview/ doesn't exist → create it
• If file exists → update it with current state (this doc should always reflect reality)