Skip to content

docs: update stale .claude/rules/ cross-references to docs/rules/ - #2659

Merged
faktorial-ai[bot] merged 2 commits into
mainfrom
agent-go/task-gh2653
May 30, 2026
Merged

docs: update stale .claude/rules/ cross-references to docs/rules/#2659
faktorial-ai[bot] merged 2 commits into
mainfrom
agent-go/task-gh2653

Conversation

@rogeralsing

Copy link
Copy Markdown
Contributor

Summary

Updates stale .claude/rules/ cross-references to docs/rules/ in two documentation files:

  • docs/rules/recurring-maintenance-child-runs.md (13 references updated)
  • agents/how-to-build-and-test.md (5 references updated)

The .claude/rules/ directory was moved to docs/rules/ in commit 925dded, but these cross-references were not updated at that time.

Verification

  • Baseline signal: 18 stale references
  • Final signal: 0 stale references
  • Scope note: Docs-only change; no code changes

Fixes #2653

rogeralsing and others added 2 commits May 30, 2026 06:55
…recurring-maintenance-child-runs.md

The durable rules were moved from .claude/rules/ to docs/rules/ (commit 925dded),
but recurring-maintenance-child-runs.md still referenced the old paths in 13 places.
Update all cross-references to point to the live docs/rules/ locations.

Baseline signal: rg -c '\.claude/rules/' = 13
Final signal: rg -c '\.claude/rules/' = 0

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
…test.md

The durable preventive rules were moved from .claude/rules/ to docs/rules/ as documented in CLAUDE.md. Update all stale references in the build and test guide to point to the new locations:
- recurring-maintenance-child-runs.md (3 references)
- adr-allocation.md (1 reference)
- agent-context-issues.md (1 reference)

Verify each target exists under docs/rules/ before finalizing.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 30, 2026 04:55

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates stale durable-rule cross-references from the removed .claude/rules/ location to the current docs/rules/ location, aligning documentation with the repository’s rule storage layout.

Changes:

  • Replaces recurring-maintenance policy references with docs/rules/... paths.
  • Updates the build/test agent checklist to point at the current rule documents.
  • Leaves the intentional explanatory .claude/rules/ mention in docs/rules/README.md untouched.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
docs/rules/recurring-maintenance-child-runs.md Updates stale rule-path references in recurring maintenance guidance.
agents/how-to-build-and-test.md Updates operational checklist references to current durable-rule paths.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@faktorial-ai
faktorial-ai Bot merged commit 81f41b0 into main May 30, 2026
1 check passed
@faktorial-ai
faktorial-ai Bot deleted the agent-go/task-gh2653 branch May 30, 2026 04:58
faktorial-ai Bot added a commit that referenced this pull request May 30, 2026
…erged siblings and stale base (#2662)

Issue #2655 / PR #2658 merged with an empty no-op diff: the recurring
maintenance child branched from stale main and redid two already-landed
slices (dreaming.md 4-tier rewrite via #2647; .claude/rules/ -> docs/rules/
path fixes via #2659/#2660). The build-stage baseline (rg -c = 13 -> 0) was
measured on the stale worktree while origin/main already had 0.

Add durable rules to docs/rules/recurring-maintenance-child-runs.md:
- measure the baseline signal against latest origin/main, not the branch base
- the sibling check must include recently-merged sibling PRs, not only active
  sibling-child summaries
- an empty final diff against current main is a collision-abort signal, not a
  successful pass

Co-authored-by: Faktorial Agent <roger@asynkron.se>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
faktorial-ai Bot added a commit that referenced this pull request May 30, 2026
* docs(roadmap): refresh Current State to 2026-05-30 and link next-step issues

Recurring Roadmapper run. Refresh Current State around the typed-AST
evaluator / allocation-reduction theme (PRs #2661, #2646, #2659, #2644,
#2658, #2654, #2650, #2651, #2656; commit bd70ca6) and the dreaming
typed-AST vision docs (#2652, #2655, #2660, #2663). Refine short-term
goals and link the two next-step issues gh2665 (Test262 Language triage)
and gh2668 (allocation-regression CI gate).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs(roadmap): correct Current State PR attributions and architecture wording

Re-derive each Current State bullet from real git history (verified via
git log --grep). Drop fabricated/non-existent PR refs (#2654, #2656, #2652)
and the empty agent commit #2658; re-attribute #2646 (closure-activation
arguments-guard fast path), #2644 (unified-bytecode sync-route coverage doc),
#2647 (dreaming 4-tier model), #2650 (rule 14 tier-numbering), #2651 (ADR 0281
/ rule 20 JsValue migration). Only #2661 and bd70ca6 were already accurate.

Restore multi-tier typed-AST/IR/bytecode architecture framing (UnifiedBytecodeVM
hot route, ExpressionProgram VM, statement-IR runner, AST fallback) instead of
'tree-walking interpreter', per docs/rules/roadmap-architecture-claims.md
rules 4, 7, and 8.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Faktorial Agent <roger@asynkron.se>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
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.

Persistent ADR and Rule Compaction (2026-05-30)

2 participants