docs: clarify review fix quickstart flow#52
Conversation
Context: Codex review on PR #51 identified that the usage quickstart skipped commit and remote-check steps before /flow-fix-comments resolution. Changes: - Added /flow-check, /flow-commit, /flow-pr, and /flow-watch steps after fixing valid review comments. - Kept /flow-fix-comments as the final reply/resolution step after refreshed verification. Verification: - npm run check - npm run check:docs - npm run check:text - git diff --check Risk: Low. Documentation-only fix. Refs #15
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: d0ddbe713d
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Context: Codex review on PR #52 found the review-fix quickstart still skipped staging and fresh commit-payload preparation before /flow-commit. Changes: - Added staging guidance for review-fix changes. - Added a fresh commit-payload preparation step before the review-fix commit. - Renumbered the remaining quickstart steps. Verification: - npm run check - npm run check:docs - npm run check:text - git diff --check Risk: Low. Documentation-only fix. Refs #15
|
@codex review |
|
Codex Review: Didn't find any major issues. Delightful! Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
|
@codex review |
|
Codex Review: Didn't find any major issues. 👍 Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
Summary
Clarify the review-comment fix loop in the usage quickstart.
Context
Codex review on merged promotion PR #51 found that the quickstart skipped the commit and remote-check steps before
/flow-fix-comments. That feedback is valid because valid review findings with resolution require commit evidence and refreshed verification.Changes
/flow-checkafter fixing valid review comments./flow-commitfor the review-fix commit./flow-prto update the PR with the review-fix commit./flow-watchbefore/flow-fix-comments.Verification
Self-review
/flow-fix-commentspolicy requirements.Risk
Low. Documentation-only fix.
Rollback
Revert this PR.
Reviewer notes
Please focus on whether the quickstart review-fix sequence now matches the implemented review resolution policy.
Linked issues
Refs #15