01 · A proposal that is almost right
The assistant proposes a readiness probe.
orders-api has no readiness probe (a check that tells
Kubernetes when a pod can receive traffic). So the assistant
proposes one on the container port, 8080. That is
reasonable from the manifest alone. It is wrong for this service. A
sidecar (a second container in the same pod) serves the health
endpoint on 8081.
02 · Say why, in plain words
A comment on the MR is all it takes.
The reviewer writes what they would write to a colleague. There is
no template and no form. Closing an MR without merging is also a
signal. Closing it with a reason is the strongest signal.
The assistant does not read a thumbs-down reaction that comes
without words, so write a sentence.
03 · Collected on a schedule
Every comment lands in one feedback store.
A collection job reads new comments on the assistant's MRs and
issues, Slack corrections and closed proposals. It stores each one
with the proposal it belongs to. This step makes no AI model (LLM)
call.
The job polls every 5 minutes while people actively comment. When
things get quiet, it slows down in steps to every 2 hours. So the
first comment after a quiet period can wait up to 2 hours. The job
excludes the assistant's own comments, so the assistant never
learns from itself.
04 · Commands act immediately
Some comments are instructions, and get an instant answer.
/reprompt regenerates the MR's diff on the next cycle,
usually within 15 minutes. /skip turns "not for this
resource" into a one-line annotation MR. The assistant acknowledges
each command in the thread straight away. It confirms again when
the work is done.
Only people on an allowlist can trigger these commands.
05 · Nothing goes unanswered
A queue of what still needs a reply.
The assistant sorts unanswered feedback into skip directives,
acknowledgements ("thanks", "LGTM") and substantive comments.
Substantive comments get a written answer in the thread. The answer
gives the root cause and says what changes. As of October 2026, a
maintainer helps to write the answer, and the assistant posts it.
The assistant can also retitle the MR, and it marks the feedback as
answered.
06 · Tune the instructions In development
A weekly pass turns feedback into a prompt change.
When enough feedback accumulates for one agent, a weekly analysis
reads it against the agent's current prompt. The analysis proposes
a specific wording change. The proposal is a low-risk draft
MR against your installation's prompt configuration. Items that
people closed with a reason weigh most. The rationale quotes the
operator's own words.
This pass is built, but it stays dormant while we calibrate its
threshold. Until then, people make the same changes by hand from
the answered-feedback queue.
07 · Check the next run
Did the feedback actually land?
After the next full run, the team that operates the assistant
matches each comment to the new proposal for the same workload.
Then it gives a verdict: fixed,
recurs, partial or not re-emitted. The team
also flags a fix that quietly introduced a new mistake.
The assistant reloads prompts before every model call. So a merged
prompt change applies to the next proposal as soon as you deploy
it. No restart is needed.