chore(aiwg): add T3MP3ST maintainer addon

2026-07-15 16:43:49 -04:00
1 parent ae32cf5051
commit 400e9e6d24
@@ -0,0 +1,86 @@
+---
+namespace: t3mp3st-maintainer
+name: t3mp3st-merge-train
+platforms: [all]
+description: Run a conservative T3MP3ST maintainer merge train, merging validated PRs one at a time and reconciling issues after each merge.
+triggers:
+  - t3mp3st merge train
+  - merge T3MP3ST PRs
+  - start T3MP3ST merge session
+  - maintainer merge queue
+requires:
+  - merge-candidates: one or more PR numbers, or a queue-audit ready list
+  - github-maintainer-access: permission to merge elder-plinius/T3MP3ST PRs
+ensures:
+  - one-at-a-time: only one PR is merged before rechecking queue state
+  - ci-green: each merged PR has green required checks or explicit maintainer override
+  - issue-reconciliation: linked issues are checked after merge
+  - post-merge-reaudit: queue state is refreshed after every merge
+commandHint:
+  argumentHint: "<pr...> [--method squash|merge|rebase] [--dry-run] [--stop-on-conflict]"
+  allowedTools: Bash, Read
+  model: sonnet
+  category: release-management
+---
+
+# T3MP3ST Merge Train
+
+Use this after `t3mp3st-queue-audit` identifies ready PRs.
+
+## Merge Policy
+
+Default merge method: squash, unless the PR contains a meaningful multi-commit
+history that should be preserved.
+
+Never merge:
+
+- `CHANGES_REQUESTED`
+- `DIRTY` or conflicted
+- failing required checks
+- head SHA changed since audit
+- security-sensitive code without current verification
+
+## Batch Ordering
+
+1. Documentation and process PRs.
+2. Small bug fixes with issue closures.
+3. Provider/local-model fixes.
+4. UI/backend contract fixes.
+5. Larger features after main is stable.
+
+## Per-PR Steps
+
+1. Re-read current PR state:
+   - `gh pr view <N> --json headRefOid,mergeStateStatus,reviewDecision,statusCheckRollup`
+2. Compare head SHA to the audited SHA.
+3. Confirm checks are green.
+4. Confirm no unresolved requested changes.
+5. Merge exactly one PR.
+6. Wait for main/CI state if checks run after merge.
+7. Re-check linked issues:
+   - if auto-closed, record it;
+   - if still open, comment or close only with clear evidence.
+8. Refresh open PR queue before the next merge.
+
+## Output
+
+```markdown
+## Merge Train
+
+Merged:
+- #N `<sha>` — method: squash — checks: pass — issues: #M closed
+
+Stopped before:
+- #X — reason
+
+Next recommended PR:
+- #Y — reason
+```
+
+## Stop Conditions
+
+- Merge conflict appears.
+- CI fails.
+- A previously clean PR becomes stale after a merge.
+- Any linked issue shows new human feedback.
+- Local checkout or GitHub state is ambiguous.