docs: standardize crewmate terminology - #58
Merged
Conversation
…to fm/crew-vocab-consolidate-v2
…crewmate vocabulary
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.
Intent
Consolidate all prose vocabulary for worker agents on
crewmateandcrewmatesacross shared tracked material, eliminating the former distinction wherecrewmeant the collective.Preserve every compatibility identifier containing
crewexactly, including config paths, script and skill names, CLI modes, account-pool names, shell functions and variables, metadata keys, status strings, and fixtures.The resulting diff must be prose/comment-only with zero behavioral changes,
AGENTS.mdmust state the single-word rule, and every remainingcreworcrewsoccurrence must be attributable to a compatibility identifier.What Changed
crewmateandcrewmatesacross shared documentation, skills, script comments, and unasserted test comments.crewunchanged.Audit note
This ambiguity is a real instruction-surface defect, not an implementation error.
Tonight's audit found that the crewmate-vocabulary rule did not distinguish ordinary prose from asserted compatibility strings, which is why a careful crewmate had to stop and ask twice.
The clarified split is semantic: prose comments about direct reports use
crewmate; asserted or matched strings and identifiers remain compatibility surface.Risk Assessment
Low: the complete branch diff is documentation/comment-only, and no runtime line, asserted string, metadata key, status text, fixture, or identifier changes.
Validation
bash -npassed forbin/*.shandbin/backends/*.sh.bin/fm-lint.shpassed.tests/fm-account-directory.test.shpassed.tests/fm-bootstrap.test.shpassed.fm-account-routing.test.shreproduced its pre-existing session-sync race only after all preceding cases passed, whilefm-crew-state.test.shpassed.Pipeline
Updates from git push no-mistakes