Conversation
2 tasks
There was a problem hiding this comment.
Pull request overview
Adds a new P1 backlog trajectory row (B-0158) proposing a migration to a .claude/rules/<rule>.md layout and enforcing a carved-sentences-only compression constraint, aimed at reducing always-on context load and improving rule discoverability.
Changes:
- Introduces backlog row B-0158 with outcomes, external anchor, and phased migration plan.
- Captures dependencies and composition links to related backlog rows/memory entries.
- Defines Phase 1 acceptance criteria including a carved-sentences linter concept.
…nces-only constraint (Aaron 2026-05-01) Aaron 2026-05-01 directional input: *"i mean honestly the way ../no-copy-only-learning-agents-insight does .claude/rules seems like the way to go and you are only allowed carved statments in the rules compression is key."* Outcome-driven framing (parallel-trajectories per docs/active-trajectory.md): 1. Reduce always-on context-load — CLAUDE.md 23.7k + GOVERNANCE.md 40.4k (AT proven 40k ceiling) + AGENTS.md 19.2k = 107.5k always-on chars across our four surfaces. Sibling-repo experience indicates measurable performance impact above 40k per-file. 2. Reduce goldfish-ontology recurrence — per-rule canonical homes make pre-author grep cheap. 3. Carved-sentences-only compression — Aaron's tighter constraint (sibling repo carries prose bodies; we carve to blade-shape). 4. DORA lead-time — every session-wake pays the always-on tax. External anchor: sibling repo's claude-md-lean.md documents the proven incident (Large CLAUDE.md will impact performance 50.1k > 40.0k); mitigation was the .claude/rules/<rule>.md split. We are 23.7k on CLAUDE.md today + 40.4k on GOVERNANCE.md — ceiling on the horizon, not theoretical. Three phases: - Phase 1 (P1) — directory + 3 pilot rules (verify-before-deferring, future-self-not-bound, substrate-or-it-didn't-happen) + carved-sentences linter as B-0153 candidate class. - Phase 2 (P2) — bulk migration of standing rules from CLAUDE.md + GOVERNANCE.md. - Phase 3 (P3) — parallel-harness consolidation (@<path> references to .cursor/rules/<rule>.mdc). Carries depends_on: [B-0006, B-0153] per the forward-compat schema landed in the 2026-05-01 backlog-hygiene extension.
…+ replace PR-number with stable framing (Copilot 6 threads)
AceHack
force-pushed
the
backlog/b0158-claude-rules-pattern-carved-sentences-only-aaron-2026-05-01
branch
from
5d4d398 to
4061340
Compare
AceHack
deleted the
backlog/b0158-claude-rules-pattern-carved-sentences-only-aaron-2026-05-01
branch
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Aaron 2026-05-01 directional input:
"i mean honestly the way ../no-copy-only-learning-agents-insight does .claude/rules seems like the way to go and you are only allowed carved statments in the rules compression is key."
Files B-0158 capturing the design + carved-sentences-only constraint.
Outcome-driven framing
This row is a trajectory (per parallel-trajectories discipline). Outcomes solved:
External anchor
Sibling repo
../no-copy-only-learning-agents-insightships this pattern at production scale (proven incident: "Large CLAUDE.md will impact performance 50.1k > 40.0k"). Mechanical anchor, not Aaron-as-anchor.Three phases
@<path>references to.cursor/rules/<rule>.mdc).Dependencies
depends_on: [B-0006, B-0153]per the forward-compat schema landed in the 2026-05-01 backlog-hygiene extension.Test plan
🤖 Generated with Claude Code