Skip to content

docs: canonical workspace CLAUDE.md (rules only) + workspace-history.md - #24

Merged
mspinola merged 1 commit into
mainfrom
claude/workspace-claude-md-canonical
Aug 30, 2026
Merged

mspinola merged 1 commit into
mainfrom
claude/workspace-claude-md-canonical

Conversation

@mspinola

Copy link
Copy Markdown
Owner

Executes the CLAUDE.md trim work order (npf docs/handoffs/2026-08-29-claude-md-trim-v2.md, PR mspinola/npf#324): the untracked workspace CLAUDE.md (911 lines, 9,728 words) is separated into rules and archaeology, with both halves versioned here.

  • docs/workspace-CLAUDE.md is the rules-only edition (574 lines, ~5,400 words). Category A content is rewritten imperative; category B tripwires compress to rule-plus-one-line; every named tripwire from the acceptance criteria is grep-verified present (verify-pin command, frozen store path, CBOE grep trap, Windows-first seeding, healthy-defer, __file__ check, COTMETRICS_PARAMS sample fallback). Zero em dashes. It lands over the 400-line target because tables, verbatim commands, and governance survive the A/B/C test at full length, which the work order explicitly allows.
  • docs/workspace-history.md receives the category C narrative near-verbatim, dated and grouped to mirror the rules file, including the 2026-08-20 pin story, the CBOE double deletion, the restart-on-failure measurement, and the crowdmon wrong-twice record. It states the rule going forward: corrections are edits plus git history, with a dated entry here only when the mistake itself is instructive.

After merge, the workspace root CLAUDE.md becomes a relative symlink to crucible-stack/docs/workspace-CLAUDE.md (per the human's decision on the handoff's open question 2), so future corrections get diffs instead of in-prose archaeology. The pre-trim file is backed up at the workspace root as CLAUDE.md.bak-2026-08-29.

🤖 Generated with Claude Code

Executes npf docs/handoffs/2026-08-29-claude-md-trim-v2.md: the untracked
workspace CLAUDE.md (911 lines, 9,728 words) is split into rules
(workspace-CLAUDE.md, to be symlinked from the workspace root) and
archaeology (workspace-history.md). Every rule and named tripwire from
the pre-trim file survives; the correction narratives move to the history
file near-verbatim. Pre-trim text backed up at the workspace root as
CLAUDE.md.bak-2026-08-29.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@mspinola
mspinola merged commit a4f63e2 into main Aug 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant