Codex Operator Kit

Reusable prompt contracts, review gates, and maintenance workflows for running coding agents on real repositories without losing source-of-truth discipline.

This repository is intentionally small. It packages field-tested operator patterns into files that other maintainers can copy into their own repos:

• AGENTS.md prompt intake contract for ambiguous or dictated tasks
• 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 script that checks the pack for broken placeholders and missing sections
• public examples for issue triage, PR review, and release-readiness gates

Current Status

This repository was originally created through a GitHub Skills exercise. On 2026-06-01 it was repurposed into a public OSS workspace for Codex operator workflows. The relevant project history starts with the v0.1 operator-kit files.

Who This Is For

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

Quick Start

Copy the contract into a repository:

cp templates/AGENTS.md AGENTS.md

Copy one or more skills into your local Codex skills directory:

mkdir -p ~/.codex/skills
cp -R skills/* ~/.codex/skills/

Validate this repository:

bash scripts/validate.sh

Repository Map

• templates/AGENTS.md - compact global intake and completion-review contract
• skills/oss-maintainer-triage/SKILL.md - issue, PR, and bounty-style evidence triage
• skills/milestone-review/SKILL.md - milestone and adversarial completion review workflow
• docs/maintenance-model.md - the operating model behind the kit
• docs/workflows.md - copyable maintainer workflows
• examples/ - sanitized example packets
• docs/codex-for-oss-application.md - application packet and field-ready answers
• scripts/validate.sh - local validation checks

Maintenance Posture

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.

License

MIT. See LICENSE.