devbook-collaboration

Run the acceptance decision on a devbook chapter — show the built work against the chapter as evidence rather than a summary of it, refuse over an open question or a lapsed approval, take accept, send back, or decline from a person, and on acceptance write devbook's own status: accepted rung with accepted-by, accepted-at, and accepted-hash beside the approval record it stands on. Use when: accepting delivered work against its chapter, recording that what was built satisfies what was agreed, signing off a feature at a personal-validation gate, or lifting an acceptance that has gone stale. Triggers on: "accept this chapter", "does the build match the spec", "record the acceptance", "is this accepted", "the acceptance is stale", "sign off the delivered work".

Run the approval decision on a devbook chapter — show the chapter itself with its open annotation fences, flags first and any note raised since approved-at named as such, take approve, revise, or decline from a person, and on approval write devbook's own status: approved rung with approved-by and approved-at while clearing the collaboration state. Use when: approving a chapter, signing off a specification before it becomes work, recording who approved what, weighing objections raised after an approval, or lifting an approval that has gone stale. Triggers on: "approve this chapter", "sign off on this", "record the approval", "is this approved", "the approval is stale", "what was raised since the approval".

Hand a devbook chapter to a named reviewer and produce the brief they start from — what changed, what the reviewer is being asked to judge, and which neighbouring chapters they need. Records the request on the chapter itself so it survives the session. Use when: asking someone to review a chapter, passing devbook work to another person or session, or parking a chapter that needs a decision you cannot make. Triggers on: "hand off this chapter", "ask someone to review", "request review of", "who should review this", "park this for review".

Review one devbook chapter and record the verdict on the chapter itself — check it against its folder's rules, the neighbours it links to, and the evidence it claims, then write each unresolved finding as an annotation fence beside the passage it is about and set the review state. The reviewer's half of a hand-off. Use when: reviewing a devbook chapter, answering a review request, checking whether a chapter is still true, or resolving findings someone left on one. Triggers on: "review this chapter", "review the domain model", "is this chapter still accurate", "answer the review", "resolve the open findings".

Sweep a repository's devbook folders for everything a review pass has left open — chapters awaiting a named reviewer, chapters carrying unresolved notes, chapters cleared and waiting for approval, and approvals that have gone stale because the content changed after they were signed. Reports one queue grouped by who owes the next move. Use when: asking what is waiting on review, what needs approval, whose turn it is, or whether any approval has lapsed. Triggers on: "what is awaiting review", "review queue", "what needs approval", "stale approvals", "whose turn is it", "open findings across the devbook folders".