Skip to content

chore: add AGENTS.md, drop dead JavaScript-era files#4

Merged
Unisay merged 1 commit into
masterfrom
chore/agents-md-and-canon-ci
Jun 14, 2026
Merged

chore: add AGENTS.md, drop dead JavaScript-era files#4
Unisay merged 1 commit into
masterfrom
chore/agents-md-and-canon-ci

Conversation

@Unisay

@Unisay Unisay commented Jun 14, 2026

Copy link
Copy Markdown
Collaborator

This fork's CI is already on the shared canon, so this is docs and cleanup only: it adds the AI-agent instructions and clears out the dead JavaScript-era files.

AGENTS.md + CLAUDE.md:

  • AGENTS.md is the one instruction file the coding agents read natively (Codex, Cursor, Copilot, Gemini CLI, Aider): the build/test/lint commands, the Lua 5.1 constraints, the FFI parenthesisation rule, and the toolchain pins.
  • CLAUDE.md is a one-line @AGENTS.md import so Claude Code reads the same file instead of a second copy that drifts out of sync.

It drops .eslintrc.json, bower.json, package.json left over from the JavaScript build; the toolchain is spago plus nix now.

No src/ change, so there is no tag or package-set bump.

Verification

nix develop -c ./scripts/build and luacheck are clean locally.

Copilot AI 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.

Pull request overview

Adds unified AI-agent/contributor instructions for this PureScript→Lua (Lua 5.1) fork and removes legacy JavaScript-era tooling files that are no longer used in the nix+spago toolchain.

Changes:

  • Add AGENTS.md (agent instructions: build/lint/toolchain pins/Lua 5.1 constraints) and CLAUDE.md (import shim).
  • Remove obsolete JS toolchain files (package.json, bower.json, .eslintrc.json).
  • No src/ changes; build remains nix develop -c ./scripts/build.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
AGENTS.md Adds agent instructions (commands, Lua 5.1 constraints, FFI/parser notes, toolchain pins, release notes).
CLAUDE.md Imports AGENTS.md so Claude Code reads the shared instructions.
package.json Removed unused legacy JS/pulp/eslint scripts and devDependencies.
bower.json Removed unused legacy bower metadata/deps from the pre-spago era.
.eslintrc.json Removed unused ESLint configuration from the pre-nix/spago era.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread AGENTS.md Outdated
@Unisay Unisay force-pushed the chore/agents-md-and-canon-ci branch 3 times, most recently from c74d2a9 to 3a69b67 Compare June 14, 2026 17:11
@Unisay Unisay marked this pull request as ready for review June 14, 2026 17:12
AGENTS.md is the single instruction file the coding agents read natively;
CLAUDE.md is a one-line @AGENTS.md import so Claude Code shares it. Also
removes dead bower.json/package.json/.eslintrc.json. CI is already on the
shared canon; no src/ change.
@Unisay Unisay force-pushed the chore/agents-md-and-canon-ci branch from 3a69b67 to 3ec1995 Compare June 14, 2026 17:18
@Unisay Unisay merged commit c75b6fb into master Jun 14, 2026
1 check passed
@Unisay Unisay deleted the chore/agents-md-and-canon-ci branch June 14, 2026 17:43
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.

2 participants