You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
reason: PR fix(pr-comments): handle multi-comment fix requests #150 changes the long-term behavior contract for the PR comment response workflow: body-level /fix requests can target all, unresolved, or category-scoped inline review comments, and unresolved/outdated state now has explicit interpretation rules. Existing product docs described the workflow and resolved comment output, but did not document these multi-comment scope and thread-state semantics.
reason: PR Update tech.md #53 only corrects the technical spec's implementation branch-name examples from oz-agent/... to spec/.... The authoritative product documentation already describes the default implementation branch behavior using the spec/implement-issue_<issue_number> form, so no long-term product docs change is needed.
change summary:
No product docs patch is needed because docs/product/raw/implementation-workflow.md already accurately documents the merged workflow behavior.
reason: PR fix(ci): commit implementation workflow diffs #58 changed durable workflow behavior: implementation agents now leave diffs and metadata for the outer workflow to commit and push, and spec workflow entry points are guarded from issues already marked ready-to-implement. The implementation handoff behavior was already documented, but the spec workflow gating and source attribution needed to be updated.
reason: PR fix(ci): harden implementation branch handoff #59 only hardens the implementation branch handoff internals by stashing the full worktree and recomputing committable paths after restore. It does not change the long-term implementation workflow contract already documented in docs/product/raw/implementation-workflow.md.
reason: PR fix(ci): preserve implementation status paths #60 only fixes internal implementation-branch handoff plumbing so captured git porcelain status output preserves leading spaces, with a regression test. It does not change long-term product behavior, workflow triggers, user-visible semantics, configuration, or integration contracts beyond the behavior already covered by existing implementation workflow docs.
reason: PR fix(ci): support workflow-file push token #68 changes the automatic implementation workflow's long-term configuration behavior for implementation branches that modify GitHub workflow files. Product docs needed to record that such changes require WORKFLOW_UPDATE_TOKEN, while ordinary implementation pushes continue to use GITHUB_TOKEN.
change summary:
Updated the automatic implementation workflow product doc to describe WORKFLOW_UPDATE_TOKEN requirements for .github/workflows changes and added PR fix(ci): support workflow-file push token #68 to the source references.
reason: PR fix(ci): use workflow token for git push auth #69 fixes the internal git push authentication path for workflow-file implementation branches and flushes diagnostics, without changing the documented implementation workflow contract. The existing implementation workflow docs already state that workflow-file changes require WORKFLOW_UPDATE_TOKEN and use that token for pushing.
change summary:
No product docs patch is needed because the change is an internal CI authentication hardening and diagnostic improvement already covered at the product-behavior level.
reason: PR fix(ci): update actions for Node 24 runtime #73 only updates GitHub Actions runtime compatibility by upgrading action versions and opting workflow jobs into Node 24. The merged changes are CI/build plumbing and test coverage, with no change to product workflows, permissions, lifecycle rules, public contracts, or documented user-visible behavior.
reason: PR fix(ci): avoid auto review for implementation PRs #74 changes long-term workflow behavior: implementation PR creation no longer dispatches AI PR Review automatically, and PR comment mentions are routed away from issue spec/implementation workflows to review-pr. Existing product docs stated the old automatic implementation review behavior and did not clarify the PR-comment exclusion.
change summary:
Updated implementation workflow docs to state that implementation PRs remain draft and require manual PR comment mention for review, and updated spec/implementation trigger docs to clarify that PR comments are handled by the review workflow.
reason: PR fix(review): skip AI review for draft PRs #76 changed the AI PR Review workflow so draft or fork PRs are stopped by preflight before the real review job runs. Existing product docs already state that only open, non-draft, same-repository PRs are reviewable and that draft or fork PRs are skipped without running the agent, posting review, or uploading artifacts.
reason: PR Rename repo review companion skills #79 renamed the long-lived repo review companion skills used by AI PR Review from review-pr-local/review-spec-local to review-pr-repo/review-spec-repo. Existing product docs described PR review behavior but did not record the current repo companion selection, so the authoritative docs needed a concise update.
change summary:
Updated the PR review product doc to state that spec-only PRs use review-spec-repo, other code PRs use review-pr-repo, and both repo companions preserve the core review-pr/review-spec output contract.
reason: PR fix(ci): stop auto-reviewing spec PRs #84 changes the long-term spec workflow behavior by stopping automatic AI PR Review dispatch after spec PR creation or update. Existing product docs still described the old automatic dispatch behavior, so the authoritative spec workflow documentation was updated.
change summary:
Updated the Spec PR follow-up review section to state that spec PRs are no longer auto-reviewed and must be reviewed via PR comment mention when needed.
reason: PR feat: sync issue state on plan approval #66 adds durable lifecycle behavior for spec plan approval: plan-approved now removes ready-to-spec from the linked issue and may dispatch implementation when ready-to-implement and the target agent assignment are already present. Existing product docs mentioned plan-approved as implementation context, but did not document the new issue state synchronization or conditional dispatch behavior.
change summary:
Updated raw product docs to describe spec plan approval semantics, automatic ready-to-spec removal, explicit ready-to-implement ownership, and conditional implementation dispatch after approval.
reason: PR feat: add PR bot review command trigger #82 changes the long-term AI PR Review trigger contract from a bare PR comment mention to an exact body-level @AGENT_LOGIN /review command, with non-draft/open PR gating and invalid comment forms skipped. Existing product docs still described bare @AGENT_LOGIN PR comment triggering, so authoritative docs needed correction.
change summary:
Updated raw product docs to document @AGENT_LOGIN /review as the PR conversation comment command for manually requesting AI review, including body-level command constraints and skipped invalid forms.
reason: PR fix(review): link comment-triggered runs to PRs #89 changes long-term AI PR Review behavior: comment-triggered and manual runs for same-repo PRs now publish an AI PR Review commit status on the PR head. Existing product docs described those triggers but did not document the PR association/status semantics.
change summary:
Updated the authoritative PR review raw product doc with the commit status lifecycle, target URL association, and scope limits for comment/manual AI PR Review runs.
reason: PR docs(spec): create issue 85 specs #86 mainly merged specs for future local review dirty-worktree behavior, and those specs explicitly state they do not implement the behavior. The implemented AI PR Review status behavior included in the merge is already covered by docs/product/raw/pr-review-verdict.md, so no long-term product docs change is needed.
change summary:
No docs/product patch needed; existing product docs already describe the delivered PR comment/manual AI PR Review commit status behavior, and the issue 85 dirty-worktree behavior remains spec-only in this PR.
reason: PR feat: allow local review with dirty worktrees #90 changed the long-term behavior of local PR/spec review entrypoints: they now support dirty worktrees, generate review diffs from the current worktree snapshot, and use a baseline status file for validation. Existing product docs still stated that local review required a clean worktree, so the authoritative docs needed correction.
change summary:
Updated the local review entrypoint documentation to describe dirty-worktree support, current-worktree diff semantics, the .local_review_baseline.status file, validation boundaries, and the PR/spec sources.
reason: PR feat(skill): add security review supplements #93 changes the long-term AI PR Review workflow by adding security-review-pr and security-review-spec as mandatory supplemental passes for code and spec reviews. Existing product docs described review skill selection and review.json semantics but did not cover security supplement scope, reporting, or verdict impact.
reason: PR fix(review): prefer GitHub PR description locally #103 changed the local review input contract: pr_description.txt now prefers metadata from the GitHub PR associated with the current branch and falls back to locally generated metadata only when that fetch is unavailable. This is durable user-facing workflow behavior already covered by the local review product doc, so the authoritative docs need a targeted update.
change summary:
Updated the local review entrypoint documentation to state the pr_description.txt source priority and clarify that pr_diff.txt remains generated from the local worktree diff.
reason: PR docs(skill): prefer origin for branch bases #107 changed the long-term behavior of local Git helper skills: same-repository branch and worktree creation now prefer origin/, remote-base branch creation avoids tracking the base, and git-worktree clarifies that Codex tool-call directories do not move the user's existing shell. Existing product docs still described upstream/main as the default worktree base order, so the authoritative raw doc needed updating.
change summary:
Updated the local Git helper skills raw product doc to document git-branch behavior, origin-first base selection for same-repository work, no-track remote-base creation, git-worktree remote-base handling, and the distinction between Codex tool-call working directories and the user's shell.
reason: PR docs(skill): optimize git skill workflows #109 changes durable behavior for local Git helper skills, including worktree path semantics and when GitHub, remote, fetch, and freshness checks are performed. Existing product docs still described the old flattened worktree slug path and did not cover the updated git-commit/git-push behavior.
change summary:
Updated the authoritative local Git helper skills doc for combined local checks, conditional remote/freshness checks, preserved .worktrees/ directory structure, and the git-commit/git-push helper behavior introduced by PR docs(skill): optimize git skill workflows #109.
change summary:
Added a raw product doc for the PR comment response workflow and updated spec/implementation workflow docs to distinguish /review PR comments from /fix PR comments.
reason: PR docs(skill): add CI failure diagnosis skill #112 added the diagnose-ci-failures skill, which introduces a durable agent-facing workflow for CI failure diagnosis, supported inputs, output expectations, and diagnosis-only boundaries. Existing product docs did not cover this CI diagnosis capability.
change summary:
Added a new authoritative raw product doc describing the CI failure diagnosis skill, including target discovery, log analysis scope, error categorization, plan output, and no-code-change boundary.
reason: PR 新增 resolve-merge-conflicts #114 merged a new user-facing agent skill, resolve-merge-conflicts, with durable workflow behavior, supported conflict types, CLI output modes, and safety boundaries. Existing product docs did not cover this merge-conflict resolution capability.
change summary:
Added a raw product doc describing when to use the resolve-merge-conflicts skill, what conflict context it exposes, supported output modes, and the local-only resolution and validation boundaries.
reason: PR fix: align local review base selection with PR metadata #116 changed the long-term behavior of local review input preparation: existing PR branches now use the PR base SHA unless an explicit base is provided, explicit base metadata stays synchronized with the diff base, and fallback base selection now prefers origin/main before upstream/main. Existing product docs described the older base ordering and needed correction.
change summary:
Updated the authoritative local review documentation to describe PR base SHA precedence, explicit base synchronization, and the new origin/main fallback order.
reason: PR fix: preserve PR title for comment responses #120 changes durable behavior of the PR comment response workflow: direct push-head responses no longer rewrite the original PR title or body, and response comments now include a summary derived from pr_summary. Existing product docs described the old push-head PR metadata update behavior, so they needed correction.
change summary:
Updated the authoritative PR comment response workflow doc to state that push-head runs preserve the original PR title/body, still use pr_title and pr_summary for validation and metadata, and include a cleaned summary in the response comment when present.
reason: PR fix(triage): prefetch dedupe candidates #123 changes the long-term issue triage contract: duplicate checking now uses workflow-prefetched candidates instead of agent-side GitHub issue scans. Existing product docs described the triage context and duplicate output but did not capture this authoritative candidate source, recent-closed window, or empty-candidate behavior.
change summary:
Updated the issue triage workflow docs to describe dedupe_candidates.json as the authoritative duplicate-check input, the open plus recent-closed candidate window, pull request exclusion, empty-candidate handling, and the duplicate_of source semantics.
reason: PR docs(skills): remove repo name from descriptions #126 only removes a hard-coded repository name from repo-local skill description metadata. The merged diff does not change long-term product behavior, workflows, permissions, lifecycle rules, configuration semantics, public errors, or integration contracts.
reason: PR 新增 SKILL: update-dedupe，用于自进化 dedupe-issue #128 adds the long-lived repo-specific dedupe companion skill, which changes the product knowledge available to issue triage and duplicate detection. Existing product docs only referenced this companion indirectly, so a narrow authoritative raw doc was added for its scope, empty initial cluster state, and update boundary.
change summary:
Added docs/product/raw/dedupe-guidance-companion.md documenting the dedupe-issue-repo companion, its limits relative to core dedupe-issue behavior, the empty initial Known-duplicate clusters state, and the future update boundary.
reason: PR feat: add update-dedupe guidance workflow #129 introduced the long-lived update-dedupe skill and manual workflow, including trigger semantics, evidence requirements, write-surface boundaries, and PR behavior. Existing product docs covered the dedupe companion but did not document this workflow itself.
change summary:
Added a new raw product doc describing the update-dedupe workflow, strong duplicate evidence requirements, repeated-cluster learning behavior, allowed write surface, and PR behavior.
reason: PR fix(update-dedupe): repair feedback aggregation query #131 fixes internal update-dedupe feedback aggregation plumbing by avoiding a GitHub GraphQL variable collision, expanding query placeholders correctly, and printing gh stderr on failure. It does not change the documented product workflow, duplicate evidence rules, write boundaries, or user-facing behavior already covered by the update-dedupe product docs.
change summary:
No product docs patch is needed because the change is an internal script reliability fix and existing long-term docs already describe the stable workflow semantics.
reason: PR test(update-dedupe): cover feedback aggregation safety #132 keeps the existing update-dedupe product behavior: when guidance changes exist, the workflow creates or updates a PR whose body includes the evidence summary. The implementation moved body construction into a helper and uses gh --body-file to treat generated summary text as data, but this is internal workflow hardening already consistent with the documented behavior.
reason: PR docs(triage): add repo triage guidance #133 changes durable workflow behavior by adding repository-specific triage guidance and tightening PR/implementation agent context handling around stable local snapshots. Existing product docs covered the workflows generally but did not describe the new companion skill rules, PR comment snapshot inputs, or no-fetch boundary.
reason: PR fix(workflows): authenticate PR diff fetch #140 only changes the internal GitHub Actions implementation used by AI PR Review and PR comment response workflows to fetch PR base commits with a one-shot authenticated Git extraheader. The merged behavior does not change product workflow triggers, agent context contracts, branch strategies, permissions exposed to users, or public error semantics already documented under docs/product/.
reason: PR private repo 会出现 author_association 判定失败 #142 changed the long-term authorization behavior for PR comment response: private-repo CONTRIBUTOR triggers can now run when the actor has write, maintain, or admin collaborator permission, while public or low-permission contributors remain rejected. Existing product docs still described CONTRIBUTOR as always unauthorized, so the authoritative raw doc needed an update.
change summary:
Updated the PR comment response workflow raw product doc to describe the private-repository CONTRIBUTOR permission fallback, the remaining rejection cases, and the new context fields for base repo privacy and repository permission.
reason: PR fix(workflows): avoid token in fetch arguments #143 only hardens internal GitHub Actions credential handling while fetching the PR diff; it does not change review or PR-comment workflow triggers, permissions, outputs, branch behavior, public errors, or agent contracts. Existing product docs cover the long-term product semantics, and the credential-storage detail is implementation/security plumbing rather than durable product knowledge.
reason: PR feat: add project installer #148 adds a user-facing project installer and changes the long-term onboarding/sync workflow for adopting AICodingFlow in target repositories. The behavior includes durable install entrypoints, copied paths, preservation rules, dry-run semantics, and optional bootstrap guidance that were not covered by existing product docs.
reason: PR fix(pr-comments): handle multi-comment fix requests #150 changes the long-term behavior contract for the PR comment response workflow: body-level /fix requests can target all, unresolved, or category-scoped inline review comments, and unresolved/outdated state now has explicit interpretation rules. Existing product docs described the workflow and resolved comment output, but did not document these multi-comment scope and thread-state semantics.
reason: PR feat: add project installer #148 adds a user-facing project installer and changes the long-term onboarding/sync workflow for adopting AICodingFlow in target repositories. The behavior includes durable install entrypoints, copied paths, preservation rules, dry-run semantics, and optional bootstrap guidance that were not covered by existing product docs.
reason: PR fix(pr-comments): handle multi-comment fix requests #150 changes the long-term behavior contract for the PR comment response workflow: body-level /fix requests can target all, unresolved, or category-scoped inline review comments, and unresolved/outdated state now has explicit interpretation rules. Existing product docs described the workflow and resolved comment output, but did not document these multi-comment scope and thread-state semantics.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Synchronizes long-term product docs from merged implementation pull requests.
Latest decision:
requiredAffected docs:
docs/product/raw/pr-comment-response-workflow.mdSource context:
Patch summary:
Updated the PR comment response workflow source doc to describe review_comment_ids.json resolved/outdated thread state, multi-inline-comment request handling, unresolved-state rules, outdated-comment handling, and one resolved_review_comments entry per resolved inline comment.
Processed decisions in this PR:
PR Update product.md #52: Update product.md
requiredoz-agent/implement-issue-<issue_number>改为spec/implement-issue-<issue_number>。现有长期产品文档未覆盖该 workflow 行为，因此需要补充 authoritative product docs。docs/product/raw/implementation-workflow.mdPR Update tech.md #53: Update tech.md
not-neededoz-agent/...tospec/.... The authoritative product documentation already describes the default implementation branch behavior using thespec/implement-issue_<issue_number>form, so no long-term product docs change is needed.PR feat: add issue implementation workflow #50: feat: add issue implementation workflow
not-neededdocs/product/raw/implementation-workflow.mdNo product docs patch is needed because docs/product/raw/implementation-workflow.md already accurately documents the merged workflow behavior.
PR docs(spec): create issue 51 specs #55: docs(spec): create issue 51 specs
requireddocs/product/raw/pr-review-verdict.md新增 docs/product/raw/pr-review-verdict.md，记录 review.json verdict 契约、PR 类型与作者身份判断、GitHub review event 映射、human reviewer 选择和 merge gate 语义。
PR fix(ci): tighten workflow trigger gates #56: fix(ci): tighten workflow trigger gates
requireddocs/product/raw/implementation-workflow.mddocs/product/raw/spec-workflow.md更新 authoritative implementation workflow 文档，补充触发 gate、AGENT_LOGIN 配置和 plan-approved 语义；新增 raw 产品文档记录自动 spec workflow 的触发契约。
PR fix(ci): commit implementation workflow diffs #58: fix(ci): commit implementation workflow diffs
requireddocs/product/raw/spec-workflow.mddocs/product/raw/implementation-workflow.mdDocument that manual spec workflow dispatch still requires ready-to-spec plus target agent assignment, document that ready-to-implement suppresses spec workflow startup, and add PR fix(ci): commit implementation workflow diffs #58 to affected source references.
PR fix(ci): harden implementation branch handoff #59: fix(ci): harden implementation branch handoff
not-neededNo product docs patch is needed.
PR fix(ci): preserve implementation status paths #60: fix(ci): preserve implementation status paths
not-neededNo product docs patch is needed.
PR fix(ci): dispatch reviews for generated spec PRs #65: fix(ci): dispatch reviews for generated spec PRs
requireddocs/product/raw/spec-workflow.mddocs/product/raw/pr-review-verdict.md更新自动 spec workflow 文档，说明生成 spec PR 后会显式触发 AI PR Review；更新 PR review 文档，说明 pull_request 与 workflow_dispatch 两种触发方式及 draft/fork PR 跳过规则。
PR fix(ci): harden workflow handoff file selection #67: fix(ci): harden workflow handoff file selection
requireddocs/product/raw/implementation-workflow.mddocs/product/raw/pr-review-verdict.mddocs/product/raw/spec-workflow.md更新 authoritative raw 产品文档，覆盖 implementation handoff 文件选择、AI PR Review 的 open/comment 触发行为，以及 spec workflow 只复用 open PR 的规则。
PR fix(ci): support workflow-file push token #68: fix(ci): support workflow-file push token
requireddocs/product/raw/implementation-workflow.mdUpdated the automatic implementation workflow product doc to describe WORKFLOW_UPDATE_TOKEN requirements for .github/workflows changes and added PR fix(ci): support workflow-file push token #68 to the source references.
PR fix(ci): use workflow token for git push auth #69: fix(ci): use workflow token for git push auth
not-neededNo product docs patch is needed because the change is an internal CI authentication hardening and diagnostic improvement already covered at the product-behavior level.
PR fix(ci): update actions for Node 24 runtime #73: fix(ci): update actions for Node 24 runtime
not-neededNo product docs patch is needed.
PR fix(ci): avoid auto review for implementation PRs #74: fix(ci): avoid auto review for implementation PRs
requireddocs/product/raw/implementation-workflow.mddocs/product/raw/spec-workflow.mdUpdated implementation workflow docs to state that implementation PRs remain draft and require manual PR comment mention for review, and updated spec/implementation trigger docs to clarify that PR comments are handled by the review workflow.
PR fix(review): skip AI review for draft PRs #76: fix(review): skip AI review for draft PRs
not-neededNo product docs patch needed; the authoritative PR review behavior is already covered by existing docs/product content.
PR feat: add PR review verdict gate #71: feat: add PR review verdict gate
not-needed无需补丁；现有产品文档已描述本次合并后的长期产品行为。
PR Rename repo review companion skills #79: Rename repo review companion skills
requireddocs/product/raw/pr-review-verdict.mdUpdated the PR review product doc to state that spec-only PRs use review-spec-repo, other code PRs use review-pr-repo, and both repo companions preserve the core review-pr/review-spec output contract.
PR 新增一个 review-pr-local / review-spec-local #81: 新增一个 review-pr-local / review-spec-local
requireddocs/product/raw/pr-review-verdict.md已在 docs/product/raw/pr-review-verdict.md 增加本地 review 入口章节，说明 review-pr-local/review-spec-local 的适用时机、委托关系、根目录快照契约、干净 worktree 要求、只允许 review 输出变更的校验约束，以及 base/spec context 解析行为。
PR fix(ci): stop auto-reviewing spec PRs #84: fix(ci): stop auto-reviewing spec PRs
requireddocs/product/raw/spec-workflow.mdUpdated the Spec PR follow-up review section to state that spec PRs are no longer auto-reviewed and must be reviewed via PR comment mention when needed.
PR feat: sync issue state on plan approval #66: feat: sync issue state on plan approval
requiredplan-approvednow removesready-to-specfrom the linked issue and may dispatch implementation whenready-to-implementand the target agent assignment are already present. Existing product docs mentionedplan-approvedas implementation context, but did not document the new issue state synchronization or conditional dispatch behavior.docs/product/raw/spec-workflow.mddocs/product/raw/implementation-workflow.mdUpdated raw product docs to describe spec plan approval semantics, automatic
ready-to-specremoval, explicitready-to-implementownership, and conditional implementation dispatch after approval.PR feat: add PR bot review command trigger #82: feat: add PR bot review command trigger
required@AGENT_LOGIN /reviewcommand, with non-draft/open PR gating and invalid comment forms skipped. Existing product docs still described bare@AGENT_LOGINPR comment triggering, so authoritative docs needed correction.docs/product/raw/pr-review-verdict.mddocs/product/raw/implementation-workflow.mddocs/product/raw/spec-workflow.mdUpdated raw product docs to document
@AGENT_LOGIN /reviewas the PR conversation comment command for manually requesting AI review, including body-level command constraints and skipped invalid forms.PR fix(review): link comment-triggered runs to PRs #89: fix(review): link comment-triggered runs to PRs
requireddocs/product/raw/pr-review-verdict.mdUpdated the authoritative PR review raw product doc with the commit status lifecycle, target URL association, and scope limits for comment/manual AI PR Review runs.
PR docs(spec): create issue 85 specs #86: docs(spec): create issue 85 specs
not-neededNo docs/product patch needed; existing product docs already describe the delivered PR comment/manual AI PR Review commit status behavior, and the issue 85 dirty-worktree behavior remains spec-only in this PR.
PR feat: allow local review with dirty worktrees #90: feat: allow local review with dirty worktrees
requireddocs/product/raw/pr-review-verdict.mdUpdated the local review entrypoint documentation to describe dirty-worktree support, current-worktree diff semantics, the .local_review_baseline.status file, validation boundaries, and the PR/spec sources.
PR feat(skill): add security review supplements #93: feat(skill): add security review supplements
requireddocs/product/raw/pr-review-verdict.mdUpdated the authoritative PR review product doc to describe security supplemental review behavior, covered concern areas, reporting boundaries, [SECURITY] labeling, and verdict impact.
PR feat(skill): add git worktree helper #94: feat(skill): add git worktree helper
requireddocs/product/raw/local-git-helper-skills.md新增 docs/product/raw/local-git-helper-skills.md，记录 git-worktree 的默认目录、分支命名、base 选择、fetch 行为、dirty worktree 语义、已存在 branch/worktree/path 的停止规则，以及不会自动提交、推送或删除的安全边界。
PR docs(agents): add repository agent guidance #97: docs(agents): add repository agent guidance
not-needed.agents/AGENTS.md，用于约束 AI coding agent 在本仓库内的操作、校验和安全边界。该变更没有改变 AICodingFlow 的长期产品概念、用户流程、workflow 行为、配置语义或公开契约，因此不需要更新docs/product/。无需产品文档补丁；保留现有
docs/product/内容不变。PR fix(review): prefer GitHub PR description locally #103: fix(review): prefer GitHub PR description locally
requireddocs/product/raw/pr-review-verdict.mdUpdated the local review entrypoint documentation to state the pr_description.txt source priority and clarify that pr_diff.txt remains generated from the local worktree diff.
PR docs(skill): enter new worktree by default #105: docs(skill): enter new worktree by default
requiredgit-worktreehelper skill 的长期用户可见行为：成功创建后后续 agent 工作默认进入新 worktree，并新增pwd确认与--no-track创建语义。现有 raw 产品文档已覆盖该 skill，但仍描述旧行为，因此需要同步更新。docs/product/raw/local-git-helper-skills.md更新
docs/product/raw/local-git-helper-skills.md中git-worktree成功创建后的行为说明，记录--no-track、新 worktree 目录中的pwd确认、报告字段以及后续命令默认从新 worktree 运行。PR docs(skill): prefer origin for branch bases #107: docs(skill): prefer origin for branch bases
requireddocs/product/raw/local-git-helper-skills.mdUpdated the local Git helper skills raw product doc to document git-branch behavior, origin-first base selection for same-repository work, no-track remote-base creation, git-worktree remote-base handling, and the distinction between Codex tool-call working directories and the user's shell.
PR docs(skill): optimize git skill workflows #109: docs(skill): optimize git skill workflows
requireddocs/product/raw/local-git-helper-skills.mdUpdated the authoritative local Git helper skills doc for combined local checks, conditional remote/freshness checks, preserved .worktrees/ directory structure, and the git-commit/git-push helper behavior introduced by PR docs(skill): optimize git skill workflows #109.
PR docs(skill): remove cloud workflow guidance #110: docs(skill): remove cloud workflow guidance
not-neededNo product docs patch is needed because the current docs/product content already reflects the merged generic workflow behavior.
PR fix: delay PR comment push credentials #99: fix: delay PR comment push credentials
requiredrespond-to-pr-commentworkflow, which changes long-term PR collaboration behavior, trigger semantics, branch strategy, authorization rules, and handoff contracts. Existing product docs did not contain authoritative coverage for this/fixworkflow and had outdated PR comment routing language.docs/product/raw/pr-comment-response-workflow.mddocs/product/raw/implementation-workflow.mddocs/product/raw/spec-workflow.mdAdded a raw product doc for the PR comment response workflow and updated spec/implementation workflow docs to distinguish
/reviewPR comments from/fixPR comments.PR docs(skill): add CI failure diagnosis skill #112: docs(skill): add CI failure diagnosis skill
requireddocs/product/raw/ci-failure-diagnosis-skill.mdAdded a new authoritative raw product doc describing the CI failure diagnosis skill, including target discovery, log analysis scope, error categorization, plan output, and no-code-change boundary.
PR 新增 resolve-merge-conflicts #114: 新增 resolve-merge-conflicts
requiredresolve-merge-conflicts, with durable workflow behavior, supported conflict types, CLI output modes, and safety boundaries. Existing product docs did not cover this merge-conflict resolution capability.docs/product/raw/merge-conflict-resolution-skill.mdAdded a raw product doc describing when to use the resolve-merge-conflicts skill, what conflict context it exposes, supported output modes, and the local-only resolution and validation boundaries.
PR fix: align local review base selection with PR metadata #116: fix: align local review base selection with PR metadata
requireddocs/product/raw/pr-review-verdict.mdUpdated the authoritative local review documentation to describe PR base SHA precedence, explicit base synchronization, and the new origin/main fallback order.
PR fix: correct CODEOWNERS enforcement note #118: fix: correct CODEOWNERS enforcement note
requireddocs/product/raw/bootstrap-issue-config-skill.md新增 docs/product/raw/bootstrap-issue-config-skill.md，记录 bootstrap issue triage 初始化 skill 的用途、产出文件、label config 结构、CODEOWNERS owner 推断与 branch protection 语义，以及幂等初始化边界。
PR fix: preserve PR title for comment responses #120: fix: preserve PR title for comment responses
requireddocs/product/raw/pr-comment-response-workflow.mdUpdated the authoritative PR comment response workflow doc to state that push-head runs preserve the original PR title/body, still use pr_title and pr_summary for validation and metadata, and include a cleaned summary in the response comment when present.
PR feat(triage): add issue triage workflow #121: feat(triage): add issue triage workflow
requireddocs/product/raw/issue-triage-workflow.mdAdded docs/product/raw/issue-triage-workflow.md covering issue triage triggers, context preparation, triage_result.json contract, label rules, duplicate/follow-up semantics, and GitHub update boundaries.
PR fix(triage): prefetch dedupe candidates #123: fix(triage): prefetch dedupe candidates
requireddocs/product/raw/issue-triage-workflow.mdUpdated the issue triage workflow docs to describe dedupe_candidates.json as the authoritative duplicate-check input, the open plus recent-closed candidate window, pull request exclusion, empty-candidate handling, and the duplicate_of source semantics.
PR docs(skills): remove repo name from descriptions #126: docs(skills): remove repo name from descriptions
not-neededNo product docs patch is needed; the change is a narrow wording cleanup in .agents skill descriptions.
PR ci(review): clarify review output path #127: ci(review): clarify review output path
not-neededNo product docs patch is needed.
PR 新增 SKILL: update-dedupe，用于自进化 dedupe-issue #128: 新增 SKILL: update-dedupe，用于自进化 dedupe-issue
requireddocs/product/raw/dedupe-guidance-companion.mdAdded docs/product/raw/dedupe-guidance-companion.md documenting the dedupe-issue-repo companion, its limits relative to core dedupe-issue behavior, the empty initial Known-duplicate clusters state, and the future update boundary.
PR fix: apply agents implementation output #130: fix: apply agents implementation output
requireddocs/product/raw/implementation-workflow.md更新自动实现 workflow 文档，说明 .agents 文件的 implementation-output 交接路径、intended_files 校验要求、仅允许 .agents/ 前缀以及 implementation-output 不作为提交候选。
PR feat: add update-dedupe guidance workflow #129: feat: add update-dedupe guidance workflow
requiredupdate-dedupeskill and manual workflow, including trigger semantics, evidence requirements, write-surface boundaries, and PR behavior. Existing product docs covered the dedupe companion but did not document this workflow itself.docs/product/raw/update-dedupe-workflow.mdAdded a new raw product doc describing the update-dedupe workflow, strong duplicate evidence requirements, repeated-cluster learning behavior, allowed write surface, and PR behavior.
PR fix(update-dedupe): repair feedback aggregation query #131: fix(update-dedupe): repair feedback aggregation query
not-neededNo product docs patch is needed because the change is an internal script reliability fix and existing long-term docs already describe the stable workflow semantics.
PR test(update-dedupe): cover feedback aggregation safety #132: test(update-dedupe): cover feedback aggregation safety
not-neededNo product docs patch needed because the long-term user-visible workflow contract did not change.
PR docs(triage): add repo triage guidance #133: docs(triage): add repo triage guidance
requireddocs/product/raw/issue-triage-workflow.mddocs/product/raw/pr-comment-response-workflow.mddocs/product/raw/implementation-workflow.mdUpdated authoritative raw product docs for issue triage, PR comment response, and implementation workflows to capture PR docs(triage): add repo triage guidance #133's companion triage rules and stable local context boundaries.
PR fix(triage): allow external issue triage #138: fix(triage): allow external issue triage
requireddocs/product/raw/issue-triage-workflow.md更新 issue triage workflow 的触发条件，记录非 bot issue opened/reopened、needs-info issue 作者 follow-up、bot/automation 与非 created 评论事件排除规则，并补充来源引用。
PR ci(workflows): use GitHub App token for workflow updates #139: ci(workflows): use GitHub App token for workflow updates
required.github/workflows/*时 implementation 与 PR comment response 提交所使用的长期凭据模型。现有 raw product docs 仍描述静态WORKFLOW_UPDATE_TOKENsecret，或缺少 PR comment response 的对应行为，因此需要更新权威产品文档。docs/product/raw/implementation-workflow.mddocs/product/raw/pr-comment-response-workflow.md更新 raw product docs，说明 workflow 根据
intended_files条件性通过actions/create-github-app-token生成 GitHub App installation token，并记录所需的WORKFLOW_UPDATE_APP_CLIENT_IDvariable、WORKFLOW_UPDATE_APP_PRIVATE_KEYsecret、GitHub App 权限，以及不修改 workflow 文件时继续使用默认写入凭据。PR fix(workflows): authenticate PR diff fetch #140: fix(workflows): authenticate PR diff fetch
not-neededNo product docs patch is needed.
PR private repo 会出现 author_association 判定失败 #142: private repo 会出现 author_association 判定失败
requireddocs/product/raw/pr-comment-response-workflow.mdUpdated the PR comment response workflow raw product doc to describe the private-repository CONTRIBUTOR permission fallback, the remaining rejection cases, and the new context fields for base repo privacy and repository permission.
PR fix(workflows): avoid token in fetch arguments #143: fix(workflows): avoid token in fetch arguments
not-neededNo product docs patch is needed.
PR Rename GitHub App workflow config vars #145: Rename GitHub App workflow config vars
requireddocs/product/raw/implementation-workflow.mddocs/product/raw/pr-comment-response-workflow.md更新两个 raw product docs 中的 GitHub App Actions variable/secret 名称，并在来源列表补充 PR Rename GitHub App workflow config vars #145 与 Issue 修改 Github 变量名称 #144。
PR feat: add project installer #148: feat: add project installer
requireddocs/product/raw/project-installer.mdAdded docs/product/raw/project-installer.md documenting the installer entrypoints, sync scope, repo-local companion preservation, .github preservation behavior, dry-run behavior, and optional bootstrap-issue-config follow-up.
PR fix(pr-comments): handle multi-comment fix requests #150: fix(pr-comments): handle multi-comment fix requests
requireddocs/product/raw/pr-comment-response-workflow.mdUpdated the PR comment response workflow source doc to describe review_comment_ids.json resolved/outdated thread state, multi-inline-comment request handling, unresolved-state rules, outdated-comment handling, and one resolved_review_comments entry per resolved inline comment.
This PR may accumulate multiple product docs sync decisions until it is reviewed and merged.