BetterFleet Dev Wiki

Local architecture and operations wiki for bf-dev (as of 2026-03-03).

Start Here

For most engineering work, read in this order:

1. Process Handbook
2. Product Engineering Workflow
3. Product Engineering Delivery
4. Active Artifacts
5. System Design only when the current story depends on longer-lived design context

Use these supporting entry points when needed:

• Product overview for stakeholders: Product Capabilities
• Environment setup: Onboarding
• CI dry-run operator guide: Terraform Plan Dry Runs
• Linear mirror rules: Product Engineering Workflow in Linear
• Manage feature-flag rollout: GitLab Feature Flags
• In-app docs editing: In-App Docs Authoring
• Release communication guidance: Release Notes
• Runtime and product reference: Software Reference
• Cross-product engineering decisions: Architecture Decision Records

Section Map

Section	Use It For	Start With
Product Capabilities	Stakeholder-facing understanding of what each BetterFleet product does	Product Capabilities
Process	How BetterFleet work is shaped, delivered, and mirrored	Process Handbook
Current Work	The live challenge/spec/story artifact sets for real work	Active Artifacts
System Design	Long-lived design baselines that outlast one delivery slice	System Design
Software Reference	Product, platform, and runtime behaviour once you need implementation context	Platform, Manage, Plan, Shared, Reference
Operations	Environment setup, daily operations, troubleshooting, and testing	Onboarding

Software Reference

• Platform Overview
• Manage Overview
• Plan Overview
• Shared Overview
• Architecture Decision Records
• Service Matrix

Run Locally

./docs/serve-wiki 8088

Open http://127.0.0.1:8088.