Skip to content

docs(claude-md): note ReScript→AffineScript migration trajectory#60

Closed
hyperpolymath wants to merge 1 commit into
mainfrom
docs/claude-md-rescript-migration-note
Closed

docs(claude-md): note ReScript→AffineScript migration trajectory#60
hyperpolymath wants to merge 1 commit into
mainfrom
docs/claude-md-rescript-migration-note

Conversation

@hyperpolymath
Copy link
Copy Markdown
Owner

Summary

panll/.claude/CLAUDE.md previously said "NEVER use TypeScript — ReScript only" with no acknowledgement of the 2026-05-25 estate language policy. panll is ReScript-heavy (TEA in .res, ~7500-line Update.res), so this PR does not wholesale flip — it adds a migration-trajectory note so future Claude sessions know:

Existing ReScript Conventions section preserved unchanged (still authoritative for edits to the existing .res surface) but section header marked (legacy).

Changes

  • Architecture line: TEA in ReScriptTEA in ReScript (migrating to AffineScript per standards#252)
  • Critical Rules: TS rule augmented with "new modules MUST be AffineScript"; npm/bun rule notes legacy-rescript invocation
  • ReScript Conventions section header marked legacy + lead paragraph explaining trajectory

Why not a wholesale flip?

Per hyperpolymath/standards#281 discussion and the other repos in this sweep (phronesis / dotfiles / developer-ecosystem flipped tables wholesale), panll's reality requires a softer touch — the docs must reflect what code-in-the-repo actually is while pointing at the target. Honest documentation > aspirational.

Test plan

  • No code changes — docs-only PR
  • GPG-signed
  • Existing ReScript build/dev commands preserved (still accurate)

Refs: hyperpolymath/standards#239
Refs: hyperpolymath/standards#252
Refs: hyperpolymath/standards#281

…s #standards/239 + #standards/252)

panll is ReScript-heavy (TEA in .res, ~7500-line Update.res); the
existing rules said "ReScript only" with no acknowledgement of the
2026-05-25 estate language policy. Soften with explicit migration
note so future Claude sessions:
  - know AffineScript is the target for new modules
  - don't add new .res/.resi outside the existing surface
  - know the npm:rescript invocation is legacy (Deno-native command at standards#253)

Existing ReScript Conventions section preserved (still authoritative
for edits to the existing .res surface) but marked "(legacy)".

Refs: hyperpolymath/standards#239
Refs: hyperpolymath/standards#252
Refs: hyperpolymath/standards#281

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@hyperpolymath hyperpolymath enabled auto-merge (squash) May 30, 2026 13:24
@sonarqubecloud
Copy link
Copy Markdown

@hyperpolymath
Copy link
Copy Markdown
Owner Author

Closing per local revert of working-tree changes — the migration-note approach isn't wanted for panll. Leaving the file as-is. (Other repos in this sweep — phronesis #33, dotfiles #20, developer-ecosystem in flight — used wholesale flip instead, but panll's ReScript-heavy reality made that wrong here too. Will skip panll from any future CLAUDE.md sweeps.)

auto-merge was automatically disabled May 30, 2026 13:25

Pull request was closed

@hyperpolymath hyperpolymath deleted the docs/claude-md-rescript-migration-note branch May 30, 2026 13:25
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