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

This PR documents the repo’s current nix/spago-based workflow for AI coding agents and removes legacy JavaScript-era tooling files that are no longer used by this fork.

Changes:

  • Add AGENTS.md with build/test/lint guidance plus Lua 5.1 + FFI constraints for contributors and agents.
  • Add CLAUDE.md as an import shim to reuse AGENTS.md for Claude Code.
  • Remove legacy JS toolchain artifacts: package.json, bower.json, and .eslintrc.json.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
AGENTS.md Adds standardized agent/contributor commands and Lua 5.1/FFI/toolchain guidance
CLAUDE.md Points Claude Code at AGENTS.md to avoid duplicated instructions
package.json Removed legacy npm-based PureScript build scripts/deps
bower.json Removed legacy Bower-era package metadata/deps
.eslintrc.json Removed legacy ESLint configuration tied to the old JS workflow

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

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md
@Unisay Unisay force-pushed the chore/agents-md-and-canon-ci branch 3 times, most recently from 20b430a to 5bb7cd3 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 5bb7cd3 to c001df7 Compare June 14, 2026 17:18
@Unisay Unisay merged commit 3cbbcf4 into master Jun 14, 2026
1 check passed
@Unisay Unisay deleted the chore/agents-md-and-canon-ci branch June 14, 2026 17:42
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