* feat: llms.txt + llms-full.txt + AGENTS.md (v0.15.0)
Ship three new public artifacts at the repo root so agents that aren't
Claude Code can discover GBrain documentation cleanly:
- AGENTS.md — ~45-line install + operating protocol for non-Claude agents
(Codex, Cursor, OpenClaw, Aider). Covers install, read order, trust
boundary, config/debug/migration pointers, fork regeneration. Uses
relative links so it survives fork/rename.
- llms.txt — llmstxt.org-spec index (H1 + blockquote + Core entry points /
Configuration / Debugging / Migrations / Philosophy / Optional H2s).
- llms-full.txt — same index with core docs inlined for single-fetch
ingestion. ~225KB, well under the 600KB FULL_SIZE_BUDGET.
Generator-driven via scripts/build-llms.ts + scripts/llms-config.ts.
LLMS_REPO_BASE env var makes it fork-friendly. bun run build:llms
regenerates both outputs deterministically.
test/build-llms.test.ts has 7 cases: paths resolve on disk, generator
idempotent, llms.txt spec shape, checked-in files match generator output
(drift guard), content contract (RESOLVER / AGENTS / INSTALL referenced),
AGENTS mirrors README + INSTALL_FOR_AGENTS install path, llms-full.txt
under size budget.
Leverage point per Codex review: README.md + INSTALL_FOR_AGENTS.md
install prompts now tell agents to fetch AGENTS.md first. Without this,
the new files were invisible.
Drive-by fix: INSTALL_FOR_AGENTS.md:136 had `git pull origin main` while
the repo's default branch is master (origin/HEAD -> master). Corrected.
Plan + reviews: /plan-eng-review CLEARED, /codex adversarial review
found 15 issues — 7 folded in directly, 3 user tension decisions, 5
stayed as NOT-in-scope with reasoning.
Version bumps to 0.15.0 (new public-artifact feature surface per Step 12
of /ship feature-signal heuristic).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* chore: normalize VERSION to 3-digit to match master
master uses 3-digit semver (0.14.2); my earlier /ship bumped VERSION to
the 4-digit gstack format (0.15.0.0). Revert to 0.15.0 to match
package.json (already 3-digit) and master's convention.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
