manta-pr-workflow

manta-pr-workflow

The standard implementer workflow for the MANTA agents.

Steps

1. multica repo checkout [email protected]:antoinedc/MantaUI.git inside your workdir. Never edit files outside the workdir. (A human-owned checkout at /home/dev/projects/better-ui bypasses isolation.)

2. Sync main to origin/main BEFORE you branch (mandatory — stale-base antibody). A reused/cached workdir can hold a main that is days behind origin/main; branching off it makes your diff appear to delete files that were merged to origin/main after your stale checkout, producing phantom "you deleted X" review Blocks that no fix can resolve. Always:

   git fetch origin
   git checkout main
   git reset --hard origin/main      # workdir is disposable; make main == origin/main
   git checkout -b multica/BET-N-<slug>
   # Record the base you branched from, for the PR body (step 11):
   git rev-parse --short origin/main
   

   The recorded origin/main short-sha is your base SHA — put it in the PR body so the reviewer can confirm freshness in one glance.

3. Read the issue. If it touches IPC, renderer, main process, preload, or server routes, re-read the matching architecture docs in the repo.

4. Run the anti-spaghetti contract (below) before writing any new code. Search for an existing implementation first; the default move is to extend/reuse, not to add a parallel copy.

5. Implement. Add or update tests under tests/ or __tests__/.

5b. Commit incrementally while you implement (BET-1445 — worktree-hijack insurance). A sibling session's multica repo checkout can resolve to YOUR worktree mid-run and hard-reset it (git reset --hard origin/main + branch switch), destroying uncommitted edits (killed the BET-1439 rerun, ~45 min). Checkouts are git worktrees of a shared bare clone, so committed work on your task branch survives a hijack — only the uncommitted delta is lost. So: commit to your task branch after every coherent unit and never leave more than a few minutes of work uncommitted (then push per step 8). And if your worktree suddenly looks reset/switched (unexpected origin/main HEAD, foreign branch, edits gone): run git branch --show-current, then recover — git checkout multica/BET-N-<slug> in place (or git worktree add <dir> multica/BET-N-<slug> if checkout is disturbed) — verify with git log that your commits are intact, redo only the lost delta, and CONTINUE. Do not assume the work is lost and restart from zero.