awesome-loop-engineering: Instructions file for Codex

Repository Guidance For AI Agents

This repository curates resources for the new AI/coding-agent meaning of Loop Engineering.

Scope

Include resources that help readers design, run, verify, evaluate, or critique recurring AI-agent systems that sit above prompt, context, and harness engineering. A good entry should explain how a loop discovers work, delegates to agents, supplies context, bounds tools and permissions, verifies results, persists state, decides next actions, retries, or escalates.

Do not include unrelated uses of "loop":

• software event loops;
• UI/game loops;
• control theory;
• growth loops;
• generic workflow automation;
• non-AI feedback loops.

Editing Rules

• Keep README.md as the canonical English source.
• Preserve the four-layer framing when editing the intro, scope, or mental model: prompt, context, and harness engineering improve one run; Loop Engineering governs repeated agent work over time.
• Keep annotations short, specific, and builder-oriented.
• Prefer primary sources, official docs, papers, and implementation-heavy write-ups.
• If a resource is generic agent, prompt, context, or harness content, include it only when the annotation clearly explains its loop-design relevance.
• Update README.zh-CN.md only for translated overview content; do not let it drift into a separate resource list unless maintained.
• When adding a new category, update README.md, CONTRIBUTING.md, PR templates, and issue templates together.
• Do not add generated marketing copy or unsupported hype.

Commit Identity Rule

Never create commits with AI-assistant co-author trailers or any non-owner author/committer identity. All commits in this repository must be authored and committed as ChaoYue0307 <[email protected]>.

When committing from an AI agent, do not use plain git commit if the environment may append co-author trailers. Create commits with explicit identity instead:

git add <files>
PARENT="$(git rev-parse HEAD)"
TREE="$(git write-tree)"
NEW="$(GIT_AUTHOR_NAME='ChaoYue0307' GIT_AUTHOR_EMAIL='[email protected]' GIT_COMMITTER_NAME='ChaoYue0307' GIT_COMMITTER_EMAIL='[email protected]' git commit-tree "$TREE" -p "$PARENT" -m "Commit message")"
git update-ref refs/heads/main "$NEW" "$PARENT"