5113c35914
9 stale count references updated: - README.md: 12 agents / 43 skills / 12 hooks / 82 blocks / 36 primitives - docs/INSTALL.md: 33→36 (full profile), new crates enumerated - docs/REFERENCE.md: 25→36 crates, 10→12 hooks, 39→43 skills; v0.27 note on 11 crates awaiting full per-crate REFERENCE entries - docs/ARCHITECTURE.md: 10→12 hooks (added capability hooks) - docs/SUBSTRATE-SCHEMA.md: 25→36 crates (count-only refresh, locked) - docs/SECURITY.md: battle matrix floors 79/39/10 → 82/43/12 - PLUGIN.md: 24→36 Rust primitives NOT modified (intentional): - CHANGELOG.md (auto-generated by kei-changelog) - docs/WHY.md (stable philosophy) - docs/TAXONOMY.md (vocab stable) - docs/HANDOFF-WAKE.md (historical snapshot, frozen by design) - docs/CONVERGENCE-PLAN.md (strategy analysis, frozen) - docs/AGENT-SUBSTRATE-SCHEMA.md (phase plan counts are plan-of-record, not current state) - SCHEMA-LOCKED.md / SCHEMA-UNLOCKED.md / AGENT-ROLES.md (registry) - USB-BRAIN-GUIDE-* (platform guides, no counts) Follow-up flagged: REFERENCE.md needs per-crate expansion for 11 new crates (kei-agent-runtime, kei-capability, kei-provision, etc). That's doc rewrite not audit — separate PR. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
80 lines
4.9 KiB
Markdown
80 lines
4.9 KiB
Markdown
# KeiSeiKit
|
||
|
||
**Your AI agents, structured. One manifest, eleven AI assistants. A brain that follows you across machines.**
|
||
|
||
Drop-in kit for Claude Code, Cursor, Continue, and Zed. Install once — get a 12-agent fleet that remembers yesterday's decisions, sleeps at night to consolidate what it learned, and lives on a USB stick you can carry between computers.
|
||
|
||
## Install in one line
|
||
|
||
```bash
|
||
/plugin marketplace add KeiSei84/KeiSeiKit
|
||
/plugin install keisei@keisei-marketplace
|
||
```
|
||
|
||
That's it. 12 agents appear in Claude Code, 43 skills become callable as `/self-audit`, `/compose-solution`, `/schema-design`, and nightly consolidation is wired. [Other install paths →](./docs/INSTALL.md)
|
||
|
||
## What you actually get
|
||
|
||
### 🌙 Your AI sleeps at night
|
||
|
||
You worked all day. At bedtime you type `/sleep-on-it what's the right database for X` and close the laptop. While you sleep, a remote agent reads your day's traces, extracts patterns, and by morning your memory-repo has a report waiting. `git pull` → read → decide. Nothing auto-injected. [How sleep works →](./docs/SLEEP-LAYER.md)
|
||
|
||
### 💾 One brain, any client
|
||
|
||
```bash
|
||
keisei mount /Volumes/MyBrain
|
||
```
|
||
|
||
Your agents, memory, artifacts, and per-platform MCP binaries all live on a directory — USB stick, iCloud, S3, anything. One command mounts it into Claude Code + Cursor + Continue + Zed simultaneously. Move the drive to another computer — same state is there. [Full setup →](./docs/INSTALL.md#the-keisei-cli)
|
||
|
||
### 🧩 Write agent rules once, ship everywhere
|
||
|
||
A manifest + reusable blocks compiles into a `.md` file Claude Code reads. Edit one block — every agent using it rebuilds automatically. Same `kei-critic` behaves identically on every machine that installs the kit. [Architecture →](./docs/ARCHITECTURE.md)
|
||
|
||
### 🛡️ Catches mistakes before they commit
|
||
|
||
Fabricated citations. Secrets in a push. Three failed retries on the same bug. All caught at the hook layer, before anything hits your repo. You don't configure it — it ships wired. [What's watched →](./docs/SECURITY.md)
|
||
|
||
### 🌉 One source, eleven AI tools
|
||
|
||
Your rules get emitted to `.cursorrules`, `AGENTS.md`, `.github/copilot-instructions.md`, Cursor MDC, Windsurf, Gemini.md, Aider, Continue, Junie, Replit, and plain AGENTS.md — in one command. Switch between tools without rewriting your setup.
|
||
|
||
## Batteries included
|
||
|
||
- **12 agents** — `kei-code-implementer`, `kei-critic`, `kei-validator`, `kei-security-auditor`, `kei-architect`, `kei-researcher`, `kei-ml-implementer`, and more (all namespaced `kei-*` so they coexist peacefully with anything you already have)
|
||
- **43 skills** — one-command pipelines: `/new-project`, `/schema-design`, `/api-design`, `/ci-scaffold`, `/auth-setup`, `/observability-setup`, `/self-audit`, `/sleep-on-it`, ...
|
||
- **12 hooks** — pre-commit safety net, always on
|
||
- **82 behavioral blocks** — tested patterns you compose into your own agents
|
||
- **36 Rust primitives** — for the jobs where Python silently corrupts your data
|
||
|
||
Every symbol, flag, and exit code: [docs/REFERENCE.md](./docs/REFERENCE.md)
|
||
|
||
## Under the hood (only if you care)
|
||
|
||
Constructor Pattern: one file, one concern. TOML manifests are the source of truth. A Rust assembler compiles them to the Markdown Claude Code expects. When you edit a block, a PostToolUse hook rebuilds every affected agent. Rust is the backbone because the type system catches the class of mistakes LLMs most often introduce — `None` vs `[]`, missing `.await`, unhandled `Result` — at compile time, so they can't ship. Python is reserved for places where Python is genuinely better.
|
||
|
||
Full build pipeline, cross-tool bridge mechanics, meta-composer, sleep-layer internals → [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md).
|
||
|
||
## Docs
|
||
|
||
| | |
|
||
|---|---|
|
||
| [INSTALL.md](./docs/INSTALL.md) | All install paths, profiles, `keisei` CLI, hook controls |
|
||
| [REFERENCE.md](./docs/REFERENCE.md) | Every primitive, hook, skill with flags and exit codes |
|
||
| [ARCHITECTURE.md](./docs/ARCHITECTURE.md) | Build pipeline, bridges, meta-composer |
|
||
| [SLEEP-LAYER.md](./docs/SLEEP-LAYER.md) | Nightly cycle + self-audit |
|
||
| [SECURITY.md](./docs/SECURITY.md) | Threat model + mitigations |
|
||
| [USB-BRAIN-GUIDE.md](./docs/USB-BRAIN-GUIDE.md) | Portable brain — macOS / Linux / Windows |
|
||
| [WHY.md](./docs/WHY.md) | The full story of why this exists |
|
||
| [CHANGELOG.md](./CHANGELOG.md) | What changed, version by version |
|
||
| [PLUGIN.md](./PLUGIN.md) | Anthropic plugin-format details |
|
||
|
||
## About
|
||
|
||
Built by Denis Parfionovich (<parfionovich@keilab.io>) while running 4–8 parallel Claude Code terminals every day. What you're looking at is the scaffolding that makes that possible — shared now so you don't have to build your own.
|
||
|
||
Forks and PRs welcome. Open an issue at [github.com/KeiSei84/KeiSeiKit/issues](https://github.com/KeiSei84/KeiSeiKit/issues) — a well-formulated problem is already half the solution.
|
||
|
||
## License
|
||
|
||
MIT. See [LICENSE](./LICENSE).
|