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: append product docs sync PR comments #217 changed the long-term Product Docs Sync workflow behavior: every create or update of the docs sync PR now appends a per-run PR comment with the current decision details. Existing product docs described the fixed-branch PR body and ledger behavior but did not cover the new conversation comment record.
change summary:
Updated the Product Docs Sync workflow raw product doc to describe appended per-run PR comments on the docs sync PR, including fields, uncertain confirmation visibility, and the rule that old bot comments are not edited.
reason: PR Compile product wiki #222 only compiled the generated docs/product/wiki knowledge layer from existing docs/product/raw sources. It did not introduce new product behavior, and the authoritative raw product docs already include the relevant source documents.
reason: PR Compile product wiki #226 只是将现有 docs/product/raw/ 内容重新编译为 docs/product/wiki/ 知识层，没有引入新的权威产品行为、workflow、配置语义或公开契约。变更属于派生 wiki 内容同步，长期产品事实仍已由现有 raw 文档覆盖。
reason: PR fix(review): suppress repeated bot review comments #227 changes long-term AI PR Review behavior by adding prior review discussion snapshots and duplicate suppression for resolved, maintainer-dismissed, and still-unresolved bot inline comments. Existing product docs covered review workflow behavior but did not document this discussion context or its instruction-safety boundary.
reason: PR fix(review): 使用 GitHub PR diff 快照 #231 changed the authoritative PR diff snapshot behavior for GitHub-hosted review and /fix workflows from a local base/head git diff to the GitHub PR diff API with before-and-after SHA validation. This is long-term workflow and public failure-semantics knowledge that was not explicitly covered by the existing product docs.
change summary:
Document that GitHub workflow PR diff snapshots for AI PR Review and /fix now come from the GitHub PR diff API, and that the workflows fail if the PR head or base SHA changes while preparing the diff.
reason: PR Compile product wiki #234 only compiled existing authoritative docs/product/raw/ content into docs/product/wiki/. It did not change implementation behavior, specs, raw product docs, or any long-term product rule that is not already represented by the existing product documentation.
reason: PR Compile product wiki #238 only updates compiled Product LLM Wiki pages under docs/product/wiki/ from existing docs/product/raw/ sources. The authoritative long-term product facts are already covered by raw docs, so no additional product docs patch is warranted.
reason: PR refactor(workflows): extract shared script helpers #245 is a workflow script refactor that extracts shared helper modules and moves existing context, GitHub API, ledger, metadata, and artifact I/O logic behind reusable Python helpers. The merged diff does not introduce a new product workflow, lifecycle, permission model, configuration contract, or user-visible behavior that is not already covered by the existing product docs sync workflow documentation.
reason: PR refactor(review): extract shared review contracts #246 changed long-term AI PR Review behavior by introducing a shared review contract and moving local review snapshots/output to system temporary-directory paths. Existing authoritative raw product docs still described repo-root local snapshots and did not document .agents/contracts/ as a shared workflow/skill contract area.
reason: PR Compile product wiki #248 only updated the generated Product LLM Wiki compile log under docs/product/wiki/log.md. It did not change authoritative raw product knowledge, specs, workflows, permissions, lifecycle rules, APIs, configuration semantics, or user-visible product behavior.
change summary:
No product docs patch is needed; the change is a generated wiki compile log entry and belongs outside authoritative long-term product docs.
reason: PR Update PR review guidance #250 merged durable repo-local AI PR Review guidance that changes how reviews interpret intra-PR path changes, product wiki/raw source support, and issue-number reference validation. Existing product docs described the companion guidance mechanism but did not capture these current review behavior rules.
change summary:
Updated the authoritative PR review product doc with the newly merged repo-local review guidance and added PR Update PR review guidance #250 to the source references.
reason: PR refactor(install): skip upstream tests by default #253 changed the project installer sync boundary by excluding .github/aicodingflow-tests/ from default target-repository installs. The merged PR already updated the authoritative product documentation to describe the current default sync scope and the upstream-test-directory boundary.
change summary:
No additional product docs patch is needed because docs/product/raw/project-installer.md already records that .github/aicodingflow-tests/ is an upstream-managed test directory and is not installed by default.
reason: PR Compile product wiki #255 only recompiles derived files under docs/product/wiki/ from existing docs/product/raw/ sources. It does not introduce or change authoritative product behavior, workflow contracts, configuration semantics, or public user-facing rules that require a raw product docs update.
reason: PR Update PR review guidance #250 merged durable repo-local AI PR Review guidance that changes how reviews interpret intra-PR path changes, product wiki/raw source support, and issue-number reference validation. Existing product docs described the companion guidance mechanism but did not capture these current review behavior rules.
Patch summary:
Updated the authoritative PR review product doc with the newly merged repo-local review guidance and added PR #250 to the source references.
reason: PR refactor(install): skip upstream tests by default #253 changed the project installer sync boundary by excluding .github/aicodingflow-tests/ from default target-repository installs. The merged PR already updated the authoritative product documentation to describe the current default sync scope and the upstream-test-directory boundary.
Patch summary:
No additional product docs patch is needed because docs/product/raw/project-installer.md already records that .github/aicodingflow-tests/ is an upstream-managed test directory and is not installed by default.
reason: PR Compile product wiki #255 only recompiles derived files under docs/product/wiki/ from existing docs/product/raw/ sources. It does not introduce or change authoritative product behavior, workflow contracts, configuration semantics, or public user-facing rules that require a raw product docs update.
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/update-triage-workflow.mdSource context:
Patch summary:
新增 docs/product/raw/update-triage-workflow.md，记录 update-triage 的触发输入、维护者修正信号学习规则、允许写入范围和固定 PR 行为。
Processed decisions in this PR:
Omitted 94 older processed decisions to keep the PR body within GitHub limits.
PR Compile product wiki #213: Compile product wiki
not-neededdocs/product/raw/到docs/product/wiki/，变更范围是派生 wiki 页面和编译日志。现有产品文档已声明docs/product/raw/是权威来源，且本次没有 raw 文档、spec、产品代码或 workflow 行为变更。无需产品文档补丁；不修改
docs/product/。PR fix: 跳过 product docs sync 中缺失的 issue 引用 #215: fix: 跳过 product docs sync 中缺失的 issue 引用
requireddocs/product/raw/product-docs-sync-workflow.md更新 Product Docs Sync workflow 权威文档，说明 unreadable linked issue 会被跳过，linked_issues 和相关 specs 只包含成功读取的 issue，且该情况不会让可处理的 merged PR 变为 should_run=false。
PR fix: append product docs sync PR comments #217: fix: append product docs sync PR comments
requireddocs/product/raw/product-docs-sync-workflow.mdUpdated the Product Docs Sync workflow raw product doc to describe appended per-run PR comments on the docs sync PR, including fields, uncertain confirmation visibility, and the rule that old bot comments are not edited.
PR Compile product wiki #222: Compile product wiki
not-neededNo docs/product changes are needed.
PR Compile product wiki #226: Compile product wiki
not-needed无需修改 docs/product/；本次只记录 not-needed 决策。
PR fix(review): suppress repeated bot review comments #227: fix(review): suppress repeated bot review comments
requireddocs/product/raw/pr-review-verdict.mdUpdated docs/product/raw/pr-review-verdict.md to document review_discussion_context.json generation, duplicate-suppression rules, maintainer dismissal handling, unresolved-thread handling, and REVIEW_BOT_LOGIN source attribution.
PR 修复 review dismiss 误判和换行输出 #228: 修复 review dismiss 误判和换行输出
requireddocs/product/raw/pr-review-verdict.md更新 docs/product/raw/pr-review-verdict.md，补充 maintainer dismissal 的肯定语义要求、否定或疑问 intentional 回复的处理方式，以及 GitHub review 发布前对 markdown body/comment 中字面量 \n 的换行规范化规则。
PR fix(review): 使用 GitHub PR diff 快照 #231: fix(review): 使用 GitHub PR diff 快照
requireddocs/product/raw/pr-review-verdict.mddocs/product/raw/pr-comment-response-workflow.mdDocument that GitHub workflow PR diff snapshots for AI PR Review and /fix now come from the GitHub PR diff API, and that the workflows fail if the PR head or base SHA changes while preparing the diff.
PR Compile product wiki #234: Compile product wiki
not-neededNo product docs patch is needed because the merged PR updated only the generated wiki query layer from existing raw sources.
PR Compile product wiki #238: Compile product wiki
not-neededNo docs/product changes needed; the merged PR is a compiled wiki refresh from existing authoritative raw product docs.
PR Compile product wiki #242: Compile product wiki
not-needed无需文档补丁；现有 raw product docs 仍是权威来源，本次合并只是基于这些来源更新派生 wiki。
PR refactor(workflows): extract shared script helpers #245: refactor(workflows): extract shared script helpers
not-neededNo product docs patch is needed because the change is internal workflow script structure and regression coverage only.
PR refactor(review): extract shared review contracts #246: refactor(review): extract shared review contracts
required.agents/contracts/as a shared workflow/skill contract area.docs/product/raw/agent-directory-layout.mddocs/product/raw/pr-review-verdict.mdUpdated authoritative raw product docs to describe
.agents/contracts/, shared review contract/schema ownership, core review entrypoints with repo companion guidance, and temporary-directory local review snapshot/output paths.PR Compile product wiki #248: Compile product wiki
not-neededNo product docs patch is needed; the change is a generated wiki compile log entry and belongs outside authoritative long-term product docs.
PR refactor(workflows): move handoff files to temp dir #247: refactor(workflows): move handoff files to temp dir
not-needed无需补丁；合并 PR 已包含并落地所需的 docs/product/raw 更新。
PR fix: validate product report spec links #249: fix: validate product report spec links
requireddocs/product/raw/product-change-reports.md更新 docs/product/raw/product-change-reports.md 的来源引用和校验行为章节，补充 spec source reference 的合法链接格式、非法目标类型和状态校验拒绝规则。
PR Update PR review guidance #250: Update PR review guidance
requireddocs/product/raw/pr-review-verdict.mdUpdated the authoritative PR review product doc with the newly merged repo-local review guidance and added PR Update PR review guidance #250 to the source references.
PR refactor(install): skip upstream tests by default #253: refactor(install): skip upstream tests by default
not-needed.github/aicodingflow-tests/from default target-repository installs. The merged PR already updated the authoritative product documentation to describe the current default sync scope and the upstream-test-directory boundary.docs/product/raw/project-installer.mdNo additional product docs patch is needed because
docs/product/raw/project-installer.mdalready records that.github/aicodingflow-tests/is an upstream-managed test directory and is not installed by default.PR Compile product wiki #255: Compile product wiki
not-neededNo product docs patch is needed; the PR updates generated wiki summaries and concepts from existing authoritative raw sources.
PR feat: 新增 update-triage 自进化流程 #254: feat: 新增 update-triage 自进化流程
requireddocs/product/raw/update-triage-workflow.md新增 docs/product/raw/update-triage-workflow.md，记录 update-triage 的触发输入、维护者修正信号学习规则、允许写入范围和固定 PR 行为。
This PR may accumulate multiple product docs sync decisions until it is reviewed and merged.