12 Commits
Author SHA1 Message Date
Bohdan Triapitsyn 22d8b61912 docs(triage): pr-reviewer takes one or several PRs; batch size is the caller's call 2026-08-29 14:54:32 +03:00
Bohdan Triapitsyn f2bd88a245 docs(triage): pr-reviewer takes a batch of PRs per call 2026-08-29 14:53:16 +03:00
Bohdan Triapitsyn 50159d3747 docs(triage): waiting-on-author bucket, read reviews not only comments, deliberate-behavior premise check 2026-08-29 11:15:02 +03:00
Bohdan Triapitsyn 736586f802 docs(triage-prs): the report carries each ready action verbatim, never paraphrased 2026-08-29 02:31:25 +03:00
Bohdan Triapitsyn 71653d287b feat(agents): add the pr-reviewer subagent; triage fans out through it 2026-08-29 02:18:56 +03:00
Bohdan Triapitsyn b5fed6e2e2 docs(agents): VS Code reachability gates changelog entries; yulia-ivashko carries maintainer weight
- changelog-authoring: a VS Code entry requires the surface to be
  mounted from the VS Code entrypoint (consult the surface map in
  packages/vscode/src/DOCUMENTATION.md when present); shared-but-unmounted
  code earns no entry
- triage-prs: yulia-ivashko is a core maintainer with merge rights —
  her review decisions carry maintainer weight in sweeps
2026-08-28 16:30:55 +03:00
Bohdan Triapitsyn 5faa1a6531 docs(agents): needs-your-hands is binary — a merge gate or nothing
Either the manual check guards an irreversible path and the verdict
reads 'MERGE — after you verify X', or the verdict is a plain MERGE
with no checklist: residual cosmetic risk is absorbed by the verdict
(users surface it, a revert costs one commit). Post-merge homework
lists were the reviewer offloading uncertainty onto the maintainer.
2026-08-28 15:32:07 +03:00
Bohdan Triapitsyn 779cf19ae6 docs(agents): pickup mode, clickable references, and calibrated report detail
- PRs/issues with human thread activity run in pickup mode across all
  three skills: the output opens with thread state (asked / answered /
  resolved at HEAD / remaining) and continues the conversation instead
  of restarting review — the sweep remembers the maintainer's own
  comments for them
- every PR/issue reference in maintainer-facing output is a clickable
  markdown link, never a bare number
- report entries are calibrated: 2-4 sentences each (what, why this
  verdict, main risk), needs-your-hands lives inside the entry rather
  than a number-repeating section
2026-08-28 15:24:17 +03:00
Bohdan Triapitsyn 1760347dc7 docs(agents): prior maintainer verdicts are binding across triage sweeps
A sweep verifies whether an earlier push-back or recorded product
decision was addressed at the current HEAD and reports that explicitly;
it never re-decides or re-asks. The generic rebase-request is never
posted over an existing substantive review comment.
2026-08-28 14:12:35 +03:00
Bohdan Triapitsyn 9d279137ce docs(agents): weigh trusted community reviewers in triage sweeps
Comments and reviews from patrick-motard and mattv8 are strong human
signals during batch triage: their approval upgrades confidence, their
concerns become findings to verify. They write free-form; sweeps map
their conclusions onto the verdict ladder.
2026-08-28 11:49:45 +03:00
Bohdan Triapitsyn aff407288d ci: re-enable pr-review bot on glm-5.3-flash with recalibrated output contract
Re-enable the automated PR review (pull_request_target + /oc-review
comments) on zai-coding-plan/glm-5.3-flash via ZHIPU_API_KEY.

Recalibrate the output contract based on an audit of 69 past reviews
(22 PRs, Aug 15-18): 18 of 27 BLOCKED verdicts were template-policing,
3.1 reviews per PR, ~8.4K chars per comment.

- BLOCKED now means code/merge problems only; handoff/template gaps move
  to a separate one-line Handoff flag that never changes the verdict
- re-reviews emit deltas (verdict + what changed) instead of full
  re-emission; push-triggered re-reviews are throttled to one per 15
  minutes (manual /oc-review always runs)
- hard length budgets by change class; the applied-guidance table is
  gone (guidance is applied silently, named only when it produced a
  finding); empty evidence/security sections are omitted
- evidence demands are single-shot and escapable, never raised for
  dependency bumps, string edits, server code, or packaging
- the comment opens with a one-line maintainer verdict (merge / merge
  after X / don't merge because Y), enforced by the workflow
- triage-prs skill treats review:* labels as a pre-sort for verdict
  reviews
2026-08-28 11:24:23 +03:00
Bohdan Triapitsyn a79aff45c1 docs(agents): add pr-review and triage-prs skills, always-on communication guidance
- pr-review: maintainer-proxy verdict review (decline / push-back /
  merge-then-fix / merge) with ready-to-post actions, product-fit
  escalation, ache salvage on declines, and merge-base diff measurement
- triage-prs: batch queue triage pipeline (mechanical sweep, duplicate
  clusters, fan-out verdict reviews, approved batch actions) with
  canonical message templates
- AGENTS.md: new Communication section replaces the always-load
  communication-style mandate; the skill keeps a trigger-based
  description for editing human-facing text
- register all project skills in .claude/skills (only 6 of 17 were
  linked, leaving most skills undiscoverable)
2026-08-28 02:07:57 +03:00