Imported from yoshitsugu/goby (
AGENTS.md). Install upstream withnpx skills add yoshitsugu/goby. Copyright stays with the author.
Goby Agent Guidance (Global)
This is the minimum durable guidance for all agents in this repository.
Keep this file product-focused. Developer/process preferences should live in each
developer's $HOME/.codex setup, not in this repository.
Summary
- Goby is an early-stage statically typed functional language with effects.
- Breaking changes are acceptable when they improve clarity and consistency.
- Readability, explicit boundaries, and practical tooling are top priorities.
Always-Global Invariants
- Treat
doc/LANGUAGE_SPEC.mdas the source of truth for current language behavior. - Treat
doc/PLAN.mdas roadmap/decision context. - If syntax/semantics/core terminology changes, update in the same change:
doc/LANGUAGE_SPEC.mddoc/PLAN.md- relevant
examples/*.gb
- Keep
README.mdhigh-level; do not move detailed spec text there. - Prefer root-cause fixes at the correct ownership boundary over one-off patches.
- Preserve behavior/diagnostics unless behavior change is explicitly intended.
Minimal Quality Gate
- Required for meaningful code changes:
cargo fmtcargo checkcargo test
- Prefer focused tests during iteration, then run the broader gate before handoff.
Context Expansion Order
REPO_MANIFEST.md(repo map)- Relevant source files for the task
- Source files
- Broader docs only if still blocked
For changed-files-first workflows, use your local $HOME/.codex tooling.
Restart Safety
- Keep
doc/STATE.mdconcise and execution-oriented. - At milestones, record locked decisions, open questions, and immediate next steps.
