Session 7 — Process, Projects & Cleanup
Goal: Review governance docs, active project trackers, and identify cleanup candidates. Estimated time: 45 min
Process & Governance
| # | File | What It Covers |
|---|---|---|
| 1 | guidelines.md | PARA frontmatter spec, content model, agent roles, AI constraints |
| 2 | trunk-based-development.md | TBD workflow, feature flags, expand/contract migrations |
| 3 | AREAS.md | Master index of all area docs with "How to Read" table |
Active Project Trackers
| # | File | What It Covers |
|---|---|---|
| 4 | TODOS.md | 344-line master gap tracker — 10 sections covering product, tech, housekeeping, tooling, refactoring, design decisions, industry gaps, marketing, funding, repo architecture |
| 5 | TODO_BEFORE_FIRST_CLIENT.md | Pre-launch checklist |
| 6 | PRODUCT_schema-feature-gaps.md | Schema-level feature gaps |
Compliance Projects
| # | File | What It Covers |
|---|---|---|
| 7 | gdpr-migration-plan.md | GDPR migration plan (15 KB) |
| 8 | tenant-credentials-encryption-plan.md | Encryption plan (8 KB) |
| 9 | GoBD-Phase2-Implementation-Plan.md | GoBD compliance plan (10 KB) |
| 10 | GoBD-Phase2-Task-Checklist.md | GoBD task checklist |
Other Projects
| # | File | What It Covers |
|---|---|---|
| 11 | docs-hub.md | Docs portal deployment spec (22 KB) |
| 12 | STRATEGY_future-ideas.md | Archived long-term visionary concepts |
Colocated App Docs (skim)
| Location | Files |
|---|---|
apps/workspace/docs/ | fleet-and-staff-specs, dispatch-board, user-journeys, project-roadmap, ux-design-decisions, fleet-and-staff-journeys, product-requirements, pricing-screen, features |
apps/workspace/src/features/*/ | tours.md, boarding-points.md, ancillary-catalog.md, bookings.md, dispatch.md, inbox.md |
apps/booking-widget/docs/ | user-journeys, features |
apps/driver/docs/ | user-journeys, features |
Cleanup Candidates
| File | Issue |
|---|---|
| CONTEXT.md | Stale — links to .antigravity/rules/base.md, duplicates CONTRIBUTING.md |
| progress.md | Orphaned ad-hoc file at repo root |
| agentic-led-company-spec.md | 21 KB — still actively guiding decisions, or should it move to archive? |
🔍 What to Validate
- [ ] TODOS.md: go through every item. Update statuses. Many completed items (
strikethrough) remain — consider pruning. - [ ] TODOS.md has grown into containing detailed implementation specs (e.g., secrets-sync bootstrap) — extract into proper resource docs.
- [ ]
guidelines.mdreferences.antigravity/rules/base.mdfor directory structure — does that file exist? - [ ]
agentic-led-company-spec.mdat 21 KB — still relevant or speculative? - [ ] Colocated app docs: are they consistent with the central area docs? Any contradictions?
- [ ]
AREAS.md: does it list every file in2-areas/? Any missing entries? - [ ] CONTEXT.md: delete or merge its unique links into CONTRIBUTING.md?
- [ ] progress.md: archive or delete?