Reusable prompt contracts, review gates, and maintenance workflows for running coding agents on real repositories without losing source-of-truth discipline.
If you maintain software with coding agents in the loop, this kit gives you copyable operating patterns for the work that usually breaks trust: ambiguous task intake, issue and PR triage, delegated implementation, release readiness, and public/private context screening.
This repository is intentionally small. It packages worked-through operator patterns into files that other maintainers can copy into their own repos:
AGENTS.mdprompt intake contract for ambiguous or dictated tasks- conversation capture receipts for rough chat, voice notes, and inbox dumps
- maintainer triage skill for evidence-first issue and PR review
- milestone review skill for substantial implementation work
- application packet template for programs that evaluate OSS maintainer signal
- validation and publication-risk scripts that check for broken placeholders, missing sections, and private-context leaks
- public examples for issue triage, PR review, and release-readiness gates
| Maintainer problem | Use this | Outcome |
|---|---|---|
| Rough user input turns into the wrong task | templates/AGENTS.md and conversation-capture-receipts |
A clear receipt before writes happen |
| Agent work passes local checks but misses the real risk | milestone-review and completion critic gates |
A second pass against false-positive completion |
| Private workflow knowledge needs to become public OSS material | docs/publication-risk.md and scripts/check-publication-risk.sh |
Sanitized examples without private paths, hostnames, or secrets |
| A maintainer wants to try the kit quickly | scripts/install-skills.sh and docs/quick-demo.md |
A dry-run and temp install path before touching an existing setup |
Codex Operator Kit was published on 2026-06-01 as a public OSS workspace for Codex operator workflows. It is intentionally compact: copyable contracts, skills, examples, and validation checks that can be reused by maintainers.
This kit is for maintainers who use coding agents to:
- triage issues and pull requests without skipping evidence
- delegate bounded subtasks to subagents
- run adversarial completion checks before claiming work is done
- keep user-facing summaries separate from machine artifacts
- avoid false-pass paths during deployment, cleanup, and trust-sensitive changes
Copy the contract into a repository:
cp templates/AGENTS.md AGENTS.mdTry the maintainer demo in docs/quick-demo.md first if you want a temporary install path.
Copy one or more skills into your local Codex skills directory when you are ready to use them in your setup:
bash scripts/install-skills.sh --dry-run
bash scripts/install-skills.shValidate this repository:
bash scripts/validate.shRun the publication-risk scanner directly:
bash scripts/check-publication-risk.shtemplates/AGENTS.md- compact global intake and completion-review contractskills/conversation-capture-receipts/SKILL.md- no-write receipt workflow for messy human inputskills/oss-maintainer-triage/SKILL.md- issue, PR, and bounty-style evidence triageskills/milestone-review/SKILL.md- milestone and adversarial completion review workflowdocs/maintenance-model.md- the operating model behind the kitdocs/install-and-use.md- installer and adoption guidedocs/quick-demo.md- short maintainer demo pathdocs/workflows.md- copyable maintainer workflowsdocs/publication-risk.md- how to screen workflow packs before publishingexamples/- sanitized example packets and receiptsdocs/codex-for-oss-application.md- application packet and field-ready answersscripts/validate.sh- local validation checksscripts/install-skills.sh- install all or selected skills into a Codex skills directoryscripts/check-publication-risk.sh- conservative private-context leak scanner
The project is maintained as a practical operator kit rather than a framework. New additions should be small, copyable, and tied to a maintenance workflow that has been used in real work.
MIT. See LICENSE.