AGENTS.md

Agent Instructions

These instructions are mandatory for all AI agents working on this project.

1. Package Manager: Always use pnpm (never npm or yarn) for installing dependencies and running scripts.
2. Code Quality:
   • Ship only high-quality, production-ready code.
   • Ensure code is clean, readable, and maintainable.
3. Error Handling:
   • Use try/catch blocks appropriately to handle errors gracefully.
   • Ensure robust error handling patterns are in place.
4. Localization:
   • Support both French and English versions for all content and features.

▲ VERCEL DEPLOY CHECK

Use the vercel CLI (installed globally) to verify deployments after pushing.

When to check: Only if the commit touches files that affect the Vercel deployment (app code, config, dependencies, build scripts). Skip for docs-only, internal tooling, or unrelated changes.

After every qualifying push, run:

for i in 1 2 3 4 5 6; do
  sleep 20
  STATUS=$(vercel ls --limit 1 2>&1)
  echo "$STATUS" | grep -q "● Ready" && echo "✅ Deploy OK" && exit 0
  echo "$STATUS" | grep -q "● Error" && break
done
echo "❌ Deploy failed — fetching logs"
vercel logs --limit 10

• Loops 6 × 20s (2min max), exits early on ● Ready.
• If ● Error: read the logs with vercel logs, diagnose, fix, commit, push, re-run the check.
• If still spinning after 2min: vercel logs to investigate.