kvitt/README-agents.md

Kvitt agent starter kit (seeded 2026-10-17 from the Ebb project)

What is here and why:

• CLAUDE.md: the working rules (orchestrator + Opus agents, worktrees, serial builds, gate, phone, owner steps). Fill in the marked blanks before the first plan.
• docs/HANDOFF.md, docs/decisions.md: templates for the one handoff and the one decisions log.
• prompts/ORCHESTRATOR-prompt.md: paste this to start an orchestrator session.
• tools/gradle-serial.sh: one Gradle build at a time across all worktrees (lock in /tmp/kvitt-gradle.lock).
• tools/clean-builds.sh: delete build output in every checkout and worktree; --dry-run lists.
• tools/install-git-hooks.sh + tools/git-hooks/pre-commit: secrets guard + fast tests; adjust the Gradle task.
• tools/dependency-report/latest.py: version drift of gradle/libs.versions.toml (needs that file).
• gradle.properties, gradle/gradle-daemon-jvm.properties: the JDK 25 pin and caching flags. Merge into the generated project's files.
• .gitignore: starter list of what never reaches git.
• .claude/memory-seed/: the agent memories generalised from Ebb. They are already installed in ~/.claude/projects/-Users-jhag-projects-kvitt/memory/ (the folder Claude Code loads for ~/projects/kvitt), so an orchestrator opened in this folder starts with them. This copy is for reference and for seeding another machine.
• Outside the repo, already in place on this MacBook: ~/.gradle/init.d/cache-retention.gradle.kts (Gradle cache cleanup, 7 days).

Not copied on purpose: Ebb's SPEC, plans, architecture-check build-logic and product memories. Write Kvitt's own.