Skip to content

docs: move conditional AGENTS.md contracts into triggered skills - #8

Merged
sctru merged 2 commits into
mainfrom
fm/agents-md-skill-extraction
Sep 26, 2026
Merged

sctru merged 2 commits into
mainfrom
fm/agents-md-skill-extraction

Conversation

@sctru

@sctru sctru commented Sep 26, 2026

Copy link
Copy Markdown
Owner

Slims AGENTS.md (-583 lines) to the always-needed supervisor contract and moves situational procedures into triggered agent skills, following the inline-stub pattern in firstmate-coding-guidelines.

New skills, each with its load trigger left inline in AGENTS.md:

  • session-start, task-lifecycle, fleet-supervision, landing-lifecycle, validation-lifecycle, crewmate-briefs, captain-communication, operational-home-reference

Existing skills absorb the related extracted detail (harness-adapters, backlog-operations, afk, fmx-respond, and others).

Also fixes three skill-relative doc links that bin/fm-doc-audience-check.sh flagged.

Validation:

  • bin/fm-doc-audience-check.sh: ok surfaces=104 local_links=427
  • These changes have been running live in the primary firstmate home since 2026-09-25 (session start, task intake, dispatch, landing, and supervision exercised end to end).
  • Full test suite left to CI.

🤖 Generated with Claude Code

Slim AGENTS.md to the always-needed contract and move situational
procedures into eight new agent skills (session-start, task-lifecycle,
fleet-supervision, landing-lifecycle, validation-lifecycle,
crewmate-briefs, captain-communication, operational-home-reference),
with inline load triggers left in AGENTS.md. Existing skills absorb
the related detail. Fix skill-relative doc links.
@sctru
sctru merged commit ad4322f into main Sep 26, 2026
18 checks passed
@sctru
sctru deleted the fm/agents-md-skill-extraction branch September 26, 2026 01:27
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