File Reference
Everything Kalami creates, where it lives, and what it does.
.kalami/ — Experience and state
| File | Purpose |
|---|---|
index.md | Experience database — all rules ever learned |
state.json | Session counter, EXP, budget, hardened rules, diagnosis |
config.json | Detection results (language, framework, PM, verify commands) |
profile.json | Project stack profile, conventions, learned commands |
progress.md | Session history for cross-session continuity |
statusline.txt | Generated statusline for harness delivery |
plans/ | Active plans from the planning skill |
backup/ | Original CLAUDE.md backup (restored on uninstall) |
.claude/rules/ — Active rules
| File | Purpose |
|---|---|
kalami-workflow.md | Universal rules — commit format, branch naming, coding standards. Always active. |
kalami-rules.md | Learned rules — path-scoped, regenerated from index.md each session |
.claude/hooks/ — Session hooks
| File | Trigger | Purpose |
|---|---|---|
kalami-session.sh | SessionStart, PreCompact | Runs the learning loop |
kalami-userprompt.sh | UserPromptSubmit | Detects user corrections |
kalami-postedit.sh | PostToolUse (Edit/Write) | Tracks module activity, conventions, scope |
kalami-postbash.sh | PostToolUse (Bash) | Detects command errors |
kalami-verify.sh | PreToolUse (git commit/push) | Verify chain gate |
kalami-stop.sh | Stop | Report card, verified counting |
loop.sh | Internal | Loop engine |
loop-functions.sh | Internal | Shared functions for loop |
.claude/skills/ — Dev flow skills
| Skill | Purpose |
|---|---|
kalami-commit/SKILL.md | Atomic commit with verify chain |
kalami-push/SKILL.md | Push with full test suite, auto-PR |
kalami-release/SKILL.md | Version bump + changelog + tag |
kalami-review/SKILL.md | Code review checklist |
kalami-plan/SKILL.md | Multi-file planning workflow |
.claude/settings.json — Permissions
Kalami adds deny patterns to the permissions.deny array. Custom patterns you add are preserved across reinstall and uninstall.