Busflow Docs

Internal documentation portal

Skip to content

Session 7 — Process, Projects & Cleanup

Goal: Review governance docs, active project trackers, and identify cleanup candidates. Estimated time: 45 min

Process & Governance

#FileWhat It Covers
1guidelines.mdPARA frontmatter spec, content model, agent roles, AI constraints
2trunk-based-development.mdTBD workflow, feature flags, expand/contract migrations
3AREAS.mdMaster index of all area docs with "How to Read" table

Active Project Trackers

#FileWhat It Covers
4TODOS.md344-line master gap tracker — 10 sections covering product, tech, housekeeping, tooling, refactoring, design decisions, industry gaps, marketing, funding, repo architecture
5TODO_BEFORE_FIRST_CLIENT.mdPre-launch checklist
6PRODUCT_schema-feature-gaps.mdSchema-level feature gaps

Compliance Projects

#FileWhat It Covers
7gdpr-migration-plan.mdGDPR migration plan (15 KB)
8tenant-credentials-encryption-plan.mdEncryption plan (8 KB)
9GoBD-Phase2-Implementation-Plan.mdGoBD compliance plan (10 KB)
10GoBD-Phase2-Task-Checklist.mdGoBD task checklist

Other Projects

#FileWhat It Covers
11docs-hub.mdDocs portal deployment spec (22 KB)
12STRATEGY_future-ideas.mdArchived long-term visionary concepts

Colocated App Docs (skim)

LocationFiles
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

FileIssue
CONTEXT.mdStale — links to .antigravity/rules/base.md, duplicates CONTRIBUTING.md
progress.mdOrphaned ad-hoc file at repo root
agentic-led-company-spec.md21 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.md references .antigravity/rules/base.md for directory structure — does that file exist?
  • [ ] agentic-led-company-spec.md at 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 in 2-areas/? Any missing entries?
  • [ ] CONTEXT.md: delete or merge its unique links into CONTRIBUTING.md?
  • [ ] progress.md: archive or delete?

Findings

Internal documentation — Busflow