59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
# 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
|
|
|
|
1. **Never brute-force the inbox.** Sample only. The survey builds the draft-one blueprint.
|
|
2. **Bulk operations → lowest-cost path first.** Gmail UI, task order, or pre-built script before Claude tokens.
|
|
3. **Non-technical user standard.** Plain English throughout. No assumed Gmail or API knowledge.
|
|
4. **Claude is the architect.** Final decisions and all Gmail mutations stay with Claude.
|
|
5. **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](https://docs.google.com/spreadsheets/d/1xN3l3CjhkpXQBo6hS85Qii86fC-yILg6qbxd33cChMA)
|
|
- **Drive Folder:** [CW-020 — Gmail Inbox Architect](https://drive.google.com/drive/folders/1oXcHtf7UaBC3rBsVULeBBF2TIgSr8w7p)
|
|
- **Concept Brief:** [CW-020_Concept.md](https://drive.google.com/file/d/1rdSNyscHldKnwII8jti17zPhavwe5KZA/view)
|