Project Butler

Cross-sessie projectgeheugen voor AI-codeeragents: sessielogs, handoff, TODO, wiki, status

Door JamesShi96 · JamesShi96/project-butler

Getest · Werkt ★ 8.8/10

Project Butler — Cross-sessie projectgeheugen voor AI-codeeragents: sessielogs, handoff, TODO, wiki, status

Wat het doet

Handhaaft een gestandaardiseerde projectgeheugenstack (CLAUDE.md, PROJECT.md wiki, sessie-overdracht, TODO, sessielogs, update log, docs index, profielconfiguratie) zodat codeeragents projecten hervatten zonder herhaalde uitleg. Activeert bij /project-butler, "end session"/"收工", "continue"/"接着上次", "status", "organize files"/"整理文件", "sync wiki", "review claude", en taalwisseling. Bevat een dagelijkse git-gebaseerde versie-versheidscontrole die aanbiedt om zichzelf bij te werken.

Testrapport

Root SKILL.md opgehaald; references/update-check.md, scripts/check-update.sh, references/file-templates.md, references/project-profile-system.md steekproefsgewijs gecontroleerd (allemaal HTTP 200). check-update.sh volledig gelezen: het doet alleen git fetch/pull in zijn eigen map en grept CLAUDE.md op een taaltoken — geen curl|sh, base64 of exfiltratie; beperkt tot eens per 24 uur met een opt-out omgevingsvariabele. Trigger: "end session", "整理文件", "status where are we" beoordeeld als loads en "what's the current git status", "set up a new React project with Vite" als non-loads (5/5, hoewel "status"/"setup" een mild risico op trefwoordbotsing met zich meebrengen). Uitvoer-test: /private/tmp/.../scratchpad/baseline.md geschreven (9-regelig proza, 0 headers, geen per-taak velden) versus skill-log.md volgens het Session Log Format strikt (29 regels, 7 canonieke headers, elke openstaande taak met de verplichte Owner|Deadline|Dependencies scaffold, plus een aan het licht gebrachte CLAUDE.md kandidaat die de baseline weglaten).

Getest op: 2026-07-31 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/JamesShi96/project-butler.git ~/.claude/skills/project-butler
# SKILL.md sits at the repo root, so clone straight into the skill dir.
# No API keys or external deps. Optional: the skill runs scripts/check-update.sh
# (a daily `git fetch` against its own repo) to offer self-updates; set
# PROJECT_BUTLER_NO_UPDATE_CHECK=1 to silence it. Works with Claude Code, and
# Cursor (.cursor/rules) / Codex (AGENTS.md) via templates it can generate.

Commando's en voorbeeldprompts

/project-butlerCross-sessie projectgeheugen voor AI-codeeragents: sessielogs, handoff, TODO, wiki, status

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

Set up project memory for this new project
Close out this session and update the log
Organize the files in this project folder

Volledig rapport (Engels) →