Skip to content

docs(project): create AGENTS.md for agent-oriented development#38

Merged
wax911 merged 1 commit into
mainfrom
docs/create-agents-md
Jul 5, 2026
Merged

docs(project): create AGENTS.md for agent-oriented development#38
wax911 merged 1 commit into
mainfrom
docs/create-agents-md

Conversation

@wax911

@wax911 wax911 commented Jul 5, 2026

Copy link
Copy Markdown
Member

Summary

Creates AGENTS.md to serve as a compact instruction file for future OpenCode sessions and other AI coding tools working in this repository.

What's included

  • Runtime: Deno 2.x, JSR-only (no Node.js/npm) -- the most critical guardrail
  • Dev commands: Full table of deno task commands with CI-mandated ordering
  • Formatting/linting: 100-char line width, double quotes, no-unused-vars excluded
  • Source layout: Module-level structure with the ~1600-line monolithic CLI note
  • Config resolution: 5-layer merge order with merge semantics
  • Exit codes: 0-4 with meanings
  • Testing conventions: FakeProcessRunner usage, co-located tests, 80% coverage minimum
  • Build/release: Cross-compile targets, version bump dual-update requirement
  • Branch/commit/PR conventions: Quick reference linking to CONTRIBUTING.md
  • Documentation requirement: AGENTS.md and docs/ must stay updated with code changes

Every line answers: 'Would an agent likely miss this without help?'

@wax911 wax911 merged commit 1a67030 into main Jul 5, 2026
3 of 4 checks passed
@wax911 wax911 deleted the docs/create-agents-md branch July 5, 2026 14:23
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