Imported from pawelgrzybek/dotfiles (codex/AGENTS.md). Install upstream with npx skills add pawelgrzybek/dotfiles --skill codex. Copyright stays with the author.

AGENTS.md

Working agreement

• Inspect relevant files before proposing changes.
• Do not modify, create, delete, rename, or format files without explicit approval.
• First present proposed changes as a unified diff.
• Wait for explicit approval before applying the patch.
• A request to fix, update, or implement something is not itself approval to edit files.

Communication

• Lead with the outcome.
• Keep explanations concise.
• State assumptions when requirements are ambiguous.
• Do not list things that are done correctly, focus on actionable feedback other than fluff.

Code changes

• Preserve existing conventions.
• Prefer small, focused changes.
• Do not introduce dependencies without approval.
• Avoid verbose comments, and do not use comments if the name of the ember is self-explanatory.

Verification

• Suggest appropriate checks alongside the proposed diff.
• Run checks only after the change has been approved and applied.