solcom / docs / wiki / parallel-loops

Parallel Loops

Worktree-basierte Hintergrund-Pipeline für mehrere parallele Build-/Review-Loops am SOLCOM-Repo. Dual-Mode (Claude-Code-Built-in für kurze Sub-Agent-Loops, Custom-Skill für detached Multi-Stunden-Loops), gemeinsame DDEV-Infrastruktur pro Worktree.

Last synced: 2026-05-14 · Tags: dev-infra, worktree, ddev, sandcastle, loops · Audit: ../LOG.html

Mechanik-Familie

In-Session-Mode — Claude-Code-Built-in Agent(isolation: "worktree", run_in_background: true). Erzeugt temporären Worktree für einen Sub-Agent, läuft parallel zur Master-Session, Cleanup automatisch bei No-Change. Default für sub-stündige Loops.
Detached-Mode — Custom-Skill solcom-worktree. Sub-Workflows spawn, list, cleanup. nohup claude --print --dangerously-skip-permissions überlebt Master-Session-Ende. Logs in .worktree-logs/.
Geteilte Infrastruktur — .ddev/config.yaml ohne name:-Key (DDEV Auto-Name nach Verzeichnis), Skill solcom-ddev-bootstrap kapselt ddev snapshot restore + ddev start + drush cr, peer-Worktree-Layout unter ../solcom-worktrees/<key>/.

Aggregierte Quellen

Strand	Ref	Inhalt
adr	0030-worktree-based-parallel-pipeline	Wende von „kein Worktree" zu „Worktree-Standard", Dual-Mode-Begründung, Rejected alternatives (Pure-In-Session, Pure-Detached, Multiple-Clones, Inside-Repo, tmux), Disk-/RAM-/Token-Consequences.
skill	solcom-ddev-bootstrap	Provisioniert DDEV-Site im aktuellen Verzeichnis aus Primary-Snapshot. Idempotent. Wird von beiden Modes aufgerufen.
skill	solcom-worktree	Detached-Mode-Lifecycle: `spawn`, `list`, `cleanup`. `nohup`-Background-Prozess mit PID/Log-Tracking.
external	ddev.com/blog/git-worktree-contributor-training	Ursprungs-Pattern: `name:`-Key raus aus committed Config, peer-Worktrees, Snapshot-Restore. Quelle für die Mechanik-Entscheidung.
claude-code	`Agent isolation: worktree`	Built-in-Feature des Claude-Code `Agent`-Tools — temporärer Worktree pro Sub-Agent, Auto-Cleanup bei No-Change. Kombiniert mit `run_in_background: true` für parallele Sub-Agent-Loops.

Mode-Auswahl-Heuristik

Kurzer Build/Review aus Master-Session (z. B. /implement für eine Story, auto-review-fix auf einem Branch) → In-Session via Agent(isolation: "worktree", run_in_background: true)
Multi-Stunden-Loop, der Master-Session-Ende überleben soll (z. B. Sandcastle-AFK-Watcher, dauerhafter ralph-loop) → Detached via solcom-worktree spawn
Mehrere autonome Background-Prozesse parallel ohne pro Loop ein Terminal-Tab offen zu halten → Detached
Sub-Agent, der nichts ändert (Analyse, Reporting) → In-Session; Auto-Cleanup räumt den Worktree weg

Was diese Page nicht ist

Keine Decision. Topologie- oder Mechanik-Änderung gehört in einen neuen ADR — nicht hier. ADR-0030 ist der primäre Anker.

Kein Skill-Quellcode. Trigger, Sub-Workflows, Akzeptanzkriterien stehen in den jeweiligen SKILL.md-Dateien unter .claude/skills/.

Kein Telemetrie-Dashboard. Ein HTML-Report über laufende Background-Loops ist eine offene Folge-Story (siehe ADR-0030 „Folge-Stories"), gehört nicht in diese Wiki-Page.

Kein Onboarding-Doc. Setup-Schritte für ein frisches macOS sind in CLAUDE.md bzw. README.md, nicht hier.