From 64302cf81ceb298a977d0b9f67c0e88c7f66a6a0 Mon Sep 17 00:00:00 2001 From: Eric Litman Date: Wed, 21 Oct 2026 18:17:07 -0400 Subject: [PATCH] MASTRA-1135: keep this repository's run-these and babysit-pr steps in .agents/ Co-Authored-By: Claude Opus 5.5 --- .agents/babysit-pr.md | 17 +++++++++++ .agents/run-these.md | 29 +++++++++++++++++++ .../verify-open-pstack/features/registry.json | 1 + 3 files changed, 47 insertions(+) create mode 100644 .agents/babysit-pr.md create mode 100644 .agents/run-these.md diff --git a/.agents/babysit-pr.md b/.agents/babysit-pr.md new file mode 100644 index 00000000..490aed6f --- /dev/null +++ b/.agents/babysit-pr.md @@ -0,0 +1,17 @@ +# babysit-pr in this repository + +## Checks + +```json +{ + "workflows": [ + { + "name": "CI", + "checks": ["verify"], + "rerunOn": ["failure", "cancelled", "timed_out", "action_required"] + } + ] +} +``` + +`live-gate` is a commit status that the `verify-open-pstack` skill publishes on each head; no workflow reruns it. diff --git a/.agents/run-these.md b/.agents/run-these.md new file mode 100644 index 00000000..8d8db532 --- /dev/null +++ b/.agents/run-these.md @@ -0,0 +1,29 @@ +# run-these in this repository + +## Setup + +Nothing beyond `AGENTS.md`. The package scripts install their own dependencies. + +## Gate + +`AGENTS.md` names the four checks to run before opening a pull request. From the repository root: `bun run test`, `bun run typecheck`, `bun run static` and `claude plugin validate plugins/pstack`. + +## Live proof + +`AGENTS.md`: every head needs its own `live-gate` commit status from the `verify-open-pstack` skill, whose rule picks the features. A docs-only path still needs a registry entry in that skill's `features/registry.json`, because an unmapped path fails closed. + +## Review and merge + +`AGENTS.md`: this repository lands on green once `verify` and `live-gate` pass and no review thread is unresolved. Mergify reads no `hold` label here; keep a pull request a draft to stop it landing. `.github/workflows/unfret-threads.yml` resolves Unfret's threads. Before posting `live-gate`, read the other reviewers' threads with `watch-pr --status-only`, then fix or answer each one and resolve it. + +## Deploy or release + +`AGENTS.md`: once every pull request merged since the previous release has an Unfret verdict on its merged head and each material finding has a merged fix-forward pull request, run `python3 scripts/release.py publish` from a clean checkout of `main`. Cut the release whenever merged changes are user-facing. + +## Ticket states after merge + +Work is tracked in this repository's GitHub Issues. The live proof comes before the merge here, so a merged pull request closes its issue. Confirm that each merged pull request closed its issue, or that its body says why it did not. + +## Closeout + +Records go in `~/projects/docs/projects/open-pstack/records/-batch-/`. diff --git a/.claude/skills/verify-open-pstack/features/registry.json b/.claude/skills/verify-open-pstack/features/registry.json index dcacfbfd..df303783 100644 --- a/.claude/skills/verify-open-pstack/features/registry.json +++ b/.claude/skills/verify-open-pstack/features/registry.json @@ -79,6 +79,7 @@ "nonRuntime": [ "README.md", "REVIEW.md", "CHANGES.md", "LICENSE", "LICENSE.md", "UPSTREAM.md", "NOTICE.md", "README-UPSTREAM.md", "LICENSE-cursor-team-kit", "LICENSE-superpowers", + ".agents/run-these.md", ".agents/babysit-pr.md", ".gitignore", ".mergify.yml", ".github/workflows/unfret-threads.yml", "docs/**", "assets/**", "plugins/pstack/skills/poteto-mode/scripts/bootstrap.test.ts", "plugins/pstack/skills/poteto-mode/scripts/check-plan.test.ts",