Skip to content
Templates/Feedback
FeedbackLow risk

Feedback Improvement Loop

Turn failed runs and user feedback into small template, skill, or checker improvements.

What this Loop Engineering template does

Review recent feedback, choose one small loop improvement, validate it against representative cases, and decide whether to keep it.

Feedback can come from users, failed validation logs, reviewer notes, or repeated support questions. Keep the improvement narrow.

When to use it

Improving loop templates after real use
Updating quality checklists
Reducing repeated failure modes

When not to use it

Collecting feedback without acting on it
Large rewrites without validation
Using private user data without permission

Validation checks

validation
Feedback is grouped by repeated issue
One improvement is chosen
Old and new outputs are compared on representative cases
The change is kept only if it improves clarity or safety

Boundaries & stop rule

!Do not rewrite unrelated templates
!Do not expose private user feedback
!Do not treat one vague complaint as a broad product direction
!Do not skip validation after changing a template
Stop rule — Stop when one improvement is validated or when feedback is too unclear to act on. If feedback is ambiguous, ask a clarifying question or collect more examples before changing the loop.

Copy the loop prompt

claude-goal.txt
/goal Review recent feedback, choose one small loop improvement, validate it against representative cases, and decide whether to keep it.
 
Task type: Custom
Target tool: Generic Agent
 
Work toward this goal until all validation checks pass or the stop rule is reached.
 
Design hypothesis:
This feedback improvement loop can produce a safer result if the scope stays narrow, validation is explicit, and a checker can reject shortcut work.
 
Smallest useful run:
Run one bounded pass on the newest relevant signal before expanding scope or adding a schedule.
 
Loop cycle:
1. Discovery — Read the latest signal for this template before acting: CI output, issue detail, review comment, dataset report, or content brief.
2. Handoff — Hand the work to one agent in an isolated branch, worktree, or clearly scoped session. Keep final approval with a human.
3. Verification — Use an independent review pass to confirm the result, inspect the diff or artifact, and reject shortcut work.
4. Persistence — Save a short run note with the signal reviewed, actions taken, validation result, and next recommended step.
5. Scheduling — Run manually until the loop is reliable; only then consider a scheduled or event-triggered run.
 
Context:
Feedback can come from users, failed validation logs, reviewer notes, or repeated support questions. Keep the improvement narrow.
 
Validation:
Feedback is grouped by repeated issue
One improvement is chosen
Old and new outputs are compared on representative cases
The change is kept only if it improves clarity or safety
 
Validation evidence:
Record the original signal, checks run, final result, changed files or artifacts, and any checker rejection.
 
Independent checker:
Use an independent review pass to confirm the result, inspect the diff or artifact, and reject shortcut work.
 
Boundaries:
Do not rewrite unrelated templates
Do not expose private user feedback
Do not treat one vague complaint as a broad product direction
Do not skip validation after changing a template
 
Stop rule:
Stop when one improvement is validated or when feedback is too unclear to act on.
Maximum iterations: 4
 
Budget:
Example only: stop before exceeding the agreed per-run token budget.
 
Human approval:
Required before merge, deploy, delete, purchase, or external communication.
 
Fallback:
If feedback is ambiguous, ask a clarifying question or collect more examples before changing the loop.
 
Loop Validation Log:
- Hypothesis: This feedback improvement loop can produce a safer result if the scope stays narrow, validation is explicit, and a checker can reject shortcut work.
- Smallest useful run: Run one bounded pass on the newest relevant signal before expanding scope or adding a schedule.
- Expected evidence: Record the original signal, checks run, final result, changed files or artifacts, and any checker rejection.
- Actual evidence: [fill in after the run]
- Passed? [yes / no / partial]
- Feedback: After the run, note what the loop learned, what failed, and what should change before the next pass.
- Next step: [stop / adjust the loop / run the next pass]
 
Do not delete tests, bypass checks, or modify unrelated files just to satisfy the validation condition. If blocked, stop and summarize the blocker, attempted fixes, and recommended next action.

Failure modes to watch

Overfitting a template to one user's unusual case
Making the output longer but not clearer
Improving polish while weakening safety
Forgetting to retest the changed loop
Worked scenario review · maintained by TianMingAI · 2026-07-21

Review receipt

This is a bounded review exercise for the template, not a claim about a production deployment.

Scenario

Readers repeatedly say the difference between a harness and a loop is unclear, while one comment requests an unrelated visual redesign.

Baseline evidence

The loop groups dated feedback by source, page, user intent, frequency, and severity, then checks the current page and usage evidence before proposing changes.

Validation result

It adds one responsibility-map example tied to the repeated comprehension problem, defines a follow-up measure, and leaves the isolated redesign request outside scope.

Shortcut rejected

Treating every comment equally, inventing user volume, or changing several page variables at once is rejected because the outcome would be untraceable.

Human gate

An editor verifies that the feedback cluster is real, approves the scoped change, and decides after observation whether the explanation actually improved comprehension.

Final decisionPass

Loop Engineering FAQ

For a small site, weekly is enough. Review the most repeated issues, choose one improvement, test it, and ship only if it helps.