Deploy backlog issues

Before you start

• Vinaya is installed in the repository.
• You have one small change in mind: a fix, a chore, a small feature, with no sibling task to plan against.

The flow

OUTSIDE VINAYA · PRODUCT MANAGEMENT · defines the what, hands specs to engineering

Engineering need

No product project behind it:tech debt, orchestration fixes,bugs found while working

STAGE 1 · THINKING · architect and planner

Planner · backlog Issue

One-off found while working;or added to an open tranchelighter planning, no tranche

#1000

backlog

Resume refuses kept workopened · no tranche

Planned tasks: each an Issue with a brief (Surface, objectives, test plan) — the contract the loop executes

STAGE 2 · EXECUTING AND RETROSPECTING · the loop, the gates, closure and the record: all automatic

Developer–Review LoopDRIVEN BY THE OPERATOR

dev-review-loop.tssends the work, reads the result, decides the next step

MULTI-AGENT ORCHESTRATION · THE DRIVER

Developer agent

implements the brief

Reviewer agents

judge it against its Surface and objectives

Atta Engine · LangGraph runtimeCHECKPOINTS · HALT AND RESUME · RECOVERY

Claude CodeSANDBOXED

CodexSANDBOXED

macOSsandbox: Seatbelt

Linux / Unixsandbox: seccomp

GATES · at every step, the doors to GitHub · same for planned and hot · cannot be skipped

Ring 0 · commit + push hooks

last door before GitHub

Ring 1 · CI on the PR

same checks, merge blocked while red

Ring 2 · audits

after merge, always on

BEFORE CLOSURE · REPLAN, RECOVER, MERGE

Ready? → Review and merge

Gates green on the pull request.Required reviews report.The Principal merges. Nobody else does.MERGED → ARCHIVE · REFUSED → EXECUTE / REPLAN

RETROSPECTING · on every merge, automatic

Archivist

Closes each task on mergeRecords what shipped and why

Retrospective record

What shipped and why

STAGE 4 · SELF-IMPROVEMENT · the Log teaches the process

Report: what the Log says

Written from every run of the deploy. Example figures.

34 mintime per task

19 of 52second rounds

418problems caught

WHERE THE TIME GOES

Developer 84% · Reviewers 16% · most extra rounds come from one gate · a vague Surface doubles the rounds

Improver

Reads the report, proposes what to changeBACK TO LINEAR / JIRA · THE PRINCIPAL APPROVES

Project: run the doc gate before pushFix · cuts an expected 0.7 rounds per task

Project: surface check at planning timeFix · catches vague briefs before dispatch

Project: resume preview in StudioNew feature · shows what a ruling will change

Steps

1. 1

   Write the backlog Issue

   In your agent, run /vinaya planner and describe what you found. The Planner reads the code and writes one backlog Issue: the evidence pasted, every fact about code as a checked fact, one or two objectives, the files it may touch and how to prove it. No tranche.

2. 2

   Run it

   Run the Issue through the loop with vinaya task run --issue <n>, or let the Operator start it.

3. 3

   Merge

   When the pull request is ready, merge it. The Issue closes on merge.

What you get

• One reviewed pull request, one closed Issue. No tranche, no milestone.

What's next

The whole process

Every flow on one diagram, from product work to merge and back.

See whole flow diagram