Google Sign-In Required

Use your company Google account to access the BetterFleet private content.

Back to private home

BetterFleet Support Private
Skip to content
BetterFleet Dev Wiki
Work Intake and Weekly Planning
Initializing search
    bf-dev
    • Home
    • Process
    • Products
    • Reference
    • Decisions
    • Work
    • Operations
    bf-dev
    • Home
      • Process Handbook
      • BetterFleet Workflow Map
      • Product Development System
      • Product Engineering Workflow
        • Process Workflows
        • Work Intake and Weekly Planning
          • Operating Rules
          • Triage Issue
          • Routing
          • Promotion Into Governed Work
          • Weekly Planning
          • Backlog Management
          • Self-Serve Pickup
        • Product Engineering Workflow in Linear
        • Product Engineering Delivery
        • Agent Guidance
        • Workflow
        • Skills
        • Skill Sources
        • Process Guides
        • GitLab Feature Flags
        • In-App Docs Authoring
        • Release Notes
        • Process Templates
        • Release Plan: <title>
      • Process Publishing
      • Product overview
        • General Reference
          • Core Domain Training
          • System Topology
          • Two-Axis Ontology Model
          • Ontology Primer
          • Worked Example
          • Evidence, Ownership, and Lineage
          • Energy Management
          • Standards and Protocol Map
          • Charging, Roaming, and Commercial Model
          • Charge Planning and Operations
          • Cross-Cutting Domains
          • Domain Coverage Matrix
        • BetterFleet Product Ontology
        • Core Operations Data Ontology
        • BetterFleet R&D Plan
        • Index
        • Architecture
        • Manage Product Capabilities
        • Manage Data and State
        • Manage Service Interaction Flows
        • Manage Reference
        • Manage Internal Application Diagrams
          • Manage Authorization And Permissions
          • bf-manage-core Auth and Authorization Model
          • Manage Authorization and Permissions
          • bf-manage-web Auth and Permission Model
          • Manage Service Catalog
          • bf-depot-sim
          • bf-digital-twin (Manage Role)
          • bf-fleet-health
          • bf-manage-connect
          • bf-manage-core
          • bf-manage-incidents
          • bf-manage-roaming
          • bf-manage-sitepwrmon
          • bf-manage-web
          • bf-schedule-creator (Manage Role)
          • bf-support-microsite
          • bf-telematics
        • Index
        • Architecture
        • Plan Reference
        • Plan Internal Application Diagrams
        • Plan Migration and Flags
        • Plan Simulation Request Lifecycle
          • Plan Service Catalog
          • bf-bnl-schedule-analysis-compute
          • bf-bnl-settings
          • bf-bnl-ui
          • bf-digital-twin (Plan Role)
          • bf-route-modelling
          • bf-schedule-creator (Plan Role)
      • Where to Ask Product Questions
      • Reference
        • Platform Reference
        • Platform Architecture
        • Script Runtime Model
        • Compose Profiles and Modes
        • Repository Map
        • Monolithic Git Transition FAQ
        • Monolithic Git Sizing
        • CI and Release Integration
        • Shared Reference
        • Shared Infrastructure Architecture
        • Secrets and Env Strategy
        • Vendors and Local Dependencies
        • System Reference
        • Cloud Data Dependencies
        • Ports and URLs
        • Service Matrix
          • API Docs
          • OCPI API Docs
          • OCPP API Docs
          • OSCP API Docs
          • VDV API Docs
          • Yard State API Docs
        • System Design
        • System Design: BBA Microgrid Controller Generic Packet Translation
        • System Design: Depot Simulation
        • System Design: IoT Sensor Packet
        • System Design: Microgrid Energy Orchestration
          • System Design: OCPP Profile 3 And ISO 15118 PKI
          • Architecture: BetterFleet OCPP Profile 3 and ISO 15118 PKI
          • Specification: BetterFleet OCPP Profile 3 and ISO 15118 Certificate Lifecycle Management
          • System Design: On-Prem Control
          • Challenge
          • Specification: BetterFleet On-Prem Continuity Control
          • System Design: OSCP
          • OSCP Protocol Documentation
          • Depot Sim Testing Requirements
          • System Design: OSCP Flexibility Provider Domain
      • Decisions
        • Architecture Decision Records
        • 0001 - Record architecture decisions
        • 0002 - Cognito for Authentication and Authorisation
        • 0003 - AWS Amplify for Authentication
        • 0004 - DynamoDB for default database
        • 0005 - Data Persistence
        • 0006 - Trunk-Based Development
        • 0007 - Generalised principle for automation
        • 0008 - Naming Repositories, Services, and URLs
        • 0009 - Use Timezone Aware DateTimes and UTC
        • 0010 - Use semantic release
        • 0011 - Centralized feature flag repository
        • 0012 - Use Named Exports in Storybook
        • 0013 - RESTful TITLE GraphQL
        • 0014 - Service Granularity
        • 0015 - Async/co-routine exception handling pattern
        • 0016 - Logging & log levels
        • 0017 - Instantiated Models
        • 0018 - Repository Pattern for Database Access
        • 0019 - Use of Design Tokens in TypeScript React Application
        • 0020 - API backwards compatibility and versioning
        • 0021 - Alembic Migration strategy
        • 0022 - Consistent react-hook-form usage
        • 0023 - Domain Event-Driven Architecture
        • 0024 - Domain Event Bus Tech Stack
        • 0025 - No enum types in DB table columns
        • 0026 - In-Memory Ormar Stores for Repository testing
        • 0027 - Storing Tab State in Query and Local Storage
        • 0028 - Adopt OpenTelemetry Semantic Conventions for Structured Logging
        • 0029 - Adopt RFC 9457 for HTTP Error Responses
        • 0030 - Use GitLab registry and Terraform state for ECS services
        • 0031 - Adopt DDD, Hexagonal Architecture, and CQRS for Python Domain Services
      • Work
        • Active Work
          • Work: Bba Microgrid Controller
          • Implementation Specification: BBA Microgrid Controller
          • BBA Microgrid Controller Deliverables (Stories)
          • Work: BFDev Monolithic Git
          • Challenge
          • Specification: BFDev Monolithic Git v2
          • BFDev Monolithic Git v2 Stories
          • Work: Complex Circuit Load Balancing
          • Implementation Specification: Complex Circuit Load Balancing
          • Complex Circuit Load Balancing Deliverables (Stories)
            • COR-10 and COR-11 Consolidation Review
          • Work: Dispatch Reliability and Reconciliation
          • Challenge
          • Specification: Dispatch Reliability and Reconciliation
          • Dispatch Reliability and Reconciliation (Unit User Stories)
            • Dispatch populated vehicle cards grey surface snapshot
            • Dispatch Visual Review
          • Work: Enable Scheduled Managed Charger Access
          • Challenge: Enable Scheduled Managed Charger Access
          • Specification Exploration Dossier: Enable Scheduled Managed Charger Access
          • Specification Review: Enable Scheduled Managed Charger Access
          • Specification: Enable Scheduled Managed Charger Access
          • Work: Guided Cut-Off and Release Orchestration
          • Specification: Guided Cut-Off and Release Orchestration
          • Guided Cut-Off and Release Orchestration (Unit User Stories)
          • Work: Production Deployment Validation
          • Challenge
          • Work: Scheduled Report Parity
          • Specification: Scheduled Report Parity
          • Work: Telematics
          • Telematics EventBridge Path
          • Telematics Ingress Architecture
          • Specification: Telematics Migration into bf-manage-core with 5-Minute Freshness and Health Visibility
          • Telematics Core Migration MVP (Implementation-Time BDD)
          • Work: Vector Derms
          • Implementation Specification: Vector DERMS
          • Vector DERMS Deliverables (Stories)
          • Work: Visiting Vehicle Charging Visibility
          • Specification: Visiting Vehicle Charging Visibility
          • Visiting Vehicle Charging Visibility (Unit User Stories)
          • Work: Workspace Owned Stripe Roaming
          • Specification: Workspace-Owned Stripe Credentials for Roaming Payments
        • Backlog Work
          • Work: Microgrid
          • Microgrid Backlog Stories
          • Work: Mobile Ops Companion
          • Challenge
          • Specification: Mobile Operations Companion v1
          • Mobile Operations Companion Deliverables (Stories)
          • Work: Oscp
          • OSCP Backlog Stories
        • Archived Work
          • Work: Code Canonical Orchestration
          • Challenge
          • Specification: Product Engineering Workflow
          • Product Engineering Workflow Deliverables (Unit User Stories)
          • Work: Release Notes Automation
          • Release Plan: Release Notes Automation
          • Release Notes Automation Backlog Stories
      • Operations
      • Onboarding Runbook
        • Operations Runbooks
        • Production Hotfix Release
        • Staging Hotfix Release
        • Manage Staging Release Validation
        • Terraform Plan Dry Runs
        • Operations Tooling
        • Code Indexing
        • Operations Evidence
        • Database Restoration Test Report
      • Daily Operations Runbook
      • Testing Guide
      • Troubleshooting
    • Operating Rules
    • Triage Issue
    • Routing
    • Promotion Into Governed Work
    • Weekly Planning
    • Backlog Management
    • Self-Serve Pickup
    1. Home
    2. Process
    3. Workflows
    Operations & Dispatch Process general

    Work Intake and Weekly Planning¶

    Use this page when adding, routing, or selecting work in Linear. The goal is to keep Linear clean enough that the team can see the weekly plan without needing a spoken status update.

    Operating Rules¶

    • Start unplanned work as one Linear triage issue.
    • Use Todo and the current cycle for this week's selected work only.
    • Create a Linear Project after the work is selected for definition or delivery planning.
    • Keep In Progress aligned with the work someone is actually doing, preferably one active issue per developer.
    • Keep backlog as accepted but unselected work, and resurface it through backlog management.
    • Use the governed workflow when work needs prioritisation, specification, coordination, or sign-off.

    Triage Issue¶

    A triage issue should be short. It only needs enough information to route the work.

    Include:

    • Need or problem.
    • Why it matters.
    • Source or context.
    • Customer, CS, developer, platform, security, data, or release impact.
    • Decision needed next.

    Keep the triage issue as the single seed until the work has been selected.

    Routing¶

    Route Use when Next action
    Freestanding issue The work is small, clear, low-risk, and has a visible done condition. Select it by adding it to this week's cycle (Todo for this workflow), then assign and estimate it before pickup.
    Support/bug The work is a production, customer, or support issue without governed project context. Keep it in support/bug triage until priority, owner, and next action are clear.
    Governed candidate The work is substantial, ambiguous, multi-person, customer-visible, cross-team, architectural, or likely to need sign-off. Keep the triage issue as the seed until the work is selected for challenge framing or definition.
    Backlog The work is valid but not selected now. Move to Backlog with enough context for later review.
    Close The work is not worth preserving as a future candidate. Close as Canceled or Duplicate with a short reason.

    Promotion Into Governed Work¶

    When a triage issue may become governed work, first decide the next stage.

    If the problem is not framed well enough, keep the issue standalone and use it to produce or update the Index challenge. The issue is done when the challenge exists and the next decision is recorded.

    If the challenge is selected for definition, create the Linear Project then. Move or relate the seed issue into the Project as the first definition issue, usually named Define <project name>. That issue is done when the Project specification is signed off and the delivery issues are ready.

    After sign-off, use the Project issues as the execution plan. Each delivery issue should be small enough for focused delivery, with acceptance criteria and visible dependencies.

    Weekly Planning¶

    Run Monday planning from Linear. Use spoken updates to resolve uncertainty, not as the source of the plan. Decisions made in the meeting should be reflected back into Linear through issue state, cycle assignment, owner, scope, blockers, or Project status updates when a Project is relevant.

    Review:

    • Triage items needing a route.
    • Top backlog items surfaced through backlog management.
    • Rolled-over work from the previous cycle.
    • Ready small work.
    • Active governed projects and their next gate.
    • Blocked work needing a decision.

    For each candidate, choose one action:

    • Add to this week's cycle (Todo).
    • Keep or move to Backlog with current context.
    • Promote to challenge framing or definition.
    • Split or narrow before pickup.
    • Close.

    Automatic rollover is a reminder to review, not a commitment to keep doing the same work. Rolled-over issues stay in the cycle only when the team re-selects them for the week.

    Backlog Management¶

    Backlog is for accepted work that is not selected now. It is reviewed through normal backlog management, usually when Phillip or Nikki surface top candidates for planning. When moving something to backlog, leave enough context for a later decision: why it matters, who is affected, and any known trigger, dependency, or priority lens.

    Self-Serve Pickup¶

    Self-serve pickup means choosing the next ready item, not starting parallel side work. Prefer finishing or handing off the current In Progress issue before starting another one.

    Developers can pick up work without extra approval when all of these are true:

    • The issue is selected into this week's cycle.
    • Scope and done condition are clear.
    • Expected impact is low and local.
    • The issue has an owner, estimate, and enough context to finish.

    Small freestanding work should still be weighed against the main weekly plan and the cost of context switching. If it is not urgent enough to interrupt, put it through planning before pickup.

    Pause and surface the work before pickup when it affects customers, CS/support, other developers, permissions, security, data model or migrations, integrations, API contracts, feature flags, release communication, or project scope.

    Made with Material for MkDocs
    BFDev Docs Assistant
    New conversation?
    Ask one focused question at a time, this helps the assistant provide accurate answers about what's been implemented in BetterFleet.