Busflow Docs

Internal documentation portal

Skip to content
Reviewed 05 May 2026

< Prev | Up: Session Overview

Session 7 β€” Process, Projects & Cleanup ​

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

Process & Governance ​

#FileLinesWhat It Covers
1guidelines.md~110PARA frontmatter spec, agent roles, AI constraints
2trunk-based-development.md~60TBD workflow, feature flags, migrations
3AREAS.md~70Master index of all area docs

Active Project Trackers ​

#FileLinesWhat It Covers
4TODOS.md343Master gap tracker β€” 10 sections
5TODO_BEFORE_FIRST_CLIENT.md~50Pre-launch checklist
6PRODUCT_schema-feature-gaps.md~100Schema-level feature gaps

Compliance Projects ​

#FileLinesWhat It Covers
7gdpr-migration-plan.md~150GDPR migration plan
8tenant-credentials-encryption.md~80Encryption plan
9GoBD-Phase2-Implementation-Plan.md~100GoBD compliance plan
10GoBD-Phase2-Task-Checklist.md~40GoBD task checklist

Other Projects ​

#FileLinesWhat It Covers
11docs-hub.md~200Docs portal deployment spec
12STRATEGY_future-ideas.md~86Archived 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
agentic-led-company-spec.md382 lines β€” actively guiding decisions, or 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 382 lines β€” 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?

πŸ—ΊοΈ Mindmap & Path Optimization ​

Grab your pen and paper:

  • [ ] Assess Colocated Feature Docs vs. Central Docs: Draw the relationship between apps/workspace/src/features/tours/tours.md and docs/2-areas/domain/domain-backoffice.md.
    • Observation: Having feature specs scattered inside the codebase is great for context, but terrible for discoverability.
    • Optimization: Should AREAS.md act as an index that explicitly links to these colocated feature docs?

πŸ“ Findings & Actions ​

SeverityFile / TopicIssue & Optimization PotentialAction Required

< Prev | Up: Session Overview

Internal documentation β€” Busflow