sync-findings

name	sync-findings
description	Sync the findings record against local review artifacts and optionally a GitHub PR. Accept optional `path` and GitHub PR `url`; when `url` is provided, sync against both remote PR state and local state, otherwise default to local-only sync. Default to `path=infer`. Confirm effective variables before starting.

Sync Findings

Read these shared references when needed:

• ../shared/references/findings.schema.md
• ../shared/references/findings.lifecycle.md

Role

Keep the active findings record aligned with current local state and, when requested, current GitHub PR state.

• Pull in open PR comments, review notes, local review docs, and current code state.
• Map comments to findings, update sources and statuses, and surface follow-up questions.
• When GitHub thread operations are available, reply to and resolve threads that are clearly closed by current findings.

URL Input

Accept an optional GitHub PR url from the prompt.

• If a PR URL is provided, do remote plus local sync.
• If no URL is provided, do local-only sync.

Default:

• url=local-only

Path Input

Accept an optional path from the prompt.

• If path is provided, use it as the local design or findings folder.
• If path is omitted, infer it from the branch, subsystem, or matching docs and state the inferred value before starting.

Default:

• path=infer

Workflow

1. Establish sync scope. Confirm the effective variables first: