merge

Source excerpt starting at line 1.

1# Resolve Merge Conflicts2 3Resolve all merge conflicts from a `git merge origin/main` into `next`. The working tree has conflict markers in all affected files. Your job is to resolve every conflict so that `pnpm install` and `pnpm build` can succeed.4 5**SCOPE: Do not spawn tasks/sub-agents.**6 7## Prerequisites8 9- **`branch`** — The branch name (e.g., `ci/merge-main-to-next`).10- **`hasConflicts`** — Whether the merge had conflicts.11- The working directory is the repo root, checked out on the merge branch.12- `git merge origin/main` has been run but NOT committed — conflict markers are present in the working tree.13- Dependencies are NOT installed yet. Do not run `pnpm install` — the orchestrator will do that after you finish.14 15## Steps16 17### Step 1: Find all conflicted files18 19```bash20# List all files with conflict markers21grep -rl "<<<<<<< " . --include="*.ts" --include="*.js" --include="*.mjs" --include="*.cjs" --include="*.md" --include="*.astro" --include="*.json" --include="*.yaml" --include="*.yml" | grep -v node_modules | sort22```23 24### Step 2: Resolve conflicts by file type25 26For each conflicted file, resolve using these rules:27 28#### `package.json` files29 30- **`version` fields** — Always keep `next`'s pre-release version (e.g., `5.0.0-beta.1`). NEVER use `main`'s stable version.31- **Dependencies** — Keep `next`'s versions for shared deps. If `main` added a NEW dependency that doesn't exist on `next`, include it. If `main` swapped a dependency for a different one (e.g., `get-tsconfig` → `tsconfck`), keep whichever the source code on `next` actually imports.32- **Scripts** — Merge both sides: keep `next`'s scripts and add any new scripts from `main`.33- **Other fields** — Prefer `next` unless `main` has an obvious bug fix.34 35#### `pnpm-lock.yaml`36 37- Do NOT try to manually resolve the lockfile. Just delete it — the orchestrator will regenerate it via `pnpm install --no-frozen-lockfile` after you're done.38 39```bash40git checkout --theirs pnpm-lock.yaml 2>/dev/null || true41```42 43#### Source code (`.ts`, `.js`, `.mjs`, `.cjs`, `.astro`)44 45- **Bug fixes from `main`** — If `main` fixed a bug, that fix should carry over to `next`. Adapt the fix to `next`'s API if needed.46- **API changes on `next`** — If `next` changed an API, keep the `next` version and adapt the `main` code if needed.47- When in doubt, prefer `next` — it's the forward-looking branch.48 49#### Markdown and config files50 51- **Changesets** (`.changeset/*.md`) — will be handled by the clean-changesets skill. For now just accept both sides.52- **Other `.md` files** — prefer `next`.53 54### Step 3: Stage resolved files55 56After resolving each file, stage it:57 58```bash59git add <resolved-file>60```61 62### Step 4: Verify no conflict markers remain63 64```bash65grep -r "<<<<<<< \|=======$\|>>>>>>> " . --include="*.ts" --include="*.js" --include="*.mjs" --include="*.cjs" --include="*.md" --include="*.astro" --include="*.json" --include="*.yaml" --include="*.yml" | grep -v node_modules66```67 68If any remain, resolve them.69 70### Step 5: Do NOT commit or install71 72The orchestrator handles committing, installing, and building.73 74## Output75 76Return the list of files where conflicts were resolved.77