Branch strategy: SaltyLab / SaltyRover / SaltyTank variants + dev branches #28

Closed
opened 2026-02-28 18:47:12 -05:00 by seb · 0 comments
Owner

Request

We need a proper branching strategy to support multiple chassis/sensor/wheel variants without agents stepping on each other.

Variants

Branch Description
saltylab Original 2-wheel self-balancing bot (current main)
saltyrover 4-wheel rover variant (different chassis, sensors, wheel config)
saltytank Tracked/tank variant

Branch Structure (per variant)

saltylab          ← stable, reviewed, tested
saltylab-dev      ← agents work here, PRs merge to saltylab

saltyrover        ← stable
saltyrover-dev    ← agents work here

saltytank         ← stable
saltytank-dev     ← agents work here

Rules

  • Agents create feature branches off <variant>-dev, PR back to <variant>-dev
  • Reviewed/tested code gets promoted from -dev to the stable variant branch
  • Shared firmware code (IMU drivers, USB CDC, balance core) lives in main and gets merged into variant branches
  • Each agent works in their own feature branch off the appropriate -dev — no direct commits to stable or dev

Action

@max — Please orchestrate:

  1. Create the branch structure
  2. Update agent CLAUDE.md / working instructions to use correct base branches
  3. Decide which shared code stays in main vs variant-specific
  4. Assign agents to variants based on current workload

This avoids the current problem of everyone working on main with different chassis assumptions.

## Request We need a proper branching strategy to support multiple chassis/sensor/wheel variants without agents stepping on each other. ### Variants | Branch | Description | |--------|-------------| | `saltylab` | Original 2-wheel self-balancing bot (current main) | | `saltyrover` | 4-wheel rover variant (different chassis, sensors, wheel config) | | `saltytank` | Tracked/tank variant | ### Branch Structure (per variant) ``` saltylab ← stable, reviewed, tested saltylab-dev ← agents work here, PRs merge to saltylab saltyrover ← stable saltyrover-dev ← agents work here saltytank ← stable saltytank-dev ← agents work here ``` ### Rules - Agents create feature branches off `<variant>-dev`, PR back to `<variant>-dev` - Reviewed/tested code gets promoted from `-dev` to the stable variant branch - Shared firmware code (IMU drivers, USB CDC, balance core) lives in `main` and gets merged into variant branches - Each agent works in their own feature branch off the appropriate `-dev` — no direct commits to stable or dev ### Action @max — Please orchestrate: 1. Create the branch structure 2. Update agent CLAUDE.md / working instructions to use correct base branches 3. Decide which shared code stays in `main` vs variant-specific 4. Assign agents to variants based on current workload This avoids the current problem of everyone working on `main` with different chassis assumptions.
seb closed this issue 2026-02-28 18:56:21 -05:00
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: seb/saltylab-firmware#28
No description provided.