AGENTS.md

Agent Instructions

Landing the Plane (Session Completion)

When ending a work session, complete the steps below. Work is NOT complete until git push succeeds.

MANDATORY WORKFLOW:

1. Capture follow-up work - Note anything that still needs doing in the handoff.
2. Run quality gates (if code changed) - Tests, linters, builds.
3. PUSH TO REMOTE - This is MANDATORY:

   git pull --rebase
   git push
   git status  # MUST show "up to date with origin"

4. Clean up - Clear stashes, prune remote branches.
5. Verify - All changes committed AND pushed.
6. Hand off - Provide context for next session.

CRITICAL RULES:

• Work is NOT complete until git push succeeds.
• NEVER stop before pushing - that leaves work stranded locally.
• NEVER say "ready to push when you are" - YOU must push.
• If push fails, resolve and retry until it succeeds.