Agent Integration

Integration principle

Do not rely on one global hidden directory. Put AEP where the active agent can actually read it.

Examples:

• .claude/ for Claude workflows
• .codex/ for Codex workflows
• .cursor/ for Cursor workflows
• .gemini/ when using Gemini tooling

Update agent instructions

After creating an AEP, update your agent instruction files so they explicitly say to use AEP first.

Typical instruction files include:

• AGENTS.md
• CLAUDE.md
• agent-specific project instruction files

Prompting pattern

Use intent-focused prompts:

• "Load the project AEP and execute this task with its constraints."
• "Inspect the existing AEP and propose updates based on this session."
• "Promote stable task rules into the project-level AEP."

Operational tips

• Keep packs small and composable
• Prefer explicit checks over broad advice
• Keep one source of truth per scope