Skip to content

docs(arrival-pack): sync doctrine rules 14 to 16 with the template - #84

Merged
hyperpolymath merged 1 commit into
mainfrom
chore/arrival-pack-doctrine-16
Nov 12, 2026
Merged

hyperpolymath merged 1 commit into
mainfrom
chore/arrival-pack-doctrine-16

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Summary

Brings this repo's arrival pack up to the template: adds doctrine rules 14 to 16. Rule 16 is "Cheap models for upkeep". The rule is PROVISIONAL in canon (metadatastician/standards#1457). It is projected before ratification, the same known tension as rule 15.

Changes

RSR Quality Checklist

Required

  • Tests pass: not run. This is a docs and generated-file change with no code.
  • Code is formatted: not applicable, no source code changed.
  • Linter is clean: not run, no source code changed.
  • No banned language patterns
  • No unsafe blocks, banned functions or secrets added
  • SPDX headers: not applicable, no new source files.

As Applicable

  • Deed, roadmap, topology, changelog and dependency items: not applicable, project state and architecture did not change.

Testing

Commands run:

  • just claude-md
  • just validate-claude-md (passes)

Part of the estate rollout of doctrine line 16. The owner merges. It was not merged by the bot.

Screenshots

Not applicable. The change is a one-line text addition.


Generated by Claude Code

Take rules 14 to 16 from rsr-template-repo (#324), then regenerate CLAUDE.md
with just claude-md. just validate-claude-md passes.

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

coderabbitai Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

Explain Change →

No actionable comments were generated in the recent review.

Summary

Summary by CodeRabbit

  • Documentation
    • Updated guidance to favour addressing issues at their source and choosing elegant, long-term solutions. When a different option is selected, the reasoning should be explained, including for decisions not explicitly requested.
    • Clarified that top-tier models are for proof work and complex design. If substantial effort is needed for upkeep work on a lower-cost model, work should stop and a discussion should be opened.

Three doctrine rules were added to the generated arrival-pack doctrine and to CLAUDE.md. They cover fixing issues at their source, selecting and explaining design choices, and using lower-cost models for upkeep work.

Changes: Doctrine rule updates

Layer / File(s) Summary
Add doctrine rules
.machine_readable/arrival-pack/arrival-pack.ncl, CLAUDE.md
Both doctrine lists add rules on addressing issues at their source, choosing the most elegant and correct long-term option and reporting departures from it, and using cheaper models for upkeep work. They also instruct stopping and opening a discussion if upkeep work requires substantial effort.

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

Change: Other

Merge Risk: Minimal · up to 56d4e

This is a documentation-only sync of doctrine rules 14 to 16. It has no runtime impact and is ready to merge.

Pre-merge checks: Passed 4

Check name Status Explanation
Title check Passed The title names the docs change to the arrival-pack doctrine rules 14 to 16 and their sync with the template. The changeset adds those three rules to the arrival-pack .ncl file and regenerates CLAUDE.…
Description check Passed The description follows the repository template. It has a Summary that explains what the PR does and why, and a Changes list that names both modified files. It includes the RSR Quality Checklist with …
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Title check

Explanation

The title names the docs change to the arrival-pack doctrine rules 14 to 16 and their sync with the template. The changeset adds those three rules to the arrival-pack .ncl file and regenerates CLAUDE.md, so the title matches the main change. It is specific and short, and it uses the conventional commit format.

Full details: Description check

Explanation

The description follows the repository template. It has a Summary that explains what the PR does and why, and a Changes list that names both modified files. It includes the RSR Quality Checklist with each item marked or explained as not applicable, and a Testing section that lists the commands run. The Screenshots section states that the change is not applicable. The template's HTML comments and SPDX header are not reproduced, which is acceptable for a PR body. Some Required checklist items are unchecked (tests, linter, formatting), but the author gives a reason for each, so the description remains mostly complete. It does not include a 'Closes #N' link, but no related issue is required here. The description also notes that the rule 16 is provisional, which gives useful context.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Recent review info

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 5e22d9dd-8300-4f01-8bf2-2f45e68628e8
Commits

Reviewing files that changed from the base of the PR and between 2aa57e6 and 56d4edc.

Files selected for processing: 2

  • .machine_readable/arrival-pack/arrival-pack.ncl
  • CLAUDE.md

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Recent review details

Context from checks skipped due to timeout: 3

  • GitHub Check: rust-ci / Cargo test
  • GitHub Check: CodeRabbit
  • GitHub Check: semgrep-cloud-platform/scan
Additional context used

Code guidelines: 1

CLAUDE.md — auto-discovered
Path-based instructions: 1

CLAUDE.md: 1

29-31: LGTM!

@sonarqubecloud

Copy link
Copy Markdown

@linear-code
linear-code Bot marked this pull request as ready for review November 12, 2026 01:51
@hyperpolymath
hyperpolymath merged commit b30ff57 into main Nov 12, 2026
58 checks passed
@hyperpolymath
hyperpolymath deleted the chore/arrival-pack-doctrine-16 branch November 12, 2026 01:54
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.

3 participants