Skip to content
authorship.dev

← The plan in detail

Where you sign off

The stations stay. The moments move.

Where in your flow is the moment you sign off? The cycle stays as it is. Per workflow, only the place where Judgment happens moves.

Left the steps as they happen in everyday work, right where the framework sits. Stations can come back, because real work does not run in a straight line.

The author is whoever signs off, in their own name, that the conditions are met.

1Solo, straight on main

  1. You

    Pick up the task: ticket, idea or bug.

    Intent · Opening Line

    One sentence on what done means, and the risk level.

  2. You

    Decide what the agent gets and what you do yourself.

    Orchestration · Delegation Matrix

    What you do yourself, what you delegate, what you grow.

  3. You

    Write the failing test or the expected result first.

    Verification · Prophylaxis

    Set the criterion before you see the output.

  4. Agent

    Implements in the editor. You read along between runs.

    Orchestration · Between Turns

    No second hard task between agent runs.

  5. You

    Read the diff. Run tests, linter and type check.

    Verification · Evidence

    Proof in proportion to the risk. "Tests green" alone is not the criterion.

  6. You

    Self-review the diff once more, as if it were someone else's.

    Judgment · Blunder Check

    Name one place where it could be wrong, then check it.

  7. You

    Commit: your "yes" to the agent.

    You sign off here

    Judgment

    The one signature. There is no second key.

  8. You

    Push to main.

  9. You

    End of day.

    Accountability · Post-Game Analysis

    A short look back in the evening: what did I think through myself today?

There is no second key. Your own self-review carries everything.

2Solo with a PR

  1. You

    Create the issue with the target state.

    Intent · Opening Line

    One sentence on what done means, and the risk level.

  2. You

    Create a feature branch off main and brief the agent.

    Orchestration · Delegation Matrix

    What you do yourself, what you delegate, what you grow.

  3. You

    Write the test or the acceptance check first.

    Verification · Prophylaxis

    Set the criterion before you see the output.

  4. Agent

    Implements on the branch in small commits.

    Orchestration · Between Turns

    No second hard task between agent runs.

  5. You

    Push, open the PR, wait for CI.

    Verification · Evidence

    Proof in proportion to the risk. "Tests green" alone is not the criterion.

  6. You

    Review the PR diff yourself, line by line.

    Judgment · Blunder Check

    Name one place where it could be wrong, then check it.

  7. You

    Merge.

    You sign off here

    Judgment

  8. CI

    The pipeline deploys.

  9. You

    End of day.

    Accountability · Post-Game Analysis

    A short look back in the evening: what did I think through myself today?

For solo work only. In a team this is no model: a second account there bypasses the four-eyes principle.

3Team, PR flow

  1. You

    Pick up the issue and clear up open questions.

    Intent · Opening Line

    One sentence on what done means, and the risk level.

  2. You

    Branch off main. Brief the agent: scope, files, limits.

    Orchestration · Delegation Matrix

    What you do yourself, what you delegate, what you grow.

  3. You

    Write the tests or acceptance criteria first.

    Verification · Prophylaxis

    Set the criterion before you see the output.

  4. Agent

    Implements in small commits. You stay at the keyboard.

    Orchestration · Between Turns

    No second hard task between agent runs.

  5. You

    Push, open a draft PR, wait for CI.

    Verification · Evidence

    Proof in proportion to the risk. "Tests green" alone is not the criterion.

  6. You

    Review your own diff before anyone else sees it.

    Judgment · Blunder Check

    Name one place where it could be wrong, then check it.

  7. You

    Mark the PR "Ready for review".

    You sign off here

    Judgment

    Your key. The burden of proof is with you as the author.

  8. Reviewer

    Reads the diff, comments, approves.

    Judgment

    The second key. The reviewer checks your check, not only the code.

  9. You

    Resolve the comments, merge. The pipeline deploys.

  10. You

    End of day.

    Accountability · Post-Game Analysis

    A short look back in the evening: what did I think through myself today?

Two keys. The burden of proof is with you as the author, the reviewer checks your check.

Two keys

In a team the move needs two keys, and they are not the same key.

  • 1 · Author

    Ready for review

    You carry the burden of proof: criteria, evidence and your named weak spot are in place before anyone else looks.

  • 2 · Reviewer

    Approve (countersign)

    You check the check: is the proof sound, not only whether the code looks good.

4The agent opens the PR

  1. You

    Write the issue: target state, non-goals, risk level.

    Intent · Opening Line

    One sentence on what done means, and the risk level.

  2. You

    Add to the issue which areas the agent may touch and where it stops.

    Orchestration · Delegation Matrix

    Orchestration sits in the issue. After the hand-off you only have the PR.

  3. You

    Add the acceptance criteria or tests to the issue.

    Verification · Prophylaxis

    Set the criterion before you see the output.

  4. Agent

    Picks up the issue, works on a branch, opens the PR.

    Orchestration

  5. CI

    Runs on the PR.

    Verification · Evidence

    Proof in proportion to the risk. "Tests green" alone is not the criterion.

  6. You

    Review the PR as its author, not as a bystander.

    Judgment · Blunder Check

    The risk: you feel like a reviewer. You are the author.

  7. You

    Take over the PR: mark it "Ready for review" or approve it yourself.

    You sign off here

    Judgment

  8. Reviewer

    In a team: review and approve, as in the team flow.

    Judgment

    The second key.

  9. You

    Merge. The pipeline deploys.

  10. You

    End of day.

    Accountability · Post-Game Analysis

    A short look back in the evening: what did I think through myself today?

Intent and Orchestration sit in the issue. The risk: you feel like a reviewer instead of the author.

5Reviewer of someone else's AI PR

  1. You

    Read the PR description and the linked issue.

    Intent

    Are the Opening Line and the risk level there? If not, ask the author.

  2. You

    Read the tests first, then the code.

    Verification · Prophylaxis

    Check the check: were the criteria set before the output, and do they carry?

  3. You

    Find the one risky place in the diff and check it.

    Judgment · Blunder Check

    Name one place where it could be wrong, then check it.

  4. You

    Approve.

    You sign off here

    Judgment

    The countersignature. You countersign; you do not take the sign-off away from the author.

  5. Author

    Merges.

  6. You

    End of day.

    Accountability · Post-Game Analysis

    A short look back in the evening: what did I think through myself today?

A supplement to the main case: you countersign; you do not take the sign-off away from the author.

Try the 30-second check →