docs(agents): trim section 7 spawn duplication to its owners - #358
Closed
zachlandes wants to merge 1 commit into
Closed
zachlandes wants to merge 1 commit into
zachlandes wants to merge 1 commit into
Conversation
Consolidates section 7's Spawn subsection restatement of already-owned mechanics to a single owner each, per the one-owner rule. * Runtime backend resolution, auto-detection nesting, and per-backend refusals were restated verbatim from docs/configuration.md "Runtime backend"; replaced with a pointer. Firstmate never computes backend resolution at spawn - the script does - and the actionable refusal-is-a-blocker rule already sits on the next line, so nothing actionable was lost. * Per-backend workspace scoping (herdr per-home, zellij shared session) was likewise owned by that doc; replaced with a pointer. * The meta-field enumeration (harness=/model=/effort=/kind=/mode=/yolo=, home=/projects=, non-default backend=) duplicated section 2's canonical <id>.meta line; replaced with a section 2 pointer. * The grok per-task turn-end hook mechanics duplicated docs/configuration.md and section 2; removed. harness-adapters already delegates per-task turn-end hook mechanics to bin/fm-spawn.sh, and the hook is installed by spawn and removed by teardown with no firstmate action in between. * Dropped the redundant codex-app-is-unknown line (already stated in the command block, section 2, and the runtime-backend pointer). Always-loaded AGENTS.md drops from 26,759 to 26,397 tokens (o200k_base), -362 (-1.35%). Every removed token was confirmed to survive in its owner.
Contributor
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Trim section 7 Spawn duplication to its owners
Continues the AGENTS.md diet (after #253/#255/#258) with one surgical one-owner consolidation, in the same style as those PRs.
Section 7's Spawn subsection had grown to restate mechanics that already have canonical owners; this replaces each restatement with a pointer, per the one-owner rule in
firstmate-coding-guidelines.Measured size delta
Always-loaded
AGENTS.mdis paid by every session of every fleet member, every turn, whether or not that session hits the situation the lines describe.What changed (all in section 7 Spawn)
codex-appas unknown) were restated nearly verbatim fromdocs/configuration.md"Runtime backend".Replaced with a pointer.
Firstmate never computes backend resolution at spawn - the script does - and the actionable "a backend refusal is a blocker, never silently retry another backend" rule already sits on the very next line, so nothing firstmate acts on was lost.
Replaced with a pointer.
<id>.metafield enumeration (harness=/model=/effort=/kind=/mode=/yolo=, secondmatehome=/projects=, and the non-defaultbackend=note) duplicated section 2's canonical<id>.metaline.Replaced with a section 2 pointer.
docs/configuration.md(the$GROK_HOME/hooks/install plus.fm-grok-turnendpointer, teardown removal) and section 2'sgrok-turnend-tokenline.Removed:
harness-adaptersalready delegates per-task turn-end hook mechanics tobin/fm-spawn.sh, and the hook is installed by spawn and removed by teardown with no firstmate action in between, so there is no wake-time trigger to preserve inline.backend=codex-appis unknown" line already stated in the spawn command block, section 2, and the runtime-backend pointer.Safety
docs/configuration.mdor AGENTS.md section 2).CLAUDE.md->AGENTS.mdand.claude/skills->.agents/skillssymlinks untouched.Scope note
This is deliberately one surgical theme kept independently reviewable, not a whole-file diet.
Judgment-heavy extractions that need a maintainer decision on shape (the section 14 X-mode cadence block, and the section 7
no-mistakes axi statusvalidation state table) were intentionally left out of this PR.