Skip to content

fix: delete the stale RSR outline, correct .clinerules, make the AI manifest pointer-only - #120

Merged
hyperpolymath merged 2 commits into
mainfrom
fix/stale-docs-2026-11-14
Nov 14, 2026
Merged

hyperpolymath merged 2 commits into
mainfrom
fix/stale-docs-2026-11-14

Conversation

@hyperpolymath

@hyperpolymath hyperpolymath commented Nov 14, 2026 •

Copy link
Copy Markdown
Owner

Summary

This closes three departures that #118 reported and left open. Cut from main da23811.

Changes

  • docs/RSR_OUTLINE.adoc is deleted. This is an owner ruling, given by selector to the A1 session on 2026-11-14: the file is a stale copy of the rsr-template-repo README, and nothing reads it. Its Palimpsest badges go with it. A grep for RSR_OUTLINE (and rsr-outline, RSR Outline) finds no link to repoint.
  • The agent rule files (.machine_readable/ai/.clinerules, .cursorrules, .windsurfrules, .github/copilot-instructions.md):
    • The banned-language lines follow the current policy:
      • TypeScript and ReScript → AffineScript;
      • Node.js and yarn → Bun (order Bun > Deno > pnpm > npm, npm only as the last resort);
      • Go → Rust;
      • Python → AffineScript, Rust or Julia, with no exceptions.
    • All four had said TypeScript → ReScript, Node/npm/bun → Deno, and Python → Julia or Rust.
    • Each now points at docs/practice/AI-CONVENTIONS.adoc, which exists; docs/AI-CONVENTIONS.md does not. PLACEHOLDERS.adoc names the .adoc path too.
  • 0-AI-MANIFEST.deed is pointer-only (A7 ruling Q15).
    • Removed :canonical-name, :repo-uuid and :beholding-chora. What is left is :schema-version and (front-doors …).
    • chora-registry_chora.deed carries the same :repo-uuid (a65b74d8-351a-89d9-a38d-aea470863b03) and :beholding-chora (0889b37b-…00e). No id and no domain changes.
    • The header comment now names the repo as the chora-registry (formerly gv-clade-index).
    • Nothing reads identity from the manifest. I grepped the Justfile (validate-rsr), contractile.just, worker/src/, scripts/, sync/, .github/hooks/, governance.yml, dogfood-gate.yml, and the standards scripts that governance.yml calls. validate-a2ml.sh takes identity from the (repo-deed head.

dogfood-gate.yml, governance.yml and the PR template are untouched, because #119 owns them.

Testing

  • scripts/check-registry.sh: PASS, at both commits.
  • tests/check-registry-test.sh: PASS, 19 planted failures fire.
  • deed_lint.js 0-AI-MANIFEST.deed chora-registry_chora.deed: OK, OK.
  • .github/hooks/validate-a2ml.sh: passed, both before (da23811) and after.
  • just validate-rsr: fails the same way before and after. The files it lists as missing are already absent on main, and this PR doesn't touch them.
  • just fmt-check, just lint and just validate-state: clean.

Not done here

Licence

No licence or SPDX edits. The PMPL add-license recipe in setup-repo.k9.ncl is left alone and flagged only. The Palimpsest badges went only because the owner ruled the whole file deleted.

🤖 Generated with Claude Code

https://claude.ai/code/session_0136P7ZoBy5xGnGDLk7wQ8jC

…ifest pointer-only

- docs/RSR_OUTLINE.adoc is deleted (owner ruling, 2026-11-14): a stale
  copy of the rsr-template-repo README with no readers. Its Palimpsest
  badges go with it. Nothing links to it.
- .machine_readable/ai/.clinerules: the banned-language lines follow the
  current policy (TypeScript and ReScript -> AffineScript; Node.js and
  yarn -> Bun, order Bun > Deno > pnpm > npm; Python, no exceptions), and
  line 3 points at docs/practice/AI-CONVENTIONS.adoc, which exists.
- 0-AI-MANIFEST.deed is pointer-only (A7 ruling Q15): :canonical-name,
  :repo-uuid and :beholding-chora are removed. chora-registry_chora.deed
  carries the same :repo-uuid and :beholding-chora; no id or domain
  changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0136P7ZoBy5xGnGDLk7wQ8jC
@coderabbitai

coderabbitai Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 50 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

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: 1fa358c1-28f6-4afa-b135-f14107ec3074
Commits

Reviewing files that changed from the base of the PR and between da23811 and 2e2fb9a.

Files selected for processing: 7

  • .github/copilot-instructions.md
  • .machine_readable/ai/.clinerules
  • .machine_readable/ai/.cursorrules
  • .machine_readable/ai/.windsurfrules
  • .machine_readable/ai/PLACEHOLDERS.adoc
  • 0-AI-MANIFEST.deed
  • docs/RSR_OUTLINE.adoc
  • 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

…d point at AI-CONVENTIONS.adoc

.cursorrules, .windsurfrules and .github/copilot-instructions.md carried
the same stale rules as .clinerules (TypeScript -> ReScript, Node/npm/bun
-> Deno, Python -> Julia or Rust) and pointed at docs/AI-CONVENTIONS.md,
which does not exist. They now match .clinerules: TypeScript and ReScript
-> AffineScript; Node.js and yarn -> Bun (Bun > Deno > pnpm > npm); Python
-> AffineScript, Rust or Julia. PLACEHOLDERS.adoc names the .adoc path too.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0136P7ZoBy5xGnGDLk7wQ8jC
@sonarqubecloud

Copy link
Copy Markdown

@hyperpolymath
hyperpolymath marked this pull request as ready for review November 14, 2026 23:05
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-14T23:08:18.470307Z 2e2fb9a Draft marked ready
🔒 Security Review ✅ Completed 2026-11-14T23:08:18.201908Z 2e2fb9a Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@hyperpolymath
hyperpolymath enabled auto-merge (squash) November 14, 2026 23:05
@hyperpolymath
hyperpolymath merged commit 3c40048 into main Nov 14, 2026
19 checks passed
@hyperpolymath
hyperpolymath deleted the fix/stale-docs-2026-11-14 branch November 14, 2026 23:07

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2e2fb9a708

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +36 to +39
- No TypeScript or ReScript (use AffineScript)
- No Node.js or yarn (use Bun; runtime order Bun > Deno > pnpm > npm, npm only as the last resort)
- No Go (use Rust)
- No Python (use Julia or Rust)
- No Python (use AffineScript, Rust or Julia; no exceptions)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Synchronize the authoritative language policy

When an agent follows the newly corrected pointer on line 3, docs/practice/AI-CONVENTIONS.adoc lines 50–55 still directs TypeScript users to ReScript, bans Bun in favor of Deno, and offers only Julia/Rust for Python, contradicting these new rules. Because that document labels itself authoritative and says the per-tool configurations reference it, agents can receive mutually exclusive instructions or select a now-banned toolchain; update the authoritative table in the same change.

Useful? React with 👍 / 👎.

hyperpolymath added a commit that referenced this pull request Nov 15, 2026
## Summary

This PR closes the CodeRabbit finding on #119.
`docs/practice/AI-CONVENTIONS.adoc` still had TypeScript → ReScript and
Node/npm/bun → Deno, which contradicted the PR template fixed in #119.
RSR_OUTLINE, the other source CodeRabbit named, was deleted in #120.

## Changes

The language table in `docs/practice/AI-CONVENTIONS.adoc` now reads:

- TypeScript and ReScript → AffineScript.
- Node.js → Bun. The runtime order is Bun > Deno > pnpm > npm, and Bun
is not banned.
- Python → AffineScript, Rust or Julia.

## Testing

This is a docs-only change, so there are no code tests.

This PR is a draft for the owner.

---
_Generated by [Claude
Code](https://claude.ai/code/session_0136P7ZoUeC49fDEvSwDNvuS)_

Co-authored-by: Claude <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.

3 participants