Skip to content

docs(skills): define two-layer PR verification - #3548

Merged
benjaminshafii merged 1 commit into
devfrom
docs/agent-first-verification
Aug 5, 2026
Merged

docs(skills): define two-layer PR verification#3548
benjaminshafii merged 1 commit into
devfrom
docs/agent-first-verification

Conversation

@benjaminshafii

Copy link
Copy Markdown
Member

What

  • Add the orchestrator-facing prove-a-pr skill for landable-tree, stacked-PR, control-run, prerequisite, verdict, and publication checks.
  • Rewrite the authoring, execution, diagnosis, and publication skills around agent-first verdicts and human-auditable tapes.
  • Name both layers in AGENTS.md and point deprecated/overlapping skills at the new contract without deleting or rewriting their compatibility guidance.

Why

Make one concise verification path explicit: machines decide the verdict from observable assertions; humans audit the accumulated tape on the PR.

This PR documents the contract implemented in #3546 (feat/evidence-multi-tape), expected to land before or with this PR: per-spec sticky-comment accumulation, chronological --all publication for PR-head tapes, stale-roll skip reasons, and annotated deliberate forced publication.

Validation

  • git diff --check origin/dev...HEAD — passed.
  • pnpm evals:spec specs/testkit-evidence.test.ts — 1 file passed, 2 tests passed; command-syntax sanity check only.
  • Docs and inert agent config; no runtime evidence applies.

Skill summary

Action Skills
Added prove-a-pr
Rewritten write-a-spec, run-tests, diagnose-a-red-run, publish-evidence
Pointed at fraimz, run-evals, daytona-flow-validator, daytona-recording-artifacts

@vercel

vercel Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
openwork-app Ready Ready Preview Aug 5, 2026 7:00am
openwork-den Ready Ready Preview Aug 5, 2026 7:00am
openwork-den-worker-proxy Ready Ready Preview Aug 5, 2026 7:00am
openwork-diagnostics Ready Ready Preview Aug 5, 2026 7:00am
openwork-landing Ready Ready Preview, v0 Aug 5, 2026 7:00am

@diff-warden diff-warden Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Warden security clearance: clear. No new security issues found in this diff (7af3e9b6f2712a271ed766bcd6aa5c6a648be4d1). Automated clearance satisfies the required-review gate only — a human still reviews and merges. Analysis run

@benjaminshafii
benjaminshafii merged commit 776a064 into dev Aug 5, 2026
19 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant