10 Commits
Author SHA1 Message Date
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 eead353326 docs(pr-review): unverifiable is not verified; author-named gaps always land on a list 2026-08-29 02:13:42 +03:00
Bohdan Triapitsyn 8d80224a1e docs(pr-review): decide PUSH-BACK vs MERGE-THEN-FIX by who owns the residue, not its size 2026-08-29 01:25:58 +03:00
Bohdan Triapitsyn 6cd318ddf3 docs(pr-review): a fix earns MERGE only when the symptom's path is shown to be closed 2026-08-29 01:22:38 +03:00
Bohdan Triapitsyn 30f635c7ed docs(agents): reachability is proven from the runtime entrypoint
A shared component importing a runtime API proves nothing about that
runtime; the runtime's own entrypoint must mount the path. Trace
top-down before claiming a bug or fix is user-visible in a runtime —
VS Code's layout mounts only a subset of the shared surfaces and bites
reviews constantly.
2026-08-28 16:24:06 +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 8b27bd6791 docs(agents): split needs-your-hands into merge gates and post-merge smoke
A manual check either guards an irreversible path (data loss, upgrade
and restart flows, auth) and gates the merge, or it is low-risk visual
polish where merging first is fine and skipping the check is stated as
accepted risk — never a ritual list padded to feel thorough.
2026-08-28 15:28:14 +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 f826f41f55 docs(agents): detect silently-fixed issues and link fixes to issues at merge
triage-issues gains a silently-fixed detection ladder, strongest
evidence first: mechanism-anchor (git log -L on the root-cause:found
file:line since the issue date), repro re-run against current main, and
symptom search over commits/CHANGELOG/merged PR titles. CLOSE-FIXED
always names its evidence; an unverified hunch only asks the reporter
to retry.

pr-review's merge verdicts now search open issues for the symptom a bug
fix resolves and propose Closes #N, so fixes stop landing unlinked.
2026-08-28 13:06:22 +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