1 files changed, 10 insertions, 0 deletions

diff --git a/CLAUDE.md b/CLAUDE.md
index e54032e..d2e968a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -45,9 +45,19 @@ All renderer→main communication goes through named IPC channels registered in
 ### Database
 SQLite at `app.getPath("userData")/claude-flow.db`. Tables: `projects`, `sessions`, `messages`. Foreign keys ON, WAL mode enabled.
 
+Schema migrations: `db/index.ts::getDb()` calls `initSchema()` which uses `CREATE TABLE IF NOT EXISTS`. **New columns require explicit `ALTER TABLE` migration** run after `initSchema()`.
+
+### SDK Permission Modes
+`PermissionMode` values: `'default' | 'acceptEdits' | 'bypassPermissions' | 'plan' | 'dontAsk'`
+
+**Known bug**: `permissionMode: 'bypassPermissions'` requires a companion flag `allowDangerouslySkipPermissions: true` in the `query()` options. This flag is currently missing from `claude/index.ts`.
+
+`allowedTools: string[]` in the SDK maps to Claude Code's `--allowedTools` CLI flag and supports patterns like `'Bash(git *)'` to auto-allow only specific Bash command forms.
+
 ## Important Notes
 
 - `ANTHROPIC_API_KEY` env var must be set before launching
 - Artifacts are stored in `.claude-flow/sessions/` inside the target project
 - `bypassPermissions` mode is a user-controlled toggle in implement phase only
 - Token usage (from `SDKResultMessage.usage`) is displayed in the ActionBar
+- No git library in dependencies — use Node.js `child_process` (built-in) for git operations