Home / phelan164 / codex-howto · AGENTS.md · GitHub

AGENTS.md agentsA

AGENTS.md is agent-read markdown (agents) from phelan164/codex-howto.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Repository guidance

## Purpose

Maintain an accurate, engineering-first learning guide for OpenAI Codex.

## Editing rules

- Keep product behavior aligned with official OpenAI documentation.
- Label community practices and opinions clearly.
- Do not add credentials, destructive examples, or full-access defaults.
- Keep modules progressive: outcome, concepts, exercise, verification, sources.
- Keep skill bodies concise; put optional detail in direct `references/`.
- Preserve attribution to `luongnv89/claude-howto` as inspiration.
- For work that depends on prior decisions, experiments, or established Codex
  guidance, read `knowledge/index.md` first and load only relevant pages.
- Treat wiki queries as read-only unless the user explicitly requests capture,
  ingest, archive, or promotion.

## Pull requests

This personal open-source repository does not require Jira tickets. Use a
descriptive branch and PR title; link relevant GitHub issues when applicable.

## Validation

Run:

```bash
python3 scripts/validate_repo.py
python3 skills/maintain-codex-wiki/scripts/wiki_lint.py .
```

For each changed skill, also run:

```bash
…

Read the whole file at its exact version.

How to install

Latest version
mdr add phelan164/codex-howto/AGENTS.md@git:20260915.dd80dad
Exact content
mdr add phelan164/codex-howto/AGENTS.md@sha256:e8c8bd7f2408c5e4

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7onkzvjpbh4graao.svg)](https://markdownregistry.com/a/art_7onkzvjpbh4graao)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260915.dd80dad latest2026-09-15 dd80dad 1,545 BA view · diff
git:20260731.5a7d3b32026-07-31 5a7d3b3 1,374 BA view · diff
git:20260731.d3e80132026-07-31 d3e8013 1,110 BA view · diff
git:20260724.a8a71482026-07-24 a8a7148 979 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (1545 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

phelan164/codex-howto · 9 stars · license MIT · pushed 2026-09-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7onkzvjpbh4graao
GET https://markdownregistry.com/api/v1/resolve?ref=phelan164/codex-howto/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/e8c8bd7f2408c5e4deb7238e493ada39997d0338bb39a2a1c1f2c699ebcd64d3

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from phelan164/codex-howto

AGENTS.md@examples agents
phelan164/codex-howto · examples/AGENTS.md
git:20260724.a8a7148 · audit A · 9 stars
evidence-review skill
phelan164/codex-howto · examples/plugin-marketplace/plugins/engineering-review/skills/evidence-review/SKILL.md · Review a small code or documentation change and return only evidence-backed correctness findings. Use in the Codex How…
git:20260724.a8a7148 · audit A · 9 stars
choose-engineering-flow skill
phelan164/codex-howto · examples/skills/choose-engineering-flow/SKILL.md · Select the smallest useful Codex engineering workflow from this repository's existing skills. Use when a task spans…
git:20260731.42e092c · audit A · 9 stars
AGENTS.md@labs/2048-game-benchmark agents
phelan164/codex-howto · labs/2048-game-benchmark/AGENTS.md
git:20260801.7da7a8e · audit A · 9 stars
AGENTS.md@labs/engineering-playground agents
phelan164/codex-howto · labs/engineering-playground/AGENTS.md
git:20260724.a8a7148 · audit A · 9 stars
AGENTS.md@labs/incident-response-benchmark agents
phelan164/codex-howto · labs/incident-response-benchmark/AGENTS.md
git:20260811.78209a9 · audit A · 9 stars
build-backend skill
phelan164/codex-howto · skills/build-backend/SKILL.md · Build or modify backend APIs, services, jobs, persistence, and integrations while preserving contracts, authorization…
git:20260731.42e092c · audit A · 9 stars
build-frontend skill
phelan164/codex-howto · skills/build-frontend/SKILL.md · Build or modify frontend interfaces using repository-native components while preserving accessibility, responsive…
git:20260731.42e092c · audit A · 9 stars
engineering-loop skill
phelan164/codex-howto · skills/engineering-loop/SKILL.md · Drive an authorized repository change through a verified local loop: baseline, reproduce, implement, test, review, and…
git:20260915.dd80dad · audit A · 9 stars
maintain-codex-wiki skill
phelan164/codex-howto · skills/maintain-codex-wiki/SKILL.md · Maintain a review-first Markdown knowledge base for Codex practices with source provenance, engineering capture…
git:20260731.47f36fd · audit A · 9 stars
operate-devops skill
phelan164/codex-howto · skills/operate-devops/SKILL.md · Plan and implement infrastructure, CI/CD, container, deployment, observability, and operational configuration changes…
git:20260724.a8a7148 · audit A · 9 stars
orchestrate-engineering skill
phelan164/codex-howto · skills/orchestrate-engineering/SKILL.md · Coordinate complex engineering work across bounded subagents while protecting the main context, preventing edit…
git:20260724.a8a7148 · audit A · 9 stars

Every file in phelan164/codex-howto

Other files named AGENTS.md

AGENTS.md agents
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 291,204 stars
AGENTS.md agents
affaan-m/ecc · AGENTS.md
git:20260919.91ba9b4 · audit A · 266,832 stars
AGENTS.md agents
firecrawl/firecrawl · AGENTS.md
git:20260613.d9a35c0 · audit A · 184,144 stars
AGENTS.md agents
dietrichgebert/ponytail · AGENTS.md
git:20260710.b6c0448 · audit A · 144,862 stars
AGENTS.md agents
garrytan/gstack · AGENTS.md
git:20260914.4a3c6a8 · audit A · 134,082 stars
AGENTS.md agents
graphify-labs/graphify · AGENTS.md
git:20260414.7ec92ec · audit A · 121,202 stars
AGENTS.md agents
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 107,708 stars
AGENTS.md agents
addyosmani/agent-skills · AGENTS.md
git:20260709.b665c5c · audit A · 98,554 stars

Browse by kind, by grade A, or by owner.