local-fs: .devwork commit opt-out must be a declaration, not a hand-revert #16

Open
opened 2026-08-11 14:56:50 +00:00 by jbr870 · 0 comments
Owner

Observed failure

local-fs commits .devwork/ by default. That default was rejected by the user and hand-reverted on
a real project — and because it is a default rather than a declaration, a future /setup run would
silently reverse the fix
.

What it needs

A forge: block declaration read by bootstrap_project — e.g. forge.local_fs.commit_devwork: true|false
— so the choice is recorded in the project's CLAUDE.md and survives re-running setup.

Why the shape matters

This is the suite's own rule applied to itself: absence is never a silent default. A hand-edit that
setup can undo is not a decision, it is a temporary state. The fix is not "change the default" — it is
"make it declared".

Source: dogfood retrospective 2026-08-07 (F5), deferred backlog.

## Observed failure `local-fs` commits `.devwork/` by default. That default was **rejected by the user and hand-reverted** on a real project — and because it is a default rather than a declaration, **a future `/setup` run would silently reverse the fix**. ## What it needs A `forge:` block declaration read by `bootstrap_project` — e.g. `forge.local_fs.commit_devwork: true|false` — so the choice is recorded in the project's CLAUDE.md and survives re-running setup. ## Why the shape matters This is the suite's own rule applied to itself: **absence is never a silent default**. A hand-edit that setup can undo is not a decision, it is a temporary state. The fix is not "change the default" — it is "make it declared". *Source: dogfood retrospective 2026-08-07 (F5), deferred backlog.*
Sign in to join this conversation.
No description provided.