Gmail Inbox Architect — CW-020

A multi-skill CoWork plugin that guides non-technical users through building a systematic Gmail classification pipeline. Claude acts as the permanent architect and quality gatekeeper across multiple sessions. Token-heavy inbox analysis is delegated to flat-rate or lower-cost agents (ChatGPT, Gemini, local LLMs) via structured task orders.

North Star Rules

Never brute-force the inbox. Sample only. The survey builds the draft-one blueprint.
Bulk operations → lowest-cost path first. Gmail UI, task order, or pre-built script before Claude tokens.
Non-technical user standard. Plain English throughout. No assumed Gmail or API knowledge.
Claude is the architect. Final decisions and all Gmail mutations stay with Claude.
No full inbox walk during survey. Draft-one blueprint only — task orders dig the details.

Skills

Skill	Purpose
`survey`	Onboarding interview + label catalog + inbox sample. Creates Tracker, Bible.md, `_status.md`.
`handoff`	Builds a complete task order (prompt + context MD + attachments) for a subcontractor agent.
`import`	Parses batch work from external agents (MD/CSV/XLSX/JSON/XML). Sanity-checks and challenges.
`deploy`	Implements approved rules: Gmail filters + Apps Script walkthroughs.
`rule-review`	Interactive interview over `! Rule Needed` label. Designs rules using full toolbox.

Project Artifacts

Each user project creates its own Drive folder containing:

Bible.md — taxonomy, bylaws, decisions log, environment choice
Tracker.xlsx or Tracker (Google Sheet) — source of truth for all rules
_status.md — checkpoint file for inter-agent/inter-session handoff

Repo Structure

/skills/          — SKILL.md stub for each skill
/references/      — Gmail_Filter_CoWork_Guide.md and methodology docs
/examples/        — Sanitized sample artifacts showing expected formats

Dependencies

Google Workspace MCP (Claude-side — for Gmail filter management and Drive operations)
Gitea optional (only if a Codex-style tool requiring a repo is involved)
No goldbrain dependency — continuity handled entirely via Drive artifacts

V2 Roadmap

studio-flows — Studio flow design assistant (deferred until design patterns are validated)
health-check — Periodic audit of rule health, label drift, DocScan accumulation

CW Registry

ID: CW-020
Status: Proposed
Registry: Project Registry
Drive Folder: CW-020 — Gmail Inbox Architect
Concept Brief: CW-020_Concept.md