Process Handbook¶

This section documents how BetterFleet work moves from signal to handoff.

Start zoomed out. Use the system map and core model first, then drill into the specific guide that answers the next question.

Reading Order¶

Step	Document	Read when
1	Workflow Map	You need the whole shape quickly.
2	Product Development System	You need the core operating model for all work.
3	Work Intake and Weekly Planning	You are adding, routing, selecting, or reviewing work in Linear.
4	Product Engineering Workflow	Triage has selected the governed product route.
5	Product Engineering Workflow in Linear	You need Linear Project, issue, estimate, cycle, or status rules.
6	Product Engineering Delivery	You are delivering a ready governed story or execution issue.
7	Agent Workflow	You need the short Codex/Symphony runtime entrypoint.

Document	Purpose
Workflow Map	Compact visual orientation.
Product Development System	The main human-readable operating model.
Work Intake and Weekly Planning	Practical Linear triage, backlog, cycle planning, rollover, and self-serve pickup.
Product Engineering Workflow	Governed product route after triage selects it.
Product Engineering Workflow in Linear	BetterFleet rules for using Linear as the operating surface.
Product Engineering Delivery	Delivery evidence, done conditions, and staging validation.
Agent Guidance	Published mirror of root workflow and agent skill instructions.

Document	Use when
Release Notes	Shipped scope should appear in release communication.
In-App Docs Authoring	Users see, expect, notice, or need to do something differently.
GitLab Feature Flags	A Manage feature flag affects rollout, release notes, help docs, or retirement.

Section	Purpose
`workflows/`	Detailed workflow companions.
`agent-guidance/`	Published agent workflow and skills mirror.
`guides/`	Recurring task guides.
`templates/`	Reusable process templates.
`publishing/`	Documentation publishing mechanics.