docs(operations): add active work graph + AGENTS.md pointer#626
Merged
Conversation
Introduces `docs/operations/current.md` as the curated active-subgraph view of in-flight, blocked, and next work. Reduces ~77 open issues to ~15 active nodes with editorial overlay (closures, blocked-on-Otto framing, conflicts). Adds an "Operational state" pointer to AGENTS.md so agents and humans open this file at session start. Initial content includes the post-ADR-0021/0022 merge state with a verification pass: #597 and #614 closed, ADR-0022 PR #619 recorded, and the four closure-1 implementation PRs (#621/#623/#624/#625) recorded as in-flight rather than farmable.
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
1 participant
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.
What
Introduces
docs/operations/current.mdas the curated active-subgraph view of in-flight, blocked, and next work, and adds an "Operational state" pointer toAGENTS.mdso agents and humans open this file at session start.The file is a hand-maintained DAG, deliberately scoped to the ~15 currently-active nodes out of the repo's ~77 open issues. It captures the things GitHub doesn't model cheaply: closure groupings, "blocked on Otto's voice", conflict edges, and editorial framing. State drift is bounded by the active set; per-node
stateshould agree with GitHub and GitHub wins if they diverge.Initial content reflects a verification pass post-ADR-0021/0022 merge:
farmabletoin-flightafter discovering they already have open PRs.ADR-0023-go-module-pathwording corrected: needs ADR drafted, no PR yet.Why
With ~77 open issues, scanning GitHub at session start to find "what's ready" is expensive. The active-subgraph view trades a few edits per session for instant orientation. GitHub Projects + custom fields could reproduce this, but at a heavy setup tax that doesn't match the project's current scale. This PR is the lightweight alternative.
The
AGENTS.mdpointer makes the file's role explicit so subsequent agent sessions read it first and update it when nodes change state.Checklist
Security