Skip to content
← All journal notes

Journal / Workflow

The agentic repository improvement loop

A bounded pass, independent review, verified integration, and a durable record.

/1 MIN READ

The documented workflow uses a standing repo prompt to repeat useful, bounded improvement passes. Each pass inspects the repository, selects a concrete change, implements it, verifies it and creates a reviewable pull request.

Review is a separate role

QABot returns MERGE or HOLD from the evidence. MergeBot squash-merges eligible changes under repository policy. A HOLD sends the change back for correction and verification. Deployment authorization remains a separate policy decision.

The reusable prompt

The public agent workflow contains a reference prompt adapted from this process. It is a reusable technical template; private repository targets and original operating instructions are omitted.

The record for each pass should contain the problem, resulting behavior, tests actually run, review decision, limitations and next justified improvement. Project identities and business work stay private.