Skip to content

docs: AI-CONVENTIONS language table follows the estate policy - #121

Merged
hyperpolymath merged 1 commit into
mainfrom
a1/ai-conventions-language-table
Nov 15, 2026
Merged

hyperpolymath merged 1 commit into
mainfrom
a1/ai-conventions-language-table

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

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

TypeScript and ReScript migrate to AffineScript; Bun is the tier-1 runtime
(Bun > Deno > pnpm > npm), not banned; Python moves to AffineScript, Rust
or Julia. The table still said ReScript and Deno, which contradicted the PR
template fixed in #119 (CodeRabbit review of #119).

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

coderabbitai Bot commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Explain Change →

No actionable comments were generated in the recent review.

Summary

Summary by CodeRabbit

  • Documentation
    • Updated the language recommendations: TypeScript and ReScript now point to AffineScript; Python now lists AffineScript, Rust, or Julia.
    • Updated the Node.js runtime preference order to Bun, Deno, pnpm, then npm.
    • The Go recommendation remains Rust.

The Banned Languages table updates recommendations for TypeScript, ReScript, Node.js, and Python. It adds a preference order for Node.js runtimes. The Go recommendation remains unchanged.

Changes: Language recommendations

Layer / File(s) Summary
Update language recommendations
docs/practice/AI-CONVENTIONS.adoc
The table recommends AffineScript for TypeScript and ReScript, Bun for Node.js, and adds AffineScript to the Python alternatives. It sets the Node.js runtime order to Bun > Deno > pnpm > npm. The Go-to-Rust recommendation is unchanged.

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

Change: Other

Merge Risk: Minimal · up to d3ce3

This documentation-only change updates language and runtime recommendations and carries no runtime risk.

Pre-merge checks: Passed 4

Check name Status Explanation
Title check Passed The title names the AI-CONVENTIONS language table and the estate policy. The change updates that table: TypeScript and ReScript move to AffineScript, Node.js moves to Bun, and Python moves to AffineSc…
Description check Passed The description follows the repository template in substance. It has a Summary that explains what changed and why, linking the change to the CodeRabbit finding on #119 and the deletion of RSR_OUTLINE …
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 AI-CONVENTIONS language table and the estate policy. The change updates that table: TypeScript and ReScript move to AffineScript, Node.js moves to Bun, and Python moves to AffineScript, Rust or Julia. The title is specific and matches the main change. It is slightly indirect because it does not name the concrete replacements, but this is acceptable.

Full details: Description check

Explanation

The description follows the repository template in substance. It has a Summary that explains what changed and why, linking the change to the CodeRabbit finding on #119 and the deletion of RSR_OUTLINE in #120. It has a Changes section that lists the table updates. It has a Testing section that states the change is docs-only with no code tests. It does not include the RSR Quality Checklist, Screenshots section, or the As Applicable checklist, and it does not tick any required boxes. Those omissions are acceptable for a docs-only draft, but the checklist is absent entirely.

  • 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: f0239ce1-fdc7-4460-a065-843c41e8d032
Commits

Reviewing files that changed from the base of the PR and between 32c487d and d3ce3c2.

Files selected for processing: 1

  • docs/practice/AI-CONVENTIONS.adoc

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: 2

  • GitHub Check: CodeRabbit
  • GitHub Check: semgrep-cloud-platform/scan
Additional context used

Code guidelines: 1

.github/copilot-instructions.md — auto-discovered
Path-based instructions: 1

Source excerpt: Annotate and document all files.

CodeRabbit inference engine (.github/copilot-instructions.md)

Files:

  • docs/practice/AI-CONVENTIONS.adoc
Learnings: 1

Common learnings

Learnt from: CR
Repo: hyperpolymath/chora-registry

Timestamp: 2026-11-14T23:57:45.688Z
Learning: Source excerpt:
# Copilot Instructions

## Banned Languages

- No TypeScript or ReScript (use AffineScript)
Learnt from: CR
Repo: hyperpolymath/chora-registry

Timestamp: 2026-11-14T23:57:45.688Z
Learning: Source excerpt:
# Copilot Instructions

## Banned Languages

- No Python (use AffineScript, Rust or Julia; no exceptions)
Learnt from: CR
Repo: hyperpolymath/chora-registry

Timestamp: 2026-11-14T23:57:45.688Z
Learning: Source excerpt:
# Copilot Instructions

## Banned Languages

- No Node.js or yarn (use Bun; runtime order Bun > Deno > pnpm > npm, npm only as the last resort)

@sonarqubecloud

Copy link
Copy Markdown

@linear-code
linear-code Bot marked this pull request as ready for review November 14, 2026 23:59
@hyperpolymath
hyperpolymath merged commit 17d9d25 into main Nov 15, 2026
14 checks passed
@hyperpolymath
hyperpolymath deleted the a1/ai-conventions-language-table branch November 15, 2026 00:12
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