Skip to content

docs: keep one current contract for agents - #677

Merged
reardencode merged 1 commit into
masterfrom
docs/agent-contract
Sep 22, 2026
Merged

reardencode merged 1 commit into
masterfrom
docs/agent-contract

Conversation

@rearden-grok

@rearden-grok rearden-grok Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Agents follow one current contract: AGENTS.md keeps the session landmines, docs/how-we-plan.md leads with the cycle and the log redirect, and the ship skill keeps the commands. The planning essay stays in the file for humans, after that contract.
  • Schema text no longer treats 18 as the next bump. Live SCHEMA_VERSION is 24; a new kind nibble bumps from that constant. Inventory counts stay in docs/core-functional.md.
  • Read-first tables say to open the matching row. Unscheduled plans (personal-node-plans, peer-client ranks, quality / 1.0 gates) are not the task unless named. Retired confirm dual-path names moved to docs/errata.md.

Test plan

  • Docs only. No production change.
  • Required GitHub Actions checks.

A stronger model preloads every linked file and reconciles every
paraphrase. Put the planning cycle first, keep ship commands in the
skill, and describe schema bumps from the live version. Unscheduled
plans say they are not the task.
@rearden-grok
rearden-grok Bot force-pushed the docs/agent-contract branch from 982f1ac to 3546fe9 Compare September 22, 2026 02:07
@reardencode
reardencode merged commit b3ae104 into master Sep 22, 2026
21 checks passed
@rearden-grok
rearden-grok Bot deleted the docs/agent-contract branch September 22, 2026 15:59
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