docs: initial Mission Control planning documents

- PLAN.md: Complete implementation plan with architecture, ACs, phases
- CLAUDE.md: Project context for AI agents

Architecture: Tauri + React, beads as universal work graph,
manual-first priority with rich decision logging.
This commit is contained in:
teernisse
2026-02-25 10:40:48 -05:00
commit 954067a38b
7 changed files with 1591 additions and 0 deletions

11
.beads/.gitignore vendored Normal file
View File

@@ -0,0 +1,11 @@
# Database
*.db
*.db-shm
*.db-wal
# Lock files
*.lock
# Temporary
last-touched
*.tmp

4
.beads/config.yaml Normal file
View File

@@ -0,0 +1,4 @@
# Beads Project Configuration
# issue_prefix: bd
# default_priority: 2
# default_type: task

66
.beads/issues.jsonl Normal file

File diff suppressed because one or more lines are too long

4
.beads/metadata.json Normal file
View File

@@ -0,0 +1,4 @@
{
"database": "beads.db",
"jsonl_export": "issues.jsonl"
}

2
.gitignore vendored Normal file
View File

@@ -0,0 +1,2 @@
# bv (beads viewer) local config and caches
.bv/

63
CLAUDE.md Normal file
View File

@@ -0,0 +1,63 @@
# CLAUDE.md
## Project Overview
Mission Control (MC) is an ADHD-centric personal productivity hub built with Tauri + React. It unifies GitLab activity (via gitlore) and beads task tracking into a single native interface.
**Core principle:** Surface THE ONE THING you should be doing right now.
## Key Documents
- `PLAN.md` — Complete implementation plan with architecture, ACs, and reasoning
## Tech Stack
- **Shell:** Tauri 2.0 (Rust backend)
- **Frontend:** React 19 + Vite + Tailwind + shadcn/ui
- **State:** Zustand + TanStack Query
- **Animations:** Framer Motion
## External Dependencies
MC shells out to these CLIs (does NOT import them as libraries):
- `lore --robot` — GitLab data (issues, MRs, activity)
- `br` — Beads task management (create, close, list)
- `bv --robot-*` — Beads triage recommendations
## Local State
All MC-specific state lives in `~/.local/share/mc/`:
| File | Purpose |
|------|---------|
| `gitlab_bead_map.json` | Maps GitLab events to bead IDs (deduplication) |
| `decision_log.jsonl` | Append-only log of all user decisions with context |
| `state.json` | Current focus, queue order, UI state |
| `settings.json` | User preferences |
## Key Architectural Decisions
1. **Beads are the universal task graph** — GitLab items auto-create beads via MC's bridge
2. **Manual priority first** — User sets THE ONE THING, MC logs decisions to learn patterns
3. **CLI integration over library imports** — Clean boundaries, no schema coupling
4. **Rich decision logging** — Every action logged with context and optional reasoning
## Development Commands
```bash
# Frontend dev
npm run dev
# Tauri dev (frontend + backend)
npm run tauri dev
# Build
npm run tauri build
```
## Code Quality
- Run `cargo clippy -- -D warnings` before committing Rust changes
- Run `npm run lint` before committing frontend changes
- Follow existing patterns in the codebase

1441
PLAN.md Normal file

File diff suppressed because it is too large Load Diff