From 76520e4a9edccdbefffaf9c785c20c68aecb282c Mon Sep 17 00:00:00 2001 From: Parfii-bot Date: Tue, 21 Apr 2026 03:36:18 +0800 Subject: [PATCH] docs(readme): clarify block usage split + backup-on-reinstall disclaimer Explains that 8 of 34 blocks are used by shipped manifests; the other 26 feed the /new-agent wizard. Adds a v0.1.1 disclaimer that re-running install.sh backs up kit-owned directories and hook files to .bak-TIMESTAMP. --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 023d4ea..77f26ec 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,9 @@ cd KeiSeiKit 5. Generates agent `.md` files in-place with `AGENT_ROOT=~/.claude/agents assemble --in-place` 6. Copies the three hooks and six skills -After install, the only remaining step is merging `settings-snippet.json` into your `~/.claude/settings.json` to activate the hooks. +After install, the only remaining step is merging `settings-snippet.json` into your `~/.claude/settings.json` to activate the hooks. You can do this automatically with `./install.sh --activate-hooks` or answer `y` at the end-of-install TTY prompt. + +> **Re-install disclaimer (v0.1.1):** `install.sh` is idempotent for clean state but **overwrites kit-owned `_blocks/`, `_templates/`, `_assembler/`, `hooks/`, and `skills/` on re-run** — local modifications under those directories are backed up to `.bak-TIMESTAMP/` (or, for shared hook files, to `.bak-TIMESTAMP`). User-owned `_manifests/*.toml` are never overwritten. ## What you get @@ -38,6 +40,8 @@ After install, the only remaining step is merging `settings-snippet.json` into y | Hooks | 3 | `assemble-agents` (PostToolUse), `assemble-validate` (PreToolUse Bash), `no-hand-edit-agents` (PreToolUse Edit/Write) | | Skills | 6 | `new-agent`, `research`, `test-gen`, `pr-review`, `refactor`, `debug-deep` | +Of the 34 blocks, the **8 base blocks** (`baseline`, `evidence-grading`, `memory-protocol`, `rule-pre-dev-gate`, `rule-test-first`, `rule-error-budget`, `rule-double-audit`, `rule-math-first`) are referenced directly by the 14 shipped manifests. The remaining **26 blocks** (`stack-*`, `deploy-*`, `api-*`, `scraper-*`, `domain-*`) are a library consumed by the `/new-agent` wizard: when you compose a project specialist, the wizard picks the appropriate stack / deploy / API / scraper / domain blocks and emits a manifest that references them. The kit's generic 14 agents do not import them by default. + ## Creating a new agent Run the wizard in Claude Code: