keel-update

/keel-update — sync this project with the latest Keel template

Use when the kit was cloned a while ago and the template has since improved (hardened hooks, doc fixes, workflow updates). Pull model: run it IN the project, review diffs, approve. Non-destructive is the hard rule (same spirit as /keel-adopt): nothing is applied without a shown diff + an explicit yes.

One channel: the kit is clone-only (the plugin/marketplace half was retired in v0.8.23 — it delivered only the tooling, double-fired hooks alongside a clone, and needed marketplace access that locked-down networks block). Everything therefore syncs HERE, through the buckets below. If a project still has keel@keel installed from before, removing it is the fix for double-firing hooks.

1. Fetch the latest template (never inside the project)

rm -rf /tmp/keel-latest   # idempotent — clear the stale clone a previous /keel-update run left behind
git clone --depth 1 https://github.com/muratsilahtaroglu/claude-code-starter-kit /tmp/keel-latest
git -C /tmp/keel-latest rev-parse --short HEAD   # record for the handover line

2. Classify every template path into three buckets

• PROTECTED — never touched (project-owned): HANDOVER.md · LESSONS.md · TASKS.md · PLAN.md · docs/handover-archive.md · docs/lessons-retired.md · docs/architecture.md · docs/adr/* (except the kit-owned 0000 template and the folder README.md — those are TOOLING) · CLAUDE.md · README.md · LICENSE · config/ · requirements/*.{txt,lock} contents · .env.example values · src/ · tests/ (except the kit-owned tests/unit/test_keel_*.py matrix — that is TOOLING, same carve-out as the ADR 0000 template; never put project tests in a test_keel_*.py file) · scratch/ · research/ findings · reports/ · .claude/last-audit · .claude/project-owner · .claude/keel-caps · .claude/lessons-backlog · .claude/tasks-backlog (project state: audit clock + governance owner + tuned caps + entry-budget baseline) · .claude/agents/team-*.md (project agent-team charters, owner-authored — the kit ships none; .claude/agent-team-sessions is git-ignored and never syncs).
• REVIEW — likely tailored; full diff, apply hunk-by-hunk with approval: rules.md · .claude/settings.json (permissions merge = union, keep the project's) · .gitignore · .pre-commit-config.yaml · pyproject.toml · Makefile · Dockerfile* · .dockerignore · docker-compose.yml · .editorconfig · .github/* (workflows + PR template) · docs/layouts.md · docs/user_manual.md · folder READMEs that carry KIT DOCTRINE inside a PROTECTED tree — scratch/README.md, tests/README.md, tests/*/README.md: the folder's CONTENTS are the project's, but the README states the kit's rule for that folder and projects tailor it, so it is diffed hunk-by-hunk rather than skipped with the tree (without this the scratch-as-evidence rule of v0.8.25 could never reach an adopted project) · reports/team/README.md (the index TEMPLATE inside the PROTECTED reports/ tree: its header is kit doctrine — status vocabulary, index scope — while its lines are the project's; diff the header, never the lines).
• TOOLING — template-owned; summarize changes, one approval for the batch: .claude/skills/** · .claude/hooks/** · .claude/*.py · .claude/claude-launch-wrapper.sh (kit-owned tools that sit at the .claude/ root — team-addresses, ritual-report, the launch wrapper) · .claude/agents/{researcher,verifier,auditor,observer,README}.md · .claude/rules/README.md (+ example) · tests/unit/test_keel_*.py · docs/security.md · docs/steering.md · docs/memory-files.md · .claude/keel-caps.example (the key reference; the project's own .claude/keel-caps stays PROTECTED) · docs/adr/0000-adr-template.md · docs/adr/README.md · docs/assets/ · CONTRIBUTING.md (kit-meta by its own first line) · folder README.mds.