Skip to content

docs: two operating rules tonight's failures earned - #56

Merged
m4ttheweric merged 1 commit into
mainfrom
docs-operating-rules
Aug 24, 2026
Merged

docs: two operating rules tonight's failures earned#56
m4ttheweric merged 1 commit into
mainfrom
docs-operating-rules

Conversation

@m4ttheweric

@m4ttheweric m4ttheweric commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator

Both rules are written the way the existing four are: the failure that earned them, stated plainly.

Checkout-is-deployment was implicit in the existing branch rule and got missed by two sessions simultaneously — the dev daemon had been up 12h running whichever branch the shared checkout sat on, so merging #44 put nothing in service until the checkout synced and the daemon restarted.

Re-read a ticket before acting on it. RT-60 grew a section mid-task explaining that the index row about to be pruned was being kept deliberately; the eviction orphaned 8 worktree records and silently stopped reconciliation. Recovered in #55, which also adds the code-level guard (prune now retains any row that still owns data).

🤖 Generated with Claude Code

https://claude.ai/code/session_01Xa2PtoYx2bX1gzwrjEWNVc

Summary by CodeRabbit

  • Documentation
    • Updated operational guidance to reflect the current service count.
    • Clarified branch synchronization and development daemon restart requirements.
    • Added guidance to reread tickets and shared artifacts before taking action.

The checkout-is-deployment half of the branch rule was implicit and got
missed by two sessions at once: a daemon up 12h had been executing
whichever branch the shared checkout happened to be on, so a merge changed
nothing in service.

The ticket rule is new. A prune ran against a ticket that had grown a
section, while the work was in flight, explaining that the row being
removed was kept on purpose; the eviction orphaned a daemon registry and
stopped worktree reconciliation.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@m4ttheweric
m4ttheweric merged commit b42f172 into main Aug 24, 2026
1 of 2 checks passed
@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9914ccf6-68e5-4e82-a09c-a638049ec76c

📥 Commits

Reviewing files that changed from the base of the PR and between 7ccaffd and a79d6e6.

📒 Files selected for processing (1)
  • CLAUDE.md

📝 Walkthrough

Walkthrough

Changes

Developer guidance

Layer / File(s) Summary
Update developer operating rules
CLAUDE.md
The guide now lists six live services. It documents checkout synchronization and daemon restart requirements. It also requires rereading tickets and shared artifacts immediately before action.

Estimated code review effort: 1 (Trivial) | ~2 minutes

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs-operating-rules

Comment @coderabbitai help to get the list of available commands.

@m4ttheweric
m4ttheweric deleted the docs-operating-rules branch August 24, 2026 17:49
m4ttheweric added a commit that referenced this pull request Aug 24, 2026
docs: two operating rules tonight's failures earned
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