-
Notifications
You must be signed in to change notification settings - Fork 1
v0.11.0
Released: 2026-04-30
Theme: Six new mission commands extend Kasidit beyond UI fixes and reviews into backend work, DevOps planning, and replayable runbooks β all under the existing Master Orchestrator + tier discipline. File-path standardisation: hook files renamed kasidit-* β kasi-*.
v0.11 fills the holes a real backend developer hits every week: vague backend audit scopes, repo-wide grep noise, deploy procedures that get re-figured each time, and "what calls what?" questions that send AI on whole-repo grep tours. The new commands address each:
-
/kasi-backendβ multi-mode counterpart to/kasi-ui(fix Β· audit Β· scaffold Β· design Β· perf Β· security) -
/kasi-graphβ function call graph, with subgraph extraction for scoped audits -
/kasi-strucβ project state cache (auto-bridge: kasi-* commands read state, never rescan) -
/kasi-devoptβ DevOps mission (deploy plan, env diff, data flow, secrets, runbook). Outputs the plan; never runs the deploy. -
/kasi-acknowledgeβ capture last-performed steps as a replayable runbook with auto-redaction -
/kasi-knowledge-listβ browse + step-by-step replay of stored runbooks
Backend counterpart of /kasi-ui. Routes a backend mission to the right specialist with the right checklist for the detected stack.
/kasi-backend fix "store endpoint returns 500 on duplicate sku"
/kasi-backend audit app/Http/Controllers/SaleController.php
/kasi-backend perf api/sales/index
/kasi-backend security routes/api.php
/kasi-backend scaffold "POST /api/transfers β warehouse stock move"
/kasi-backend design "background job for daily inventory snapshot"
Stack auto-detection (in order):
-
composer.json+laravel/frameworkβ Laravel mode β loadsbackend-laravel.mdchecklist -
package.json+ (express/fastify/hono/@nestjs/core/koa) β Node mode β loadsbackend-node.md - Both β asks user which surface
- Neither β agnostic, loads
backend-api-design.md
For audit and perf, the command auto-runs /kasi-graph build first and offers the user the chance to scope the audit to a subgraph instead of the whole repo.
Build, query, and extract function-level subgraphs. Letss audits scope to a slice (10 functions) instead of the whole codebase (1000+).
/kasi-graph build # full scan, write FUNCTIONS.jsonl + HOTSPOTS.md
/kasi-graph extract SaleController::store # subgraph (depth=2) for one entry point
/kasi-graph impact StockService::deduct # who breaks if I change this?
/kasi-graph trace Migrate::run # full callee tree
/kasi-graph cycles # detected cycles
/kasi-graph dead # potentially dead functions (no callers)
Storage:
.kasidit/
βββ FUNCTIONS.jsonl # one fn per line β {file, fn, calls, called_by, lang, line}
βββ HOTSPOTS.md # human-readable: top hubs / top callers / cycles / isolated / dead
βββ subgraph-<id>.md # extracted subgraph for current mission
Implementation: regex MVP for PHP + JS/TS in plugins/kasidit/skills/kasidit/scripts/build_graph.py. The ast-grep AST path is stubbed for v0.12 (per-fn-body call attribution).
The "auto-bridge" is the big idea: every kasi-* command should read project structure from a cached state file instead of re-walking the repo. v0.11 ships the state writer; subsequent commands consume it.
/kasi-struc build # full scan
/kasi-struc refresh # incremental β only re-scan files changed since last_sync
/kasi-struc show # print summary
/kasi-struc tree # directory tree (depth 3)
/kasi-struc module Services/StockService
/kasi-struc path app/Http/Controllers/SaleController.php
/kasi-struc bridge # which kasi-* commands consume which STATE files
/kasi-struc verify # walk repo, flag stale entries
Storage:
.kasidit/STATE/
βββ structure.json # top-level β dirs, files, languages, sizes, frameworks
βββ modules.jsonl # one module per line β name, files, lang counts, exports
βββ routes.jsonl # HTTP routes β method, path, handler, framework
βββ config.json # detected configs (composer.json / package.json / wrangler.toml / etc.)
βββ changelog.jsonl # append-only state-change log
βββ last_sync # timestamp + git ref of last build
The auto-bridge contract: a kasi-* command checks last_sync vs current git rev-parse HEAD. If the cache is current, use it. If stale, run refresh (incremental β only changed files) and append to changelog.jsonl before reasoning.
Implementation: plugins/kasidit/skills/kasidit/scripts/build_struc.py. Routes parsed for Laravel (Route::get/post/..., Route::resource) + Node (Express, Fastify, Hono, NestJS controllers). git diff powers incremental refresh; mtime fallback when no git.
DevOps counterpart of /kasi-backend. Deploy planning, env diffs, secret audits, runbook scaffolding β never executes the deploy itself. Outputs the plan; user runs the commands.
/kasi-devopt deploy staging # build the deploy plan (preflight + commands + rollback)
/kasi-devopt env diff # diff env vars across .env templates and environments
/kasi-devopt data map # rebuild .kasidit/STATE/data_flow.json
/kasi-devopt data connect kasion-site ai-router # document a new service edge
/kasi-devopt secrets audit # find hardcoded keys, propose rotation plan
/kasi-devopt pipeline ci.yml # inspect / suggest changes to CI pipeline
/kasi-devopt runbook "rollback kas-sass" # generate or update a runbook entry
/kasi-devopt health prod # check /healthz, queue depth, error rate, deploy state
Platform auto-detect: GitHub Actions, GitLab CI, Cloudflare Workers/Pages (wrangler.toml), Vercel, Netlify, Docker, Terraform, Kubernetes (k8s/ or helm/), Heroku-style (Procfile), Fly.io, Serverless Framework, Platform.sh.
Hard rules: /kasi-devopt never runs git push, kubectl apply, wrangler publish, or any deploy command. It writes a plan; the user executes.
After a manual deploy / migration / hotfix, capture the steps as a replayable runbook with auto-redaction.
/kasi-acknowledge # infer kind from session, draft entry
/kasi-acknowledge template deploy # blank deploy template
/kasi-acknowledge from-history HEAD~5..HEAD # capture from explicit git range
/kasi-acknowledge update deploy-kas-sass-staging # bump `last_run`, append history
/kasi-acknowledge link <slug-a> <slug-b> # related runbooks (sequence or alternative)
/kasi-knowledge-list # browse all (grouped by kind)
/kasi-knowledge-list recent # last 10 by `last_run`
/kasi-knowledge-list tag staging # filter
/kasi-knowledge-list show <n|slug> # print one runbook
/kasi-knowledge-list replay <slug> # interactive walkthrough β print one step at a time, wait for user
/kasi-knowledge-list stats # counts per kind, freshness summary
/kasi-knowledge-list stale # not run in >90 days (review candidates)
Storage:
.kasidit/knowledge/runbooks/
βββ INDEX.md # auto-maintained list + pick-by-number
βββ <kind>/
βββ <slug>-<YYYYMMDD>.md
Default redactions strip *KEY* / *TOKEN* / *SECRET* / *PASSWORD* env vars, Authorization: Bearer ... strings, DB URLs with credentials, and private IP ranges (asks user before stripping).
Replay never executes commands β Kasidit prints each step and waits for user. Same discipline as /kasi-devopt deploy: the user runs the commands; Kasidit only walks them through.
plugins/kasidit/defaults/checklists/:
-
backend-laravel.mdβ sections AβM + severity guide (Routing, Validation, Auth+AuthZ, Eloquent+Query, SQL injection, Mass-assignment+IDOR, File handling, Service layer, Queue+Jobs, API response, Config+secrets, Logging, Testing). -
backend-node.mdβ sections AβN (Framework+Routing, Validation, Auth+AuthZ, ORM, SQL/NoSQL injection, Operator injection / mass-assignment, File handling, Service layer, Async+concurrency, HTTP client, Logging, Config+secrets, Error handling, Dependencies). -
backend-api-design.mdβ stack-agnostic API design rules (Resource modeling, HTTP methods, Status codes, Request/Response shape, Versioning, Auth, Rate limit, Caching, Idempotency, Documentation, Edge cases, Security cross-cutting).
Total default checklists: 12 β 15.
plugins/kasidit/skills/kasidit/scripts/:
-
build_graph.{sh,py}β function call graph builder. Regex MVP for PHP + JS/TS. ast-grep AST path stubbed. -
build_struc.{sh,py}β project state cache writer. Full + incremental modes.git diffbased refresh.
install.sh extended (section 5b) to seed scripts dir at install time.
For consistency with the /kasi-* command namespace, all hook files were renamed:
| Before | After |
|---|---|
kasidit-route.py |
kasi-route.py |
kasidit-verify.py |
kasi-verify.py |
kasidit-record.py |
kasi-record.py |
kasidit-log.{py,sh} |
kasi-log.{py,sh} |
kasidit-update-check.sh |
kasi-update-check.sh |
kasidit-drift-check.sh |
kasi-drift-check.sh |
Skill kasidit-default β kasi-default.
install.sh, test_hooks.py, SKILL.md, README.md updated.
Retained intentionally (would break protocol or existing JSONL stores):
- Internal emit-token protocol:
[kasidit-log],[kasidit-pattern],[kasidit-memory],[kasidit-rule],[kasidit-verify],[kasidit-record]. Thekasi-record.pyparser regex accepts both[kasi-X]and[kasidit-X]so existing emit lines keep working. - Brand prefix in route output:
[kasidit] kind=... mode=.... - Env vars:
KASIDIT_CENTER,KASIDIT_PROJECT_DIR,KASIDIT_LOG_DIR. - Top-level skill / plugin / GitHub names:
~/.claude/skills/kasidit/,~/.claude/plugins/marketplaces/kasidit/,kasidit-wansudon/kasidit.
By v0.10, Kasidit had a great UI mission flow (/kasi-ui), great review/security audit flows, but no first-class backend equivalent. Backend missions either fell into /kasi-fix (too narrow) or /kasi-review (too broad). Auditing meant a whole-repo grep tour. Deploy procedures got re-figured every time. v0.11 closes those gaps.
The auto-bridge concept (/kasi-struc) is the long-term play: every kasi-* command should consume a cached project model rather than rebuild it. v0.11 ships the writer; v0.12+ wires more readers.
- Function call graph is regex-MVP. Per-file call attribution is shared across all functions in the file. Per-fn-body call attribution requires brace-tracking β deferred to ast-grep AST path in v0.12.
-
/kasi-strucbuilder ships, but most kasi- commands do not yet read STATE/.* They will be wired to consume the cache progressively. Today,/kasi-backend auditis the only command that explicitly readsSTATE/+FUNCTIONS.jsonl. -
/kasi-devoptis AI-driven β there's no separate Python runner. The command file documents the flow; the AI executes it via Read / Write / Bash tools. - Runbook redaction is heuristic. It strips obvious env-var-name patterns and Bearer tokens, but cannot catch project-specific secrets (custom var names, hardcoded constants in commands). Always review captured runbooks before promoting to the Centerlite hub.
For existing installs:
-
git pullthe marketplace, or/plugin marketplace update kasiditin Claude Code. - Re-run
bash plugins/kasidit/install.shβ idempotent. It will:- Copy renamed hook files (
kasi-*) to~/.claude/hooks/. Oldkasidit-*files in your hooks dir can be deleted manually or kept as backward-compat symlinks. - Update
~/.claude/settings.jsonhook commands to reference the new file names. - Seed the 3 new backend checklists into
~/.claude/skills/kasidit/center/checklists/. - Seed the 4 scripts into
~/.claude/skills/kasidit/scripts/.
- Copy renamed hook files (
- The
[kasidit-log]emit token remains valid β the parser accepts both forms during the transition window.
| v0.10 | v0.11 | |
|---|---|---|
| Slash commands | 15 | 21 |
| Default checklists | 12 | 15 |
| Specialist agents | 8 + 3 stubs | 8 (stubs removed) |
| Runtime hooks | 5 | 5 (renamed) |
| Helper scripts (bundled) | 0 | 4 |
Lines in SKILL.md
|
~1320 | ~1340 |
- Commands β full reference, now including the 6 new commands
-
Backend-Hooks β same 5 hooks, now under
kasi-*filenames - Checklists β 15 default checklists with descriptions
- Master-Orchestrator β discipline that all new commands respect
- v0.10.0 β previous release (Mode system + runtime hooks)
-
v0.9.2 β Gravity Pattern (the hub
/kasi-acknowledgewrites runbooks into)
Repo β’ Discussions β’ Issues β’ Changelog β’ Security β’ Contributing β’ MIT β’ Β© Kasidit Wansudon
Kasidit
Core
- Commands
- Kasi-Mode π₯ v0.10
- Backend-Hooks π₯ v0.10
- Model Tiers
- Gravity Pattern
- Multi-Agent-Orchestration
- Claude Design Integration
- UI Override Mode
- FAQ
Version History
- Version History β overview
- v0.13.0 β thClaws (Consolidated) π¦
- v0.12.0 β thClaws Runtime Support π¦
- v0.11.0 β Backend + Bridge + Runbook π
- v0.10.0 β Mode + Backend Hooks
- v0.9.2 β Gravity
- v0.9.1 β Master Orchestrator
- v0.9.0 β Claude Design
- v0.8.0 β Tier Cascade
- v0.7.4 β SWE-bench
- v0.3.0 β Tier adaptation
- v0.2.1 β Docs protocol
- v0.2.0 β UI Override
- v0.1.0 β Core
Concepts
Commands
- Kasi-Init
- Kasi-Review
- Kasi-Security
- Kasi-Fix
- Kasi-Ui
- Kasi-Cascade
- Kasi-Multi
- Kasi-Scaffold
- Kasi-Docs
- Kasi-Status
- Kasi-Promote
- Kasi-Pull
- Kasi-Sync
- Kasi-Search
- Kasi-Wiki-Sync
Agents
- Agent-Architect-Planner
- Agent-Audit-Specialist π₯ v0.10
- Agent-Bug-Hunter
- Agent-Deep-Researcher
- Agent-Legacy-Specialist
- Agent-Migration-Specialist
- Agent-Refactor-Surgeon
- Agent-Test-Writer
Deprecated v0.10 (stubs β audit-specialist --focus=..., removed in v0.11)
-
Agent-Code-Reviewer β
--focus=quality -
Agent-Security-Auditor β
--focus=security -
Agent-Perf-Profiler β
--focus=perf