README
Kasidit
Stop fighting your AI. Give it discipline instead. Mindful AI coding framework for Claude Code. Works the same on Opus, Sonnet, and Haiku.
Site: kasi web · Wiki: GitHub Wiki · Changelog: CHANGELOG.md
The problem
Your AI:
- confidently invents an API that doesn't exist,
- declares a fix "complete" without running the code,
- rewrites a working file because it "looked cleaner,"
- loops 40 minutes on a ghost bug.
These aren't model bugs. They're discipline gaps — AI lacks a grounded base, so it pattern-matches surface similarity and compounds errors.
The fix is not a bigger model. The fix is scaffolding: checklists, confidence labels, tier-aware rules, runtime verification, mission-driven scope.
Why it's the best
| Most prompt frameworks | Kasidit | |
|---|---|---|
| Vague request like "review this" | proceeds and guesses | refuses, demands narrowing |
AI claims [high] confidence | trusts it | runtime hook downgrades it if no Read/Bash call matches |
| Master agent spawns helpers, then edits files itself | nobody notices | hook flags master-orchestrator violation |
| Runs the same on Haiku as on Opus | "Haiku is too small" | tier-aware rules — Haiku gets MORE scaffolding, not less |
| Convention-only rules | model decides to ignore them | 5 runtime-enforced hooks + 16 prompt-level rules |
| Knowledge resets every session | one-shot prompts | Gravity hub persists patterns / runbooks / route-memory across projects |
| One audit = one whole-repo grep | slow + noisy | subgraph extraction — scope to 10 functions, not 1000 |
| Deploy procedure forgotten | re-figure it next time | /kasi-acknowledge captures it as a replayable runbook |
The real edge: discipline turns Haiku into a senior engineer's executor. On Opus it unlocks depth. On Haiku it replaces raw reasoning with checklists, verifier passes, and forced abstention. Same framework, every tier.
Proof
- 87.5% valid fix rate on a SWE-bench Lite sample (56/300 tasks, strict PASS 60.7%, v0.7.4)
- Production-tested on a 288K-line legacy PHP codebase
- 5 backend hooks. 21 slash commands. 8 specialist agents. 15 default checklists. 11 core rules — all enforced, not aspirational.
What you get
- 21 slash commands —
/kasi-review · security · fix · ui · backend · graph · struc · devopt · acknowledge · knowledge-list · cascade · init · scaffold · docs · status · promote · pull · sync · search · multi · wiki-sync /kasimode command — pick intensity:off / router / lite / full / ultra- 8 specialist agents —
architect-planner,audit-specialist(--focus=quality|security|perf),bug-hunter,deep-researcher,legacy-specialist,migration-specialist,refactor-surgeon,test-writer - 5 runtime hooks — prompt classifier, confidence-label verifier, backend-save recorder, update + drift check
- Master Orchestrator — main agent delegates; never executes strong work itself
- Gravity — two-tier knowledge: Centerlite hub + per-project Dcenterlite, with promote / pull / sync
- 15 default checklists — security · code-review · perf · backend across PHP / Node / Python / Go
- Tier-aware rules — tighter discipline on Haiku, full framework on Opus
Quick taste
> /kasi-fix the user export endpoint returns null on weekends
[kasidit] kind=bug-fix mode=lite history=12/14 avg_turns=2.1
Mission: user export returns null on weekends
Hypothesis: timezone offset on the cutoff filter — Sat/Sun rolls into Mon
Fix: app/Exports/UserExport.php:42 — use ->whereDate(..., $tz) not ->whereDay
Confidence: [medium] — pattern match, not yet runtime-verified
Verify: curl /api/users/export?on=2026-04-26 → expect 142 rows
Install
# In Claude Code
/plugin marketplace add kasidit-wansudon/kasidit
/plugin install kasidit@kasidit
Or clone and run bash plugins/kasidit/install.sh.
thClaws (v0.12+)
Kasidit also runs on thClaws — the native Rust agent harness:
git clone https://github.com/kasidit-wansudon/kasidit.git
cd kasidit
bash plugins/kasidit/install-thclaws.sh
~85% feature parity (4/5 hooks adapted to thClaws events; full SKILL.md + 21 commands + 8 agents + 15 checklists). See docs/thclaws-setup.md for hook event mapping and limitations.
Update
Already installed? Pull the latest release: