Skip to content

docs: AGENTS.md + CLAUDE.md, greenrun gate in SPLUS.md, skills-first docs refresh#10

Merged
ojowwalker77 merged 1 commit into
mainfrom
docs/agents-greenrun-contract
Jun 5, 2026
Merged

docs: AGENTS.md + CLAUDE.md, greenrun gate in SPLUS.md, skills-first docs refresh#10
ojowwalker77 merged 1 commit into
mainfrom
docs/agents-greenrun-contract

Conversation

@ojowwalker77

@ojowwalker77 ojowwalker77 commented Jun 5, 2026

Copy link
Copy Markdown
Owner

What

  • AGENTS.md — canonical instructions for coding agents working on this repo: layout, build/test commands, the non-negotiable greenrun gate, conventions (Rust ↔ TS model lockstep, lockstep version bumps, bench-only triage, mcp directive ↔ skills mirroring), release flow. CLAUDE.md imports it.
  • SPLUS.md — new binding convention: every change set runs greenrun (full CI locally) before it ships; reviews flag work that skipped it. Also fixes the stale lowercase heading.
  • Docs refresh for skills-first delivery (v0.9.2):
    • ARCHITECTURE.md: drops the stale mcp → triage edge, adds skills/ to diagram + pieces table
    • README: skills installation story, skills/ + AGENTS.md in repo layout, docs links
    • CONTRIBUTING: bench-only triage, pnpm -r test, greenrun in the develop loop, release packaging notes
    • TOOLS.md: documents the CHANGED SYMBOLS block + contract-trace stage

Verification

  • greenrun (full CI locally): PASS in 1m23s

View with Codesmith Autofix with Codesmith
Need help on this PR? Tag /codesmith with what you need. Autofix is disabled.

…docs refresh

- AGENTS.md: canonical agent instructions (layout, build/test, the
  non-negotiable greenrun verification gate, lockstep conventions,
  bench-only triage rule, mcp directive ↔ skills mirroring, release flow);
  CLAUDE.md imports it
- SPLUS.md: every change set must pass greenrun before it ships; reviews
  flag work that skipped it (also fix stale lowercase heading)
- ARCHITECTURE.md: drop the stale mcp → triage edge (bench-only since
  0.9.2), add skills/ to the diagram and pieces table
- README: skills section reflects per-agent installation, repo layout
  gains skills/ + AGENTS.md, docs list links AGENTS.md
- CONTRIBUTING: bench-only triage description, skills/ in layout,
  pnpm -r test, greenrun in the develop loop, release notes mention
  skills packaging + lockstep version bumps
- TOOLS.md: document the CHANGED SYMBOLS block + contract-trace stage
@ojowwalker77 ojowwalker77 merged commit 6fc8625 into main Jun 5, 2026
@ojowwalker77 ojowwalker77 deleted the docs/agents-greenrun-contract branch June 5, 2026 20:21
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