docs(intake): ground initiatives in owning docs, not session anchors - #244
Merged
Conversation
A two-day Azure initiative was worked from a session anchor plus one leaf design doc, so four of the five owning docs were never opened and a documented limitation of one compartment was reported as a system limit. Intake now requires finding the owning doc, treating anchors and evidence folders as state rather than intent, enumerating sibling docs when an initiative spans compartments, and naming the owning docs in the brief.
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.
Why
A two-day "Firstmate on Azure" push was worked from
SESSION-ANCHOR-2026-08-13.mdplus one narrow leaf design doc (docs/azure-worker-runtime.md) as if those were the specification. Four of the five owning docs (azure-pilot,azure-runner,azure-validation,azure-crosscheck,azure-workers, ~140KB total) were never opened. Result: one leaf subsystem got optimized, progress was reported against a far narrower scope than the initiative, and a documented limitation of a single compartment was relayed to the captain as a requirement of the whole system.The generalizable failure is that a session log describes STATE, not INTENT, and it was read as the spec.
What changed
One block added to section 7 Intake, immediately before "Write the brief per section 11":
The Azure family is listed explicitly since that is the family the failure hit, and
azure-worker-runtime.mdis marked as the design leaf underazure-workers.md.The general form of this rule also went into the machine-global agent instructions, so it applies outside this repo too.
Verification
Doc-only change, 6 lines. The behavior tests that read
AGENTS.mdall pass locally:fm-ensure-agents-md,operating-fundamentals,fm-update,lavish-repair,fm-captain-item-check,fm-stow-contract.