david/pi-loop
Watch
1
0
Fork
You've already forked pi-loop
 0
Code Issues 20 Pull requests Projects Releases Packages Wiki Activity Actions

documentation: add ADR-022 and implementation plan for configurable worktree dir #319

Merged
david merged 1 commit from documentation/2026-11-06/adr-022-worktree-dir-docs into main 2026-11-05 21:23:32 +00:00
Conversation 0 Commits 1 Files changed 2 +590
david commented 2026-11-05 21:22:06 +00:00
Owner
Copy link

Adds the design record and build plan for the configurable worktree directory feature (worktree: section in piloop-config.yaml).

Files

  • docs/adr/022-configurable-worktree-dir.md — ADR-022 (Accepted): the worktree: section schema (enabled + dir), the no-hidden-defaults decision table, dir path rules (absolute, no tilde, not inside the repo), parse-time validation as ConfigFileError, registry-wins resume semantics, worktree mode for normal clones (linked worktree, .git as file), state location at the launch repo root, and the widened early-fetch gate.
  • docs/implementation-plan-configurable-worktree.md — step-by-step implementation plan (config schema → parse-time dir validation → worktree resolution routing → normal-clone enablement → CLI/tests/docs), written to be built from directly.

Why now

The decisions are settled (ADR marked Accepted); shipping the docs first lets the implementation work be picked up against a stable record. No code changes in this PR.

Adds the design record and build plan for the configurable worktree directory feature (`worktree:` section in `piloop-config.yaml`). **Files** - `docs/adr/022-configurable-worktree-dir.md` — ADR-022 (Accepted): the `worktree:` section schema (`enabled` + `dir`), the no-hidden-defaults decision table, `dir` path rules (absolute, no tilde, not inside the repo), parse-time validation as `ConfigFileError`, registry-wins resume semantics, worktree mode for normal clones (linked worktree, `.git` as file), state location at the launch repo root, and the widened early-fetch gate. - `docs/implementation-plan-configurable-worktree.md` — step-by-step implementation plan (config schema → parse-time dir validation → worktree resolution routing → normal-clone enablement → CLI/tests/docs), written to be built from directly. **Why now** The decisions are settled (ADR marked Accepted); shipping the docs first lets the implementation work be picked up against a stable record. No code changes in this PR.
david merged commit 93b3132afa into main 2026-11-05 21:23:32 +00:00
david deleted branch documentation/2026-11-06/adr-022-worktree-dir-docs 2026-11-05 21:23:33 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
batch

   
bug

   
chore
Maintenance tasks, cleanup, housekeeping

  
documentation

   
enhancement

   
pi-loop

   
ready

   
resume
No labels
batch
bug
chore
documentation
enhancement
pi-loop
ready
resume
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
david/pi-loop!319
No description provided.