Land community pull requests as the contributor and answer community issues on thedotmack/claude-mem. Takes stock of every open PR (the owner's own included, except the ones the owner marked experimental) and community issue, triages each against the owner's merge philosophy and the cmem.ai hosted-service boundary, finishes somewhat-aligned PRs on the contributor's own branch, squash-merges so the contributor stays the commit author on main, thanks them by name, closes fixed issues with credit to reporter and fixer, keeps the private ledger and contributor roster current, and reports what it decided. Use when asked to "go through the PRs", "merge contributor PRs", "help contributors with their PRs", "land the new community PRs", "triage new issues and PRs", "run the community sweep", "keep the momentum", or "grow the community".
94%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
Grow the claude-mem community by merging people in. Every valuable contribution lands as the contributor: their PR, their name as the commit author on main. A PR that is only partly right gets finished on their branch instead of rejected. Issues get the same treatment, so the person who reported a bug and the person who fixed it both hear about it, by name.
This is the protocol from the 2026-09-30 open-PR merge sweep, which took 257 open PRs to 46 and merged 143 contributor PRs from 87 authors with their authorship intact. It is written down so every new batch of PRs and issues gets handled the same way.
docs/merge-rubric.md). Opt-in features are welcome, as are extensibility (providers, hosts, hooks, settings knobs) and anything that cuts token spend (bounding, batching, dedup, filtering).Count humans, not tools. A PR written with Claude, Codex, Cursor or Copilot is credited to the human who opened it. Bot PRs (PostHog, Copilot agent, Dependabot) land on merit, but they never go on the roster.
Run state lives in the main checkout's gitignored .scratch/, so every worktree shares it:
MAIN_CHECKOUT="$(cd "$(git rev-parse --git-common-dir)/.." && pwd)"
STATE="$MAIN_CHECKOUT/.scratch/community"
RUN_ID="CS-$(date -u +%F)"; RUN="$STATE/runs/$RUN_ID"; mkdir -p "$RUN"| File | What it is |
|---|---|
$STATE/ledger.tsv | One row per outcome. The last row for a number wins. It is the source of truth for what already happened; never redo a number it shows as done. |
$STATE/ROSTER.md | Every human with a merged PR or a co-author credit, kept for the owner's outreach. It holds emails, so never commit it, upload it, or quote it. |
$RUN/ | This run's snapshots, triage reports, test baseline and REPORT.md. |
To append a ledger row (tab-separated; PR and issue numbers share one namespace):
printf '%s\t%s\t%s\t%s\t%s\t%s\t%s\t%s\n' "$(date -u +%FT%TZ)" <number> "$RUN_ID" <action> <merge_sha|-> <author> <coauthors|-> "<one-line note>" >> "$STATE/ledger.tsv"merged, closed, blocked, skipped; for the owner's PRs, also experimental, and approved, which the owner writes to take a PR out of experimental. Older runs also wrote held, and approved for owner sign-offs.issue-closed, issue-answered, issue-routed. Older runs also wrote issue-held.ledger.tsv doesn't exist, create it with the header ts pr phase action merge_sha pr_author coauthors note (tab-separated).gh pr list --repo thedotmack/claude-mem --state open --limit 500 --json number,title,author,isDraft,createdAt,updatedAt,mergeable,mergeStateStatus,maintainerCanModify,headRefName,headRepositoryOwner,baseRefName,additions,deletions > "$RUN/open-prs.json"
gh issue list --repo thedotmack/claude-mem --state open --limit 500 --json number,title,author,createdAt,updatedAt,labels,comments > "$RUN/open-issues.json"Put every open PR in exactly one bucket, using its last ledger row. Use the first bucket that matches:
| Bucket | Rule | What to do |
|---|---|---|
| Experimental | the owner's PR, last row is experimental | Leave it alone. Report any new activity. |
| Held | last row is held (written before 2026-11-07) | Triage it from scratch this run and settle it yourself, like a new PR. |
| Approved | last row is approved (the owner took it out of experimental, or an older run recorded an owner sign-off) | Triage it from scratch this run, like a new PR. |
| Blocked | last row is blocked | Re-triage only if the author pushed or replied after that row. |
| Done | last row is merged or closed | It shouldn't be open, so find out why. |
| New | no row | Triage it (step 2). |
For issues, skip the maintainer-authored ones: the [plan-NN] masters and the Merge Clinic. Triage every other open issue that:
issue-held as its last row (written before 2026-11-07): triage it from scratch this run, like a held PR;On a first run, that is all of them.
Test baseline. Take it once per run, before landing anything. Use a clean origin/main worktree and the same Bun as CI (bun-version: latest), because an older local Bun can fail subprocess tests that CI passes. If local Bun is behind, run every suite in the run (baseline, per-PR and gate) as npx -y bun@<latest> test …. npm view bun version gives the latest version.
npm install --no-audit --no-fund && npm run build
env -u CLAUDE_MEM_LLM_TIMEOUT_MS bun test tests > "$RUN/baseline-suite.log" 2>&1; echo "suite exit $?"
grep -E '^\(fail\)' "$RUN/baseline-suite.log" | sed -E 's/ \[[0-9.]+m?s\]$//' | sort -u > "$RUN/baseline-failures.txt"
tail -n 40 "$RUN/baseline-suite.log" | grep -E '^ *[0-9]+ pass$|^ *[0-9]+ fail$|^Ran [0-9]+ tests across'The last command must print the suite's own summary: N pass, N fail and Ran N tests across M files, with M close to the number of test files. If it prints nothing, the run died before finishing (a crash, a timeout, a missing dependency) and an empty baseline-failures.txt means nothing. Stop, fix the cause, and take the baseline again; never land PRs against an incomplete one. A nonzero exit on its own is not that: failing tests exit nonzero, and some Bun versions crash at exit after printing the summary. The sed drops each failure's timing so the lists compare line for line.
gh pr view <N> --repo thedotmack/claude-mem --json title,body,author,headRefOid,headRefName,headRepositoryOwner,maintainerCanModify,mergeable,mergeStateStatus,isDraft,closingIssuesReferences,commits,files
gh pr diff <N> --repo thedotmack/claude-mem
gh pr checks <N> --repo thedotmack/claude-mem
gh api repos/thedotmack/claude-mem/pulls/<N>/comments --paginate # inline review findings (Greptile, Cursor Bugbot, CodeRabbit)
gh api repos/thedotmack/claude-mem/issues/<N>/comments --paginate # the conversationRead main's code with git show origin/main:<path>. Leave generated bundles out of diff sizing (the list is in step 3); they're noise and get stripped at merge. If the PR maps to a plan master (plans/NN-*.md), read that section first. A PR that implements the master's intended fix is a strong candidate. A PR that contradicts the master needs a reason.
Evidence per PR:
mergeable, maintainerCanModify, CI state, non-bundle diff size, linked issues.gh run list --repo thedotmack/claude-mem --branch main --limit 5) is not the PR's.file:line or a commit as evidence.Verdicts (exactly one per PR):
| Verdict | Meaning | What happens |
|---|---|---|
MERGE | Correct, complete and aligned; mergeable now or after a mechanical merge of main | Land it (step 3). |
MERGE+POSTPLAN | Stops real bleeding but isn't the root fix | Land it and write the post-plan into the report. |
REWORK | Right intent, but incomplete, buggy or a band-aid | A numbered gap list is the spec. Finish it on their branch (step 4), then land it. |
TRIM | Only part of it is additive | Keep that part on their branch and land it as their PR. Say what was dropped and why. |
CONSOLIDATE→#M | Overlaps #M | Prefer landing the additive piece as its own trimmed PR. Otherwise fold it into #M with credit (step 4). |
SUPERSEDED | main already fixes it | Cite the commit or file:line. Close with precise credit. |
BOUNDARY | Crosses the hosted-service boundary as written | Trim or rework the boundary-crossing part out on their branch and land the rest, or decline it with the reason if nothing else is left. |
DECLINE | Wrong direction, harmful, not worth finishing, or does nothing (a no-op change) | Close with thanks and the reason yourself. Never hand the owner a decision to not merge something useless. |
SPAM / EMPTY | Unrelated to claude-mem, or no code. This includes rewrites of SECURITY.md, README or LICENSE with someone else's details, and CLAUDE.md or AGENTS.md replaced with a tool's generated output | Close with one neutral line. |
thedotmack)The owner's PRs go through the same triage and landing as everyone's.
experimental in the ledger. It stays out of the sweep until the owner takes it out of experimental by writing an approved row, which puts it in the Approved bucket; each run, list any new activity on it.BOUNDARY)claude-mem is open source. cmem.ai is the hosted service: cloud sync, plus the inference gateway with its sign-in and trial. A PR must not do any of the following as written. Trim or rework that part out and land the rest, or decline it:
src/npx-cli/commands/install.ts, src/npx-cli/cmem-memory-credentials.ts, src/npx-cli/cmem-pro-costs.ts).src/shared/cmem-gateway.ts, the keysForEndpoint lock).src/services/worker/provider-dispatch.ts).src/shared/pro-promo.ts.src/services/sync/, services/sync-api/).These are not conflicts, so judge them on merit: opt-in bring-your-own providers, hosts and knobs that leave the gateway path first; token-spend optimizations; correct fixes to our own sync client; IDE and host integrations; and fixes to the self-hosted server runtime. Supporting a new IDE or host is never a product call: the goal is to support every IDE, so a new adapter or install --ide <host> gets judged on merit, and an issue asking for one gets a go-ahead. A new provider preset never goes above cmem.ai and never edits the installer, sign-in or cost files. A fix that makes a broken boundary path work again (sign-in that 500s, sync that stalls, a gateway call that crashes) is not a boundary change: it is a critical fix (philosophy 7), so land it. If the fix also changes what the path does (different steps, defaults, notices or entitlement), land the fix and trim that change. If you're unsure, take the reading that leaves cmem.ai's path unchanged, land it, and say in the report what you decided.
MERGE as-is)The local observer is live-only. The owner set this on 2026-11-03, and AGENTS.md and docs/architecture/observer-lifecycle.md on main hold the full contract. Read both before triaging any PR that touches capture, the hook spool, SessionMessageBuffer, GeneratorExitHandler, getResumableSessionIds, abort categories, resume timers or provider cooldowns.
REWORK to discard the work through discardBufferedWork, or DECLINE when nothing else is left. Never MERGE it as-is, however good its tests are.AGENTS.md. Preserve-and-resume code still on main is a bug waiting for removal. It is not a reason to hold the owner's PR that removes it. #5383 was merged against this rule on 2026-11-05, and on 2026-11-06 the owner's fix #5347 was wrongly held as "overtaken" by it.Work in your own worktree, never the user's current one: an Agent with isolation: "worktree", or git worktree add --detach "$MAIN_CHECKOUT/.claude/worktrees/community-<name>" origin/main. Then run npm install --no-audit --no-fund.
gh pr view <N> --repo thedotmack/claude-mem --json state,isDraft,mergeable,baseRefName,headRefName,maintainerCanModify # merged or closed meanwhile? ledger it `skipped`
gh pr edit <N> --repo thedotmack/claude-mem --base main # only if the base isn't main
gh pr checkout <N> --repo thedotmack/claude-mem --branch pr-<N> # sets the push remote to their fork
git merge --no-edit origin/main # a merge commit; never rebase their commitsGenerated bundles never land from a PR; they're rebuilt at release. The generated set is what scripts/build-hooks.js and scripts/build-viewer.js write. If the list below looks stale, re-read those two scripts:
plugin/scripts/{worker-service,hook-service,server-service,mcp-server,context-generator,context-read-worker,work-view-read-worker,transcript-watcher,claude-mem-launcher,ensure-launcher}.cjs and their .map files;plugin/sqlite/**;plugin/ui/viewer-bundle.js, plugin/ui/viewer.html, plugin/ui/tv.html, plugin/ui/work-view/** (the Vite build of src/ui/my-work), and the fonts and icons copied into plugin/ui/;plugin/package.json;plugin/skills/request-progress/scripts/request-groups.mjs.If the PR changed any of them, restore them with git checkout origin/main -- <paths> (or git rm any the PR added) and commit chore: drop generated bundles (rebuilt at release). If the PR edited only a copy (say plugin/ui/viewer.html), move the edit to its source under src/. Hand-written files under plugin/ stay: plugin/scripts/{bun-runner.js,statusline-counts.js,version-check.js,worker-wrapper.cjs,qoder-hook-launcher.cjs}, hooks, skills, modes and manifests.
Apply the verdict. MERGE needs nothing more. For REWORK and TRIM, follow the gap list (step 4). Our commits use conventional messages and end with the attribution trailers your session specifies.
Verify on the exact head you will merge:
npm run typecheck.npm run build (the bundle-size guardrail) and leave its output in place for steps 3–5, so tests that load built bundles run the PR's code, not main's.env -u CLAUDE_MEM_LLM_TIMEOUT_MS bun test tests and compare it with $RUN/baseline-failures.txt. For a failure that isn't in the baseline, re-run that file alone first. If it passes alone and in CI, it was load from parallel suites. If it still fails, it's the PR's to fix.openclaw/ is touched, run bun test openclaw.git checkout -- plugin/ and git clean -fd -- plugin/, so build output is never committed. Do this before any further commit too. The checkout alone leaves untracked output behind, such as plugin/scripts/work-view-read-worker.cjs and plugin/ui/work-view/assets/*. Stage files by name, not with git add -A.Push to their branch, which is needed only if you merged main with conflicts or added commits. Never force-push.
remote=$(git config branch.pr-<N>.pushRemote || git config branch.pr-<N>.remote)
head=$(git config branch.pr-<N>.merge); head=${head#refs/heads/}
git push "$remote" "HEAD:$head" # a bare `git push` is refused: the local name pr-<N> differs from their branchIf the push is rejected as non-fast-forward, they pushed meanwhile. Run git pull --no-rebase "$remote" "$head", re-verify and push again. If their new head already does what you did, drop yours.
CI.
First-time contributors' runs sit in action_required. Read the whole diff for anything that executes in CI (workflows, package scripts, postinstall, tests that shell out). Then approve every waiting run for the PR head except Claude Code: CI and Windows always, plus Media native runtime and Native ODS integration when the PR's paths start them. Look them up by head SHA: gh run list --branch misses fork PRs.
sha=$(gh pr view <N> --repo thedotmack/claude-mem --json headRefOid --jq .headRefOid)
gh api "repos/thedotmack/claude-mem/actions/runs?head_sha=$sha" --jq '.workflow_runs[] | select(.conclusion=="action_required" and .name!="Claude Code") | "\(.id) \(.name)"'
gh api -X POST repos/thedotmack/claude-mem/actions/runs/<id>/approve # once per id listedNever approve CI for SPAM or DECLINE.
Never approve the "Claude Code" runs. Those are the @claude responder (.github/workflows/claude.yml); they carry a secret and aren't needed to merge.
Watch with gh pr checks <N> --repo thedotmack/claude-mem --watch --interval 60.
Rerun a flake once (gh run rerun <id> --failed). Fix a real failure.
If a draft is ready by your verdict, run gh pr ready <N>.
Merge one PR at a time:
Run git fetch origin.
If main moved, do a trial git merge --no-edit origin/main locally, then run typecheck and the PR's targeted tests again. Push only if the merge needed a conflict resolution.
Merge:
gh pr merge <N> --repo thedotmack/claude-mem --squash # NEVER --admin, --body or --author-email
git fetch origin && git log -1 --format='%H | %an <%ae> | %s' origin/mainAdd --subject "<type>(<scope>): <summary> (#<N>)" only when the PR title would mislead, for example on a trimmed or re-scoped PR.
The author on main must be the contributor. If it isn't, stop merging and record it as an incident in the report. Then comment (step 6), ledger the merge with the full SHA, and close any issue the PR fixed that GitHub didn't auto-close (step 5).
Ship critical fixes. Once a critical fix (philosophy 7) is merged and main's CI is green, cut a patch release with the claude-mem:release skill. Run it from a fresh worktree of main (git fetch origin, then git worktree add --detach "$MAIN_CHECKOUT/.claude/worktrees/community-release" origin/main), never from a PR landing worktree, whose HEAD is a PR branch. Hold merge.lock from the fetch until the release commit and tag are pushed, so no merge lands mid-release, then release it and remove the worktree. This is the one hold allowed past 5 minutes. Don't wait for the run to end or for the owner. If more critical fixes are landing in the same run, release once after the last of them. The release includes the X post from @Claude_Memory (version-bump step 14). Post it at any hour without asking. Then follow the release with claude-mem:childhood until the published package carries the fix. Tell the reporter which version has it (step 5). Non-critical merges ride along in the next release.
blocked, and move on.maintainerCanModify=false). Post a review comment with the exact changes needed, ask them to enable "Allow edits by maintainers", and ledger it blocked.git cherry-pick -x onto a branch in thedotmack/claude-mem (that keeps their authorship). Open <title> (rehost #<N>) crediting @author, land it with gh pr merge --rebase, and close the original with thanks and a link.git fetch origin pull/<M>/head:pr-<M> and git cherry-pick -x <sha>. That keeps their authorship, and GitHub adds Co-authored-by to the squash.Co-authored-by: <Name> <email from their commit> to our commit message.gh issue view <N> --repo thedotmack/claude-mem --json title,body,author,comments,labels,createdAt
gh pr list --repo thedotmack/claude-mem --state all --search "<N>" --json number,title,state,author,mergedAt
git log origin/main --oneline --grep="#<N>\b"| Verdict | Test | Action |
|---|---|---|
FIXED | A merged PR fixes it. Prove it on main with file:line. | Comment, then gh issue close <N> --reason completed. Comment even when a merge already auto-closed it, because the auto-close says nothing. |
HAS-PR | An open PR addresses it. | Triage and land that PR this run, then close the issue as FIXED. If the PR can't land yet, comment once linking it so the reporter can try it. |
PLAN | It's a symptom of an open plan master. | Route it with the oh-my-issues skill, Mode 2: a Round-N comment on the master, then the standard redirect. |
CONFIRMED | A real bug on main with no PR. | Reply with the root cause (file:line on main) and invite a PR ("happy to help land it"). Alternatively, fix it in our own PR that credits the reporter. If it interrupts service (philosophy 7), don't wait for a contributor: fix it in our own PR this run and ship it. |
NEEDS-INFO | Can't be reproduced or located from the report. | Ask once for exactly what's missing: version, OS, the log lines. |
DUPLICATE→#M | The same defect as #M. | Comment "Duplicate of #M", then close it as not planned. |
PRODUCT | Billing, cmem.ai, the roadmap, or a product question. A break in a cmem.ai path such as sign-in that 500s is not one: that is CONFIRMED or HAS-PR, handled as a critical fix. | Answer it yourself from the docs, the code and the owner's past decisions in memory, or route it to the plan master it belongs to. |
SPAM | Unrelated to claude-mem. | Close with one neutral line. |
Before posting, reconcile the claims. If a PR's triage and an issue's triage disagree about what fixes an issue (for example project= versus projects=), read main yourself. Never credit the wrong person.
Release status matters to reporters. git tag --contains <sha> --sort=v:refname | head -1 names the first release with the fix. If no tag contains it, say "it's on main and ships in the next release". Never promise a date.
Make them warm, specific and short: name the person, and say what changed for users in plain words. Don't use marketing language, and never mention any reward, outreach or business reasoning. These are real examples:
tool_use_id, agent_id and agent_type, so tool calls dedupe properly and the subagent capture settings apply to Codex as well. I merged main and left the README paragraph out; the README stays a user-facing overview."
<sha> (#X)"), and invite the next contribution.CLAUDE_CODE_TMPDIR, so pointing it at a private directory works for the Observer too. Thanks @reporter for the report and @fixer for the fix."Ledger. Add a row for every merge, close, hold, block, skip and issue action, as it happens.
Roster. Add new merged human authors to $STATE/ROSTER.md: login, public name (the squash commit's author), PRs and short SHAs. Add co-author-only credits from Co-authored-by trailers, then recount the totals. One person can have two git identities; map them to one login.
Gate. After the run's last merge, verify in a fresh origin/main worktree:
git log <run-start>..origin/main --format='%h %an %s' -- 'plugin/scripts/*.cjs' 'plugin/scripts/*.map' plugin/sqlite plugin/ui plugin/package.json plugin/skills/request-progress/scripts/request-groups.mjs CHANGELOG.md lists no contributor PR. A hand-written .cjs like worker-wrapper.cjs is fine, and so are the owner's own UI builds.git log <run-start>..origin/main --format='%an' | sort | uniq -c shows contributors, not only the maintainer.Fix any regression forward in our own PR, test-first.
Report. Write $RUN/REPORT.md, then post a short version in chat:
| # | author | verdict | outcome | merge SHA | author on main | note |;Triage in parallel with read-only subagents, about 5 PRs each, grouped by area. Give each one step 2 of this skill and its PR list. Its only writable file is $RUN/triage/<group>.md, and it returns a compact table: | # | author | verdict | conf | one-line reason | canModify | mergeable | CI |.
Land in parallel with executor subagents (isolation: "worktree"), one per group. Merges into main stay serialized by a lock:
until mkdir "$STATE/merge.lock" 2>/dev/null; do sleep 20; done
echo "<executor> #<N> $(date -u +%FT%TZ)" > "$STATE/merge.lock/owner"
# … fetch, trial merge, gh pr merge, confirm author …
rm -f "$STATE/merge.lock/owner"; rmdir "$STATE/merge.lock"Hold the lock for 5 minutes at most (a critical-fix release is the one exception, step 3). Never break someone else's lock; if it has been held for more than 20 minutes, tell the orchestrator.
GitHub's API budget is shared: 5,000 requests an hour each for REST and GraphQL. Poll CI no faster than every 60 seconds, batch fields into one --json call, and on a rate-limit error wait for the reset (gh api rate_limit) instead of retrying.
Keep helper scripts in each executor's own subdirectory. During the sweep, shared helpers at a common root were overwritten by another executor.
Stop cleanly on a spend or usage limit: release the lock, stop making changes, and report what is mid-flight.
Watch the disk: each worktree is about 1 GB of node_modules. Remove run worktrees when the run ends.
--admin, --body or --author-email.CHANGELOG.md from a PR. Bump the version or publish only through the release skill (step 3).thedotmack/claude-mem
ea45a39
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.