Cy Fix Reviews

Fix Reviews

Execute the review remediation workflow in a strict sequence. The review files already exist and define the full scope for the run.

Required Inputs

• The scoped issue files listed in <batch_issue_files>.
• The task review round directory and issue-file frontmatter.
• The repository verification workflow required by cy-final-verify.

Workflow

1. Gather round context.

   • Read the scoped issue file frontmatter to understand the round number and issue status/severity. If multiple issue files are in scope, verify their round and round_created_at values agree.
   • Read <batch_scope> to identify the task name, review round, code files in scope, and conditional flags such as auto-commit.

2. Read and triage the scoped issue files.

   • Read every listed issue file completely before editing code.
   • Update each issue file frontmatter status from pending to valid or invalid.
   • Record concrete technical reasoning in ## Triage: state why the issue is valid or invalid, identify the root cause if valid, and outline the intended fix approach.

3. Fix valid issues completely.

   • Fix issues in severity order: critical first, then high, medium, low. This ensures the most impactful fixes land even if the batch is interrupted.
   • Implement production-quality fixes for every valid issue in scope.
   • Add or update tests when behavior changes or regressions are possible. Test file edits are always in scope when they validate a fix.
   • Keep code changes constrained to the files listed in <batch_scope> code files. If a fix absolutely requires touching a file not listed there, limit the change to the minimum needed and document why in the issue file's ## Triage section.
   • Do not refactor, clean up, or improve code that is unrelated to the issues being fixed.

4. Close out issue files correctly.

   • Leave a valid issue at frontmatter status: valid after the code and focused verification are done.
   • Leave an invalid issue at frontmatter status: invalid after documenting why it is invalid.
   • Never set status: resolved; the Loop's Go finalizer owns that transition after the batch completes.

5. Verify before completion.

   • Use cy-final-verify before any completion claim or automatic commit.
   • Run the repository’s real verification commands; do not stop at partial checks.
   • If verification fails, fix the failing checks in the code you changed. Do not revert your fixes to pass verification -- find the root cause of the failure and address it. If the failure is in pre-existing code unrelated to your changes, document it in the relevant issue file’s ## Triage section and proceed. If two fixes conflict with each other and verification cannot pass after two attempts, document the conflict in both issue files and report the situation rather than looping indefinitely.
   • If all issues in the batch are invalid and no code was changed, skip the commit step entirely -- do not create an empty commit. Still run verification to confirm no regressions.
   • Leave the diff ready for manual review unless <batch_scope> shows "Automatic commits: enabled".

Critical Rules

• Do not generate another review inside this workflow. The reviewer agent already produced the round files.
• Do not publish or push changes. This workflow is local-only.
• Do not modify issue files outside the scoped batch.
• Do not create, rename, timestamp, or mark an issue resolved; the Go writer and finalizer own those bytes.