Skip to content
Documentation
Manual
Operations digest

Operations digest

This page is an index only. It links to the committed source for each topic and does not copy it. The linked page is authoritative: when this page and a source disagree, the source wins, and the drift is reported (an issue or a comment on the card that touches the row) rather than fixed here by hand. A row that is no longer right is deleted, not amended.

Maintenance: the desk session drafts entries at hand-over and writes no files. The docs session commits and lands them as a normal docs card. Every edit re-checks the touched rows against the source at the commit named in the As of column. A change to .agents/desk.md or AGENTS.md that tells desk to maintain this page is a separate, Opus-reviewed change.

Decisions index

Decision rows are IDs in the decision table. A status other than decided is marked.

TopicOne-line pointerSourceStatusAs of
How decisions are recordedWhere a decision is proposed, settled and recordedD10decided4e5d4a8
Documentation siteThe site toolchain and its deploymentD9decided4e5d4a8
Language and storageImplementation language, binary shape, databaseD3decided4e5d4a8
Agents and pushingWho pushes, and what approves a pushD18decided4e5d4a8
Autonomy defaultsDefault autonomy per action and its floorD36decided4e5d4a8
Workflow presetsPer-repository workflow presetsD47decided4e5d4a8
ReleasesTag, build and distribution of releasesD24decided4e5d4a8
Host softwareWhat is installed on the host, and howD28decided4e5d4a8
Remote accessWeb UI, API and browser-session exposureD29decided4e5d4a8
Forge accessHow GitHub is reached from the productD31decided4e5d4a8
Subscription loginsVendor terms and the credential boundaryD40decided4e5d4a8
WorkspacesWorkspaces with named agentsD42decided4e5d4a8
External skill setsSkill-set selection, mounting and the defaultD52, designdecided4e5d4a8

Recurring procedures

TopicOne-line pointerSourceStatusAs of
Which sessions runSessions to keep open and their rolesSessions to keep opendecided4e5d4a8
Models per roleSubagents and the model each usesSubagents and their modelsdecided4e5d4a8
Review before landingThe review gateThe review gatedecided4e5d4a8
Landing and worktreesHow work lands, and where it is checkedLanding and worktreesdecided4e5d4a8
Commit conventionsMessage form and trailersCommitsdecided4e5d4a8
Make targetsThe project’s checks and buildsMake targetsdecided4e5d4a8
Issue work through RESTHow issues are read and writtenIssues through RESTdecided4e5d4a8
Publishing an artifactThe pre-publication secret scan for a fileDesk instructionsdecided4e5d4a8
Documentation sessionsWhat the docs session does and returnsDocs instructionsdecided4e5d4a8
Repository rulesHard rules and ways of workingAGENTS.mddecided4e5d4a8

How-tos

TopicOne-line pointerSourceStatusAs of
Writing issues and commentsHow to write coordination textIssues and commentsdecided4e5d4a8
Shortening an issue bodyKeep contracts when trimmingPreserve contractsdecided4e5d4a8
Publishing evidenceSanitizing and linking evidencePublish evidence safelydecided4e5d4a8
Workflow protocol recordThe approved protocol requirementsWorkflow protocolsdecided4e5d4a8
Preparing the hostStep-by-step host setupPrepare the Mac miniunverified4e5d4a8
Reaching the host remotelyVPN options for the phoneReach it from your phoneunverified4e5d4a8
Host secretsWhere host secrets liveSecretsunverified4e5d4a8

Known gaps

TopicOne-line pointerSourceStatusAs of
Crewbook splitRemaining integration of the separate crewbook repository#283open2026-10-06
Procedures as skillsMoving land, board, hand-over and delegate procedures out of the prompts#240open2026-10-06
Go tests and HOMETwo tests depend on the caller’s HOME and fail in some environments#305open2026-10-06
GraphQL deny rulesThe deny rules for direct GraphQL are best-effort, not a boundary#314open2026-10-06
Link fragmentsThe link checker does not yet check #anchor fragments in CI#318open2026-10-06
Pending policy proposalStack pull requests with gh stack