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 <hechaoyue0307@gmail.com>.

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='hechaoyue0307@gmail.com' GIT_COMMITTER_NAME='ChaoYue0307' GIT_COMMITTER_EMAIL='hechaoyue0307@gmail.com' git commit-tree "$TREE" -p "$PARENT" -m "Commit message")"
git update-ref refs/heads/main "$NEW" "$PARENT"

Before pushing, verify:

python scripts/check_commit_identity.py

Entry Format

- 📄 **Paper** [Title](https://example.com) - One sentence explaining the resource's contribution to Loop Engineering.

Quality Preference

When two sources overlap, prefer:

primary source or official docs;
implementation details over commentary;
stable URLs over social posts;
practical loop design over broad AI-agent trend coverage.