jrmatherly/session-sync
.claude/skills/session-sync/SKILL.md
End-of-task sync — update CLAUDE.md, rebuild code graph, sync Serena memories, check roadmap drift, and commit. Run after completing any significant work to ensure all drift surfaces are current.
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add jrmatherly/1dev session-syncInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 2:22 PM5.6s1 file scanned
SKILL.md
- name:
- session-sync
- description:
- End-of-task sync — update CLAUDE.md, rebuild code graph, sync Serena memories, check roadmap drift, and commit. Run after completing any significant work to ensure all drift surfaces are current.
End-of-Task Session Sync
Run this after completing any significant task, feature, or migration to ensure all documentation surfaces stay current.
What this skill does (in order)
- Rebuild code-review graph — incremental update to capture code changes
- Reflect on session learnings — identify what's new, what changed, what future sessions need to know
- Check CLAUDE.md — verify the project root CLAUDE.md is current (version pins, architecture summary, commands)
- Sync Serena memories — read all 6 memories, identify drift against current codebase state, apply targeted edits
- Check roadmap — verify
docs/operations/roadmap.mdis current (active items match OpenSpec, recently completed items are recorded) - Commit + push — single commit covering all sync edits (do NOT commit code changes — only doc/memory drift fixes)
How to use
Invoke at the end of any session where you made substantive changes:
/session-sync
Or invoke with a scope hint:
/session-sync after Electron 41 upgrade + CI workflow fixes
The scope hint tells the skill what specifically to check for drift (version numbers, new files, new patterns, etc.).
Behavioral rules
- Read before writing — always read the current state of each surface before proposing edits. Don't assume prior session's context is still accurate.
- Targeted edits only — fix what's stale, don't rewrite entire files. One-line fixes are preferred over paragraph rewrites.
- Don't duplicate content — CLAUDE.md links to
docs/, Serena memories summarize for session priming,docs/is canonical. Each surface has a role; don't copy content between them. - Verify with ground truth — before claiming a count (tables, routers, guards, errors), grep the codebase. Don't trust the existing memory value.
- Exclude parallel session WIP — if
git statusshows changes from another session's in-progress work, don't stage those files. Commit only your drift-sync edits. - Run the docs build —
cd docs && bun run buildmust pass after edits todocs/pages.
Surfaces to check
| Surface | Source of truth | What drifts |
|---|---|---|
| CLAUDE.md | Codebase + docs/ | Version pins, architecture summary (Electron/TS/Vite version), commands, feature list |
| .serena/memories/project_overview | CLAUDE.md + docs/ | Tech stack versions, current state, active OpenSpec changes, upgrade execution order |
| .serena/memories/codebase_structure | src/ + drizzle/ | Table count, router count, file descriptions, directory tree |
| .serena/memories/environment_and_gotchas | .env + CI + tooling | Version pins, CI/CD details, upgrade blockers, tool gotchas |
| .serena/memories/suggested_commands | package.json + .claude/rules/ | Guard/test counts, quality gate baselines, rule index, skill list |
| .serena/memories/style_and_conventions | Codebase patterns | TS baseline, state management patterns, brand taxonomy |
| .serena/memories/task_completion_checklist | docs/conventions/ | Guard counts, OpenSpec spec counts, quality gate details |
| docs/operations/roadmap.md | openspec list + git log | Active changes, recently completed items, blocked items |
| .claude/PROJECT_INDEX.md | src/ + scripts/ + docs/ | File descriptions, build pipeline diagram, script inventory |
| Code-review graph | .code-review-graph/graph.db | Node/edge counts, last-updated timestamp |
Quick verification commands
# Current TS baseline (should match memories)
cat .claude/.tscheck-baseline
# Active OpenSpec changes (should match roadmap active items)
bunx @fission-ai/[email protected] list --json 2>/dev/null | grep -v Warning
# Regression guard count (should match memories)
ls tests/regression/*.test.ts | wc -l
# tRPC router count (should match CLAUDE.md + memories)
grep -c 'Router' src/main/lib/trpc/routers/index.ts
# Drizzle table count (should match CLAUDE.md + memories)
grep -c 'sqliteTable' src/main/lib/db/schema/index.ts
# Roadmap entry count
grep -cE '^### \[' docs/operations/roadmap.md
Commit convention
When committing session-sync edits, use:
docs: session sync — <what changed> + drift surface updates
Examples:
docs: session sync — Electron 41 + CI fixes + drift surface updatesdocs: session sync — release pipeline migration + drift surface updates
Related
.claude/rules/roadmap.md— rule requiring deferred work goes in the roadmap.claude/skills/roadmap-tracker/SKILL.md— structured roadmap operations/docs-drift-check— targeted drift check for specific surfaces (schema, routers, version pins)
Related Skills
jrmatherly/verify-strategy-compliance
development
VerifiedTrustedCommunity
Background knowledge for AI agents before editing any file that handles authentication tokens or spawn environment variables in the 1Code enterprise fork. Triggers when touching src/main/lib/trpc/routers/claude.ts, claude-code.ts, claude/env.ts, feature-flags.ts, or claude-token.ts. Reminds the agent to consult the frozen Envoy Gateway strategy doc (auth-strategy-envoy-gateway.md v2.1) sections that impose hard rules on credential handling.
SKILL.mdUpdated Apr 16, 2026
jrmatherly/verify-pin
tools
VerifiedTrustedCommunity
Background knowledge for safely bumping the pinned versions of Claude CLI binary, Codex CLI binary, Electron, Vite, Tailwind, or Shiki in this repo. Each pin is load-bearing for a different reason — this skill encodes the per-pin rationale and the regression test that must pass before the bump can land. Use proactively whenever editing package.json, scripts/download-claude-binary.mjs, scripts/download-codex-binary.mjs, or any file that mentions these versions. Claude-only (background knowledge, not user-invocable).
SKILL.mdUpdated Apr 16, 2026
jrmatherly/upstream-boundary-check
development
VerifiedTrustedCommunity
Use when reading or writing any file under src/renderer/ that calls remoteTrpc.* or fetch(${apiUrl}/...). Verifies the call site is documented in docs/enterprise/upstream-features.md and warns if a new upstream-backend dependency is being introduced without a corresponding F-entry. This skill enforces the enterprise-fork posture documented in CLAUDE.md.
SKILL.mdUpdated Apr 16, 2026
jrmatherly/roadmap-tracker
documentation
VerifiedTrustedCommunity
View, add, or complete items on the centralized project roadmap at docs/operations/roadmap.md. Use when starting a session to see outstanding work, when deferring work to record it, or when completing work to update the tracker. Triggers on "roadmap", "outstanding work", "what's left", "defer", "follow-up".
SKILL.mdUpdated Apr 16, 2026