Troubleshooting

Agent ignores AEP

Cause: pack is not in an agent-visible path or instructions do not reference it.

Fix:

• place the pack in the active agent directory
• update AGENTS.md and agent-specific instruction files

Packs become too verbose

Cause: trying to store full session transcripts inside AEP.

Fix: keep only reusable guidance, constraints, and checks.

Conflicting constraints

Cause: old rules kept after process changes.

Fix: review constraints quarterly and remove stale items.

Weak success checks

Cause: checks are phrased as opinions instead of verifiable outcomes.

Fix: rewrite checks as pass/fail criteria tied to tests, routes, or artifacts.