Skip to content

docs(rules): robust and portable — built-in before custom, macOS and Ubuntu - #66

Merged
realRaghavGupta merged 1 commit into
mainfrom
lead/robust-and-portable
Nov 3, 2026
Merged

realRaghavGupta merged 1 commit into
mainfrom
lead/robust-and-portable

Conversation

@realRaghavGupta

Copy link
Copy Markdown
Contributor

Draft for Raghav's review. This changes org policy, so Raghav merges it.

Why

Raghav, 2026-11-03: "if a lot of custom stuff is done, and so many manual scripts etc, it's going to break some time somewhere, which should not be the case. The system has to be robust." Earlier the same day: everything should run on any platform, macOS and Ubuntu above all, since those are the machines being added.

Both rules were only in one session's memory, and nothing checked them, so they kept being broken and had to be repeated. This puts them where every agent reads them at start and every reviewer checks them on every PR.

What changes

  • Org rules (rules/org-rules.md) get one new bullet under Changes, "Robust and portable":
    • Use what the platform already does (the OS scheduler, GitHub, Claude Code) before writing anything.
    • A manual step done twice becomes automation in a repo, never a personal script.
    • New code replaces more than it adds.
    • Code that runs on a machine works on macOS and Ubuntu. A call only one OS has needs the other's branch.
    • To stay within the 64-line limit, the last Changes bullet ("Done means the repo's checks pass…") is joined onto one line. Its words are unchanged.
  • Reviewer agent (plugins/setkernel/agents/reviewer.md) gets a new blocker covering two cases:
    • a manual step, personal script or hand-made component where a built-in or existing one does the job, or one that nothing runs and checks unattended;
    • code that runs on a machine but works only on Linux or only on macOS.
  • managed/settings.json is regenerated by bin/generate. Only claudeMd changes.

Checks

  • bash tests/run.sh: 796/796 passed. The org rules stay at 64 lines.

After merge

Raghav pastes managed/settings.json into the org's managed settings. Seats pick up the reviewer change through plugin auto-update.

🤖 Generated with Claude Code

… scripts, macOS and Ubuntu

Raghav 2026-11-03. Also a reviewer blocker, so every PR is checked.

— Claude Lead

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@realRaghavGupta
realRaghavGupta merged commit eda4b31 into main Nov 3, 2026
1 check passed
@realRaghavGupta
realRaghavGupta deleted the lead/robust-and-portable branch November 3, 2026 15:08
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