Skip to content

Commit 9a47266

Browse files
hyperpolymathclaude
andcommitted
docs(policy): create .claude/CLAUDE.md with TypeScript exemption table
Establishes the .claude/CLAUDE.md scaffold for this repo (previously had no agent-instructions file). The body is intentionally short: points at hyperpolymath/standards as the canonical policy source, restates the key rules (no new TS, Deno not Node, AffineScript for new code), and documents the 6 approved TypeScript exemptions in this repo (MCP cartridge adapters in cartridges/*-mcp/adapter/mod.ts, all gated on AffineScript MCP bindings). Mirror tables exist in affinescript / standards / my-lang. Audit lineage: TS-elimination audit, 2026-05-02. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent d71189c commit 9a47266

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

.claude/CLAUDE.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# CLAUDE.md - AI Assistant Instructions
2+
3+
## Machine-Readable Artefacts
4+
5+
This repo follows the hyperpolymath standard. See `https://github.com/hyperpolymath/standards` for the canonical 6-file `.machine_readable/` layout (STATE/META/ECOSYSTEM/AGENTIC/NEUROSYM/PLAYBOOK in A2ML format).
6+
7+
---
8+
9+
## Language Policy (Hyperpolymath Standard)
10+
11+
The full policy is canonical in `hyperpolymath/standards`. Key points relevant to this repo:
12+
13+
- **No new TypeScript** — convert existing TS to AffineScript (`.affine`) directly; ReScript is no longer the destination as of 2026-04-30.
14+
- **Deno** for the runtime, not Node. `deno.json` for imports, no `node_modules` in production.
15+
- **AffineScript** for new application code. Compiles to typed-wasm.
16+
17+
### TypeScript Exemptions (Approved)
18+
19+
The "no new TypeScript" rule has 6 approved exemptions in this repo — all MCP cartridge adapters. The MCP SDK (`@anthropic/sdk`) is TypeScript-native, and the adapters are JSON-RPC-over-stdio glue. Until AffineScript has bindings to the MCP protocol, these adapters must remain TS.
20+
21+
| Path | Files | Rationale | Unblock condition |
22+
|---|---|---|---|
23+
| `cartridges/{academic-workflow,bofig,ephapax,fireflag,hesiod,sanctify}-mcp/adapter/mod.ts` | 6 | MCP cartridge adapters using `@anthropic/sdk`. The SDK is TS-native; equivalent functionality requires AffineScript bindings to MCP, which don't exist yet. | AffineScript MCP bindings (no scheduled issue — file under `affinescript` when scope is decided). |
24+
25+
Adding to this list requires explicit user approval and an unblock condition. Audit lineage: TS-elimination audit, 2026-05-02. Mirror tables in `affinescript`, `standards`, and `my-lang` repos.
26+
27+
### Documentation Format
28+
29+
- All docs `.adoc` (AsciiDoc) except GitHub-required files (SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, CHANGELOG.md).

0 commit comments

Comments
 (0)