Files

T

jpmschweitzerandClaude Opus 4.6 dd75203d11 refactor(process): replace persistent team worktrees with ephemeral sprint branches

Persistent worktrees (server, client, copy, audio, visual, ci, planning,
maintenance) caused agents crossing boundaries, stuck agents leaving
uncommitted work, and index.lock collisions. Replaced with ephemeral
sprint branches (sprint-{N}/{team}) and worktrees created on demand.

Changes:
- New start-sprint script replaces start-session (dynamic tabs per active team)
- Sprint teardown integrated into sprint-start skill (A1c step)
- SR_DB_PATH env var for database access from any directory
- CLAUDE.md team boundaries rewritten (scope-based, not directory-based)
- Agent Rule 0 updated to team scope dirs instead of worktree isolation
- PR review uses git show instead of cross-directory reads
- Briefing template updated for sprint-{N}/{team} branch naming
- Deleted worktree-update skill (obsolete)
- Removed WORKTREE_TEAM env var and cross-directory Read permissions
- All 8 persistent worktrees removed

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-05 00:33:02 +02:00

2.4 KiB

Raw Blame History

Sprint Briefing Template

Each team gets one briefing file at docs/sprints/sprint-N/<team>.md.

File structure

# Sprint N: <Theme> — <Team> Tasks

**Goal:** <One-sentence sprint goal, shared across all teams>

**Branch:** `sprint-{N}/<team>`
**Agents:** <Agent names and roles>

## Carry-over from Sprint N-1

(Only if there are incomplete tickets from the previous sprint)

| # | Title | Status | Notes |
|---|-------|--------|-------|
| #ID | Title | status | Why it carried over |

## New Tickets

| # | Title | Blocked by |
|---|-------|------------|
| #ID | Title | #dependency or — |

Use `tooling/db/ticket show <id>` for full details.

## Key Decisions

- `decisions/<domain>.md` — D-NNN (short name), D-NNN (short name)

## Open Questions to Resolve Early

(Only if there are Q-NNN items that block sprint tickets)

- **Q-NNN: Title** — Brief context. Resolve before #ID starts.

## Notes

One bullet per ticket with:
- What exists already (files, modules, stubs)
- What the ticket actually needs to deliver
- Integration points with other tickets
- Non-obvious gotchas

## Dependency Chain

#A (name) → #B (name) → #C (name) #D (name) → standalone, parallel track


## PR Workflow

When ready to submit, create a PR with `tea` CLI. **All flags are required** to avoid TTY prompts (see CLAUDE.md "Gitea access" section):
\```bash
tea pr create --repo jpmschweitzer/settled-reach --login schweitz --title "feat(<scope>): description" --description "body" --base main --head sprint-{N}/<team>
\```

Joint briefing extras

The joint.md file additionally includes:

Pre-Sprint table: decisions/schema work that must happen before implementation
Sprint Completion Proof: concrete observable criteria (what you can see/do when the sprint is done)
Test plan alignment with D-030 phases

Team assignments

Team	Branch	Agents	Scope
server	`sprint-{N}/server`	Dudley (simulation), Oscar (networking)	server/, Rust/bevy_ecs simulation
client	`sprint-{N}/client`	Stig (UI), Oscar (networking)	client/, Godot rendering
copy	`sprint-{N}/copy`	Mellanie, Paula, Miri	wiki/, docs/atlas/, content/
joint	both	All implementation agents	Integration, proofs, cross-team schema
content	(none)	Mellanie, Paula, Miri, Araminta	Content authoring, no code branch

2.4 KiB Raw Blame History

Sprint Briefing Template

File structure

Joint briefing extras

Team assignments

2.4 KiB

Raw Blame History