flowbook 0.1.2 → 0.1.4

package/README.de.md

@@ -89,6 +89,58 @@ Flowbook durchsucht standardmäßig folgende Muster:
 
 Ignoriert `node_modules/`, `.git/` und `dist/`.
 
+## KI-Agent-Fähigkeit
+
+`flowbook init` installiert automatisch KI-Agent-Fähigkeiten in alle unterstützten Codierungs-Agent-Verzeichnisse.
+Wenn ein Codierungs-Agent (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI usw.) das Schlüsselwort **"flowbook"** in Ihrer Eingabeaufforderung erkennt, wird er:
+
+1. Ihre Codebasis auf logische Abläufe analysieren (API-Routen, Authentifizierung, Zustandsverwaltung, Geschäftslogik usw.)
+2. Flowbook einrichten, falls noch nicht initialisiert
+3. `.flow.md`-Dateien mit Mermaid-Diagrammen für jeden bedeutenden Ablauf generieren
+4. Den Build überprüfen
+
+### Fähigkeit über CLI installieren
+
+Sie können die Fähigkeit auch eigenständig über [skills.sh](https://skills.sh) installieren:
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+Erkennt automatisch Ihre installierten Codierungs-Agenten und installiert die Fähigkeit in die richtigen Verzeichnisse.
+
+### Kompatible Agenten
+
+| Agent | Fähigkeitsort |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>Manuelle Fähigkeitsinstallation</summary>
+
+Wenn Sie `flowbook init` oder `npx skills add` nicht verwendet haben, kopieren Sie die Fähigkeit manuell:
+
+```bash
+# Beispiel: Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# Beispiel: Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+Ersetzen Sie das Verzeichnis durch den entsprechenden Pfad aus der Tabelle der kompatiblen Agenten.
+
+</details>
 ## Funktionsweise
 
 ```

package/README.es.md

@@ -89,6 +89,58 @@ Flowbook escanea estos patrones por defecto:
 
 Ignora `node_modules/`, `.git/` y `dist/`.
 
+## Habilidad de Agente IA
+
+`flowbook init` instala automáticamente habilidades de agente IA en todos los directorios de agentes de codificación soportados.
+Cuando un agente de codificación (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI, etc.) detecta la palabra clave **"flowbook"** en tu indicación, hará:
+
+1. Analizar tu base de código en busca de flujos lógicos (rutas API, autenticación, gestión de estado, lógica empresarial, etc.)
+2. Configurar Flowbook si aún no está inicializado
+3. Generar archivos `.flow.md` con diagramas Mermaid para cada flujo significativo
+4. Verificar la compilación
+
+### Instalar Habilidad via CLI
+
+También puedes instalar la habilidad de forma independiente usando [skills.sh](https://skills.sh):
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+Detecta automáticamente tus agentes de codificación instalados e instala la habilidad en los directorios correctos.
+
+### Agentes Compatibles
+
+| Agente | Ubicación de Habilidad |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>Instalación Manual de Habilidad</summary>
+
+Si no usaste `flowbook init` ni `npx skills add`, copia la habilidad manualmente:
+
+```bash
+# Ejemplo: Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# Ejemplo: Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+Reemplaza el directorio con la ruta apropiada de la tabla de Agentes Compatibles.
+
+</details>
 ## Cómo Funciona
 
 ```

package/README.fr.md

@@ -89,6 +89,58 @@ Flowbook analyse ces motifs par défaut :
 
 Ignore `node_modules/`, `.git/` et `dist/`.
 
+## Compétence Agent IA
+
+`flowbook init` installe automatiquement les compétences d'agent IA dans tous les répertoires d'agents de codage supportés.
+Lorsqu'un agent de codage (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI, etc.) détecte le mot-clé **"flowbook"** dans votre invite, il :
+
+1. Analyse votre base de code pour les flux logiques (routes API, authentification, gestion d'état, logique métier, etc.)
+2. Configure Flowbook s'il n'est pas déjà initialisé
+3. Génère des fichiers `.flow.md` avec des diagrammes Mermaid pour chaque flux significatif
+4. Vérifie la compilation
+
+### Installer la Compétence via CLI
+
+Vous pouvez aussi installer la compétence indépendamment avec [skills.sh](https://skills.sh) :
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+Détecte automatiquement vos agents de codage installés et installe la compétence dans les bons répertoires.
+
+### Agents Compatibles
+
+| Agent | Emplacement de Compétence |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>Installation Manuelle de Compétence</summary>
+
+Si vous n'avez pas utilisé `flowbook init` ni `npx skills add`, copiez la compétence manuellement :
+
+```bash
+# Exemple : Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# Exemple : Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+Remplacez le répertoire par le chemin approprié du tableau des Agents Compatibles.
+
+</details>
 ## Fonctionnement
 
 ```

package/README.ja.md

@@ -89,6 +89,58 @@ Flowbook はデフォルトで以下のパターンをスキャンします：
 
 `node_modules/`、`.git/`、`dist/` は無視します。
 
+## AI Agent Skill
+
+`flowbook init` はサポートされているすべてのコーディングエージェントディレクトリに AI エージェントスキルを自動的にインストールします。
+コーディングエージェント（Claude Code、OpenAI Codex、VS Code Copilot、Cursor、Gemini CLI など）がプロンプト内の **"flowbook"** キーワードを検出した場合、以下を実行します：
+
+1. コードベース内の論理的なフローを分析（API ルート、認証、状態管理、ビジネスロジックなど）
+2. まだ初期化されていない場合、Flowbook を設定
+3. すべての重要なフローに対して Mermaid ダイアグラム付き `.flow.md` ファイルを生成
+4. ビルドを検証
+
+### CLI でスキルをインストール
+
+[skills.sh](https://skills.sh) を使用してスキルを単独でインストールすることもできます：
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+インストール済みのコーディングエージェントを自動検出し、適切なディレクトリにスキルをインストールします。
+
+### 互換性のあるエージェント
+
+| エージェント | スキル位置 |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>手動スキルインストール</summary>
+
+`flowbook init` や `npx skills add` を使用しなかった場合、スキルを手動でコピーしてください：
+
+```bash
+# 例：Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# 例：Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+上の互換性テーブルのパスを参考に、適切なディレクトリに置き換えてください。
+
+</details>
 ## 仕組み
 
 ```

package/README.ko.md

@@ -89,6 +89,58 @@ Flowbook은 기본적으로 다음 패턴을 스캔합니다:
 
 `node_modules/`, `.git/`, `dist/`는 무시합니다.
 
+## AI Agent Skill
+
+`flowbook init`은 지원하는 모든 코딩 에이전트 디렉토리에 AI 에이전트 스킬을 자동으로 설치합니다.
+코딩 에이전트(Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI 등)가 프롬프트에서 **"flowbook"** 키워드를 감지하면 다음을 수행합니다:
+
+1. 코드베이스에서 논리적 흐름 분석 (API 라우트, 인증, 상태 관리, 비즈니스 로직 등)
+2. 아직 초기화되지 않았으면 Flowbook 설정
+3. 모든 중요한 흐름에 대해 Mermaid 다이어그램이 포함된 `.flow.md` 파일 생성
+4. 빌드 검증
+
+### CLI로 스킬 설치
+
+[skills.sh](https://skills.sh)를 사용하여 스킬을 독립적으로 설치할 수도 있습니다:
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+설치된 코딩 에이전트를 자동 감지하여 올바른 디렉토리에 스킬을 설치합니다.
+
+### 호환 에이전트
+
+| 에이전트 | 스킬 위치 |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>수동 스킬 설치</summary>
+
+`flowbook init`이나 `npx skills add`를 사용하지 않았다면 스킬을 수동으로 복사하세요:
+
+```bash
+# 예시: Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# 예시: Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+위 호환 에이전트 테이블의 경로를 참고하여 적절한 디렉토리로 교체하세요.
+
+</details>
 ## 동작 원리
 
 ```

package/README.md

@@ -89,6 +89,58 @@ Flowbook scans for these patterns by default:
 
 Ignores `node_modules/`, `.git/`, and `dist/`.
 
+## AI Agent Skill
+
+`flowbook init` automatically installs AI agent skills to all supported coding agent directories.
+When a coding agent (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI, etc.) detects the keyword **"flowbook"** in your prompt, it will:
+
+1. Analyze your codebase for logical flows (API routes, auth, state management, business logic, etc.)
+2. Set up Flowbook if not already initialized
+3. Generate `.flow.md` files with Mermaid diagrams for every significant flow
+4. Verify the build
+
+### Install Skill via CLI
+
+You can also install the skill standalone using [skills.sh](https://skills.sh):
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+This auto-detects your installed coding agents and installs the skill to the correct directories.
+
+### Compatible Agents
+
+| Agent | Skill Location |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>Manual Skill Installation</summary>
+
+If you didn't use `flowbook init` or `npx skills add`, copy the skill manually:
+
+```bash
+# Example: Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# Example: Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+Replace the directory with the appropriate path from the Compatible Agents table above.
+
+</details>
 ## How It Works
 
 ```

package/README.pt-BR.md

@@ -89,6 +89,58 @@ O Flowbook escaneia estes padrões por padrão:
 
 Ignora `node_modules/`, `.git/` e `dist/`.
 
+## Habilidade de Agente IA
+
+`flowbook init` instala automaticamente habilidades de agente IA em todos os diretórios de agentes de codificação suportados.
+Quando um agente de codificação (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI, etc.) detecta a palavra-chave **"flowbook"** no seu prompt, ele irá:
+
+1. Analisar sua base de código em busca de fluxos lógicos (rotas de API, autenticação, gerenciamento de estado, lógica de negócios, etc.)
+2. Configurar Flowbook se ainda não estiver inicializado
+3. Gerar arquivos `.flow.md` com diagramas Mermaid para cada fluxo significativo
+4. Verificar a compilação
+
+### Instalar Habilidade via CLI
+
+Você também pode instalar a habilidade de forma independente usando [skills.sh](https://skills.sh):
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+Detecta automaticamente seus agentes de codificação instalados e instala a habilidade nos diretórios corretos.
+
+### Agentes Compatíveis
+
+| Agente | Local da Habilidade |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>Instalação Manual de Habilidade</summary>
+
+Se você não usou `flowbook init` nem `npx skills add`, copie a habilidade manualmente:
+
+```bash
+# Exemplo: Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# Exemplo: Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+Substitua o diretório pelo caminho apropriado da tabela de Agentes Compatíveis.
+
+</details>
 ## Como Funciona
 
 ```

package/README.ru.md

@@ -89,6 +89,58 @@ Flowbook по умолчанию сканирует следующие шабл
 
 Игнорирует `node_modules/`, `.git/` и `dist/`.
 
+## Навык AI-агента
+
+`flowbook init` автоматически устанавливает навыки AI-агента во все поддерживаемые директории агентов кодирования.
+Когда агент кодирования (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI и т.д.) обнаружит ключевое слово **"flowbook"** в вашем промпте, он:
+
+1. Анализирует вашу базу кода на предмет логических потоков (API маршруты, аутентификация, управление состоянием, бизнес-логика и т.д.)
+2. Настраивает Flowbook, если он еще не инициализирован
+3. Генерирует файлы `.flow.md` с диаграммами Mermaid для каждого значимого потока
+4. Проверяет сборку
+
+### Установка навыка через CLI
+
+Вы также можете установить навык отдельно с помощью [skills.sh](https://skills.sh):
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+Автоматически определяет установленные агенты кодирования и устанавливает навык в нужные директории.
+
+### Совместимые агенты
+
+| Агент | Местонахождение навыка |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>Ручная установка навыка</summary>
+
+Если вы не использовали `flowbook init` или `npx skills add`, скопируйте навык вручную:
+
+```bash
+# Пример: Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# Пример: Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+Замените директорию на подходящий путь из таблицы совместимых агентов.
+
+</details>
 ## Как Это Работает
 
 ```

package/README.zh-CN.md

@@ -89,6 +89,58 @@ Flowbook 默认扫描以下模式：
 
 忽略 `node_modules/`、`.git/` 和 `dist/`。
 
+## AI Agent Skill
+
+`flowbook init` 自动将 AI 代理技能安装到所有支持的编码代理目录中。
+当编码代理（Claude Code、OpenAI Codex、VS Code Copilot、Cursor、Gemini CLI 等）检测到你的提示中有 **"flowbook"** 关键字时，它会：
+
+1. 分析你的代码库中的逻辑流（API 路由、认证、状态管理、业务逻辑等）
+2. 如果尚未初始化，设置 Flowbook
+3. 为每个重要流程生成包含 Mermaid 图表的 `.flow.md` 文件
+4. 验证构建
+
+### 通过 CLI 安装技能
+
+你也可以使用 [skills.sh](https://skills.sh) 独立安装技能：
+
+```bash
+npx skills add Epsilondelta-ai/flowbook
+```
+
+自动检测已安装的编码代理并将技能安装到正确的目录。
+
+### 兼容代理
+
+| 代理 | 技能位置 |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
+<details>
+<summary>手动技能安装</summary>
+
+如果你没有使用 `flowbook init` 或 `npx skills add`，请手动复制技能：
+
+```bash
+# 示例：Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# 示例：Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+```
+
+请参考上方兼容代理表格中的路径替换为适当的目录。
+
+</details>
 ## 工作原理
 
 ```

package/dist/cli.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 
 // src/node/init.ts
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
-import { resolve } from "path";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "fs";
+import { resolve, dirname } from "path";
 import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
 var EXAMPLE_FLOW = `---
 title: Example Flow
 category: Getting Started
@@ -72,6 +74,43 @@ async function initFlowbook() {
       console.log("  \u2713 Added flowbook-static to .gitignore");
     }
   }
+  const skillSrc = resolve(__dirname, "..", "src", "skills", "flowbook", "SKILL.md");
+  const skillDirs = [
+    resolve(cwd, ".claude", "skills", "flowbook"),
+    // Claude Code
+    resolve(cwd, ".agents", "skills", "flowbook"),
+    // OpenAI Codex / cross-tool alias
+    resolve(cwd, ".github", "skills", "flowbook"),
+    // VS Code / GitHub Copilot
+    resolve(cwd, ".agent", "skills", "flowbook"),
+    // Google Antigravity
+    resolve(cwd, ".gemini", "skills", "flowbook"),
+    // Gemini CLI
+    resolve(cwd, ".cursor", "skills", "flowbook"),
+    // Cursor
+    resolve(cwd, ".windsurf", "skills", "flowbook"),
+    // Windsurf (Codeium)
+    resolve(cwd, ".amp", "skills", "flowbook"),
+    // AmpCode
+    resolve(cwd, ".opencode", "skills", "flowbook")
+    // OpenCode / oh-my-opencode
+  ];
+  if (existsSync(skillSrc)) {
+    let installed = 0;
+    for (const dir of skillDirs) {
+      const dest = resolve(dir, "SKILL.md");
+      if (!existsSync(dest)) {
+        mkdirSync(dir, { recursive: true });
+        copyFileSync(skillSrc, dest);
+        installed++;
+      }
+    }
+    if (installed > 0) {
+      console.log(`  \u2713 Installed AI agent skill to ${installed} agent directories`);
+    } else {
+      console.log("  \u2713 AI agent skills already installed");
+    }
+  }
   const run = pm === "yarn" ? "yarn" : `${pm} run`;
   console.log("");
   console.log("  Next steps:");
@@ -189,11 +228,11 @@ function flowbookPlugin(options = {}) {
 }
 
 // src/node/server.ts
-import { resolve as resolve2, dirname } from "path";
-import { fileURLToPath } from "url";
-var __dirname = dirname(fileURLToPath(import.meta.url));
+import { resolve as resolve2, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
 function getClientDir() {
-  return resolve2(__dirname, "..", "src", "client");
+  return resolve2(__dirname2, "..", "src", "client");
 }
 function createConfig(options) {
   const cwd = options.cwd ?? process.cwd();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowbook",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "bin": {
     "flowbook": "./dist/cli.js"
@@ -12,7 +12,9 @@
   "scripts": {
     "dev": "vite",
     "build": "tsup",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "flowbook": "flowbook dev",
+    "build-flowbook": "flowbook build"
   },
   "dependencies": {
     "@tailwindcss/vite": "^4.0.0",
@@ -29,6 +31,7 @@
     "@types/node": "^25.3.3",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "flowbook": "^0.1.2",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0"
   }

package/src/node/init.ts

@@ -1,6 +1,9 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
-import { resolve } from "node:path";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
 import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
 
 const EXAMPLE_FLOW = `---
 title: Example Flow
@@ -85,6 +88,37 @@ export async function initFlowbook() {
     }
   }
 
+  // 5. Install AI agent skill to all supported agent directories
+  const skillSrc = resolve(__dirname, "..", "src", "skills", "flowbook", "SKILL.md");
+  const skillDirs = [
+    resolve(cwd, ".claude", "skills", "flowbook"),     // Claude Code
+    resolve(cwd, ".agents", "skills", "flowbook"),     // OpenAI Codex / cross-tool alias
+    resolve(cwd, ".github", "skills", "flowbook"),     // VS Code / GitHub Copilot
+    resolve(cwd, ".agent", "skills", "flowbook"),      // Google Antigravity
+    resolve(cwd, ".gemini", "skills", "flowbook"),     // Gemini CLI
+    resolve(cwd, ".cursor", "skills", "flowbook"),     // Cursor
+    resolve(cwd, ".windsurf", "skills", "flowbook"),   // Windsurf (Codeium)
+    resolve(cwd, ".amp", "skills", "flowbook"),        // AmpCode
+    resolve(cwd, ".opencode", "skills", "flowbook"),   // OpenCode / oh-my-opencode
+  ];
+
+  if (existsSync(skillSrc)) {
+    let installed = 0;
+    for (const dir of skillDirs) {
+      const dest = resolve(dir, "SKILL.md");
+      if (!existsSync(dest)) {
+        mkdirSync(dir, { recursive: true });
+        copyFileSync(skillSrc, dest);
+        installed++;
+      }
+    }
+    if (installed > 0) {
+      console.log(`  \u2713 Installed AI agent skill to ${installed} agent directories`);
+    } else {
+      console.log("  \u2713 AI agent skills already installed");
+    }
+  }
+
   const run = pm === "yarn" ? "yarn" : `${pm} run`;
   console.log("");
   console.log("  Next steps:");

package/src/skills/flowbook/SKILL.md

@@ -0,0 +1,499 @@
+---
+name: flowbook
+description: "Flowbook generator — analyzes codebase logic and generates Mermaid flowchart documentation (.flow.md). Auto-discovers functions, API routes, state machines, auth flows, data pipelines, and business logic, then produces browsable flowchart documentation. Triggers: 'flowbook', 'flow diagram', 'flowchart', 'generate flows', 'document flows', 'logic diagram'."
+license: MIT
+compatibility:
+  - Claude Code
+  - OpenAI Codex
+  - VS Code / GitHub Copilot
+  - Google Antigravity
+  - Gemini CLI
+  - Cursor
+  - Windsurf (Codeium)
+  - AmpCode
+  - OpenCode / oh-my-opencode
+metadata:
+  author: Epsilondelta
+  version: "1.0.0"
+  tags: flowbook, flowchart, mermaid, documentation, architecture, diagram, visualization
+---
+
+# flowbook — Flowchart Documentation Generator
+
+Analyze codebase logic → setup flowbook → generate `.flow.md` files → verify → build.
+
+**Execute ALL phases in order. Do NOT skip phases. Generate flows for ALL significant logic — not just a few.**
+
+---
+
+## Phase 1: Project Analysis
+
+### 1.1 Check Flowbook Existence
+
+Check if flowbook is already set up:
+
+- `package.json` has `"flowbook"` script → Already initialized, skip Phase 2
+- Otherwise → Proceed to Phase 2
+
+### 1.2 Detect Package Manager
+
+| Lockfile | PM |
+|----------|----|
+| `bun.lock` or `bun.lockb` | bun |
+| `pnpm-lock.yaml` | pnpm |
+| `yarn.lock` | yarn |
+| `package-lock.json` | npm |
+
+### 1.3 Detect Framework & Language
+
+Read `package.json` dependencies:
+
+| Dependency | Framework |
+|------------|-----------|
+| `next` | Next.js |
+| `nuxt` | Nuxt |
+| `@sveltejs/kit` | SvelteKit |
+| `svelte` (no kit) | Svelte |
+| `vue` (no nuxt) | Vue |
+| `@angular/core` | Angular |
+| `express` / `fastify` / `hono` / `koa` | Node.js Backend |
+| `@nestjs/core` | NestJS |
+| `react` (no next) | React |
+| `django` / `flask` / `fastapi` | Python Backend |
+| `spring` | Java/Kotlin Backend |
+| `gin` / `echo` / `fiber` | Go Backend |
+
+Language detection:
+- `tsconfig.json` → TypeScript
+- `*.go` files → Go
+- `*.py` files → Python
+- `*.java` / `*.kt` files → Java/Kotlin
+- Otherwise → JavaScript
+
+### 1.4 Detect Source Structure
+
+Scan for actual source directories:
+
+**Frontend:**
+- `src/components/`, `src/pages/`, `src/views/`, `src/routes/`
+- `src/app/`, `app/`, `pages/`, `components/`
+- `src/store/`, `src/hooks/`, `src/composables/`, `src/lib/`
+
+**Backend:**
+- `src/routes/`, `src/api/`, `src/controllers/`, `src/services/`
+- `src/middleware/`, `src/handlers/`, `src/resolvers/`
+- `routes/`, `api/`, `controllers/`, `services/`
+
+**Shared:**
+- `src/utils/`, `src/helpers/`, `src/lib/`
+- `src/models/`, `src/schemas/`, `src/types/`
+
+Only include directories that actually exist.
+
+---
+
+## Phase 2: Flowbook Setup
+
+### 2.1 Initialize Flowbook
+
+```bash
+npx flowbook@latest init
+```
+
+This will:
+- Install `flowbook` as a devDependency
+- Add `"flowbook"` and `"build-flowbook"` scripts to `package.json`
+- Create `flows/example.flow.md` as a starter template
+- Add `flowbook-static` to `.gitignore`
+
+### 2.2 Verify Setup
+
+Check that:
+- `package.json` contains `"flowbook": "flowbook dev"` script
+- `flowbook` is in `devDependencies`
+- `flows/` directory exists
+
+### 2.3 Remove Example Flow
+
+After verification, delete the example to replace with real flows:
+
+```bash
+rm flows/example.flow.md
+```
+
+---
+
+## Phase 3: Codebase Analysis & Flow Discovery
+
+This is the **most critical phase**. Deeply analyze the codebase to identify all significant logic flows.
+
+### 3.1 Flow Categories to Discover
+
+Scan the codebase for these flow types. For EACH one found, plan a `.flow.md` file:
+
+#### A. API / Route Flows
+- HTTP request → middleware chain → handler → response
+- REST endpoints (GET, POST, PUT, DELETE)
+- GraphQL resolvers (Query, Mutation)
+- WebSocket message flows
+- RPC handlers
+
+#### B. Authentication & Authorization
+- Login / signup / logout flows
+- Token refresh / session management
+- OAuth flows (redirect → callback → token exchange)
+- Role-based access control (RBAC) decision trees
+- Password reset / email verification
+
+#### C. Data Flows
+- CRUD operations (Create → Validate → Save → Respond)
+- Data pipeline / ETL (Extract → Transform → Load)
+- Form submission → validation → API call → state update
+- File upload → process → store → respond
+- Cache strategies (read-through, write-through, invalidation)
+
+#### D. State Management
+- Global state flow (Redux, Zustand, Pinia, Vuex)
+- Action → Reducer → State → UI update cycle
+- Side effects (Sagas, Thunks, Effects)
+- Optimistic updates → rollback on failure
+
+#### E. Business Logic
+- Order processing / checkout flow
+- Payment flow (initiate → process → confirm / refund)
+- Notification system (trigger → queue → send → track)
+- Scheduling / cron job flows
+- Approval workflows (submit → review → approve/reject)
+
+#### F. Error Handling
+- Global error boundary flow
+- Retry strategies (exponential backoff)
+- Fallback / circuit breaker patterns
+- Error logging / monitoring pipeline
+
+#### G. DevOps & Infrastructure
+- CI/CD pipeline stages
+- Deployment flow
+- Health check / monitoring flow
+- Database migration flow
+
+#### H. Lifecycle & Initialization
+- App bootstrap / initialization sequence
+- Component lifecycle flows
+- Server startup → middleware registration → route binding → listen
+- Database connection → migration → seeding → ready
+
+### 3.2 How to Analyze
+
+For each source file:
+
+1. **Read the file** — understand its purpose
+2. **Trace the flow** — follow function calls, conditionals, async operations
+3. **Identify decision points** — if/else, switch, try/catch, early returns
+4. **Map dependencies** — what other modules/services does it call?
+5. **Note error paths** — what happens when things fail?
+
+### 3.3 Flow Classification
+
+For each discovered flow, determine:
+
+| Field | How to Determine |
+|-------|-----------------|
+| `title` | Clear, descriptive name (e.g., "User Login Flow") |
+| `category` | Group by domain: Authentication, API, Data, State, Business, DevOps, etc. |
+| `tags` | Relevant keywords for filtering |
+| `order` | Lower = more important. Core flows first. |
+| `description` | One-line summary of what the flow does |
+
+### 3.4 Skip Rules
+
+Do NOT create flows for:
+- Trivial utility functions (formatDate, slugify, etc.)
+- Simple getters/setters with no logic
+- Type definitions / interfaces only
+- Test files
+- Config files (unless they represent a complex pipeline)
+- Files that already have corresponding `.flow.md`
+
+---
+
+## Phase 4: Flow File Generation
+
+### 4.1 File Placement
+
+Place ALL flow files in the `flows/` directory at project root:
+
+```
+flows/
+├── auth-login.flow.md
+├── auth-oauth.flow.md
+├── api-user-crud.flow.md
+├── data-order-processing.flow.md
+├── state-cart-management.flow.md
+└── devops-ci-pipeline.flow.md
+```
+
+**Naming convention**: `{category}-{name}.flow.md` (kebab-case)
+
+### 4.2 Flow File Template
+
+Every `.flow.md` file MUST follow this structure:
+
+````markdown
+---
+title: {Descriptive Title}
+category: {Category Name}
+tags: [{tag1}, {tag2}, {tag3}]
+order: {number}
+description: {One-line description}
+---
+
+```mermaid
+flowchart TD
+    A[Start] --> B{Decision}
+    B -->|Yes| C[Action]
+    B -->|No| D[Other Action]
+    C --> E[End]
+    D --> E
+```
+````
+
+### 4.3 Mermaid Diagram Guidelines
+
+#### Node Types
+
+```mermaid
+flowchart TD
+    A[Regular Step]         %% Rectangle: action/process
+    B{Decision Point}       %% Diamond: if/else, switch
+    C([Start / End])        %% Stadium: entry/exit points
+    D[(Database)]           %% Cylinder: DB operations
+    E[[Sub-routine]]        %% Subroutine: function call
+    F>Event / Signal]       %% Flag: async event, webhook
+    G{{Validation}}         %% Hexagon: validation step
+    H[/Input/]              %% Parallelogram: user input
+    I[\Output\]             %% Reverse parallelogram: response
+```
+
+#### Edge Labels
+
+```mermaid
+flowchart TD
+    A{Authenticated?} -->|Yes| B[Dashboard]
+    A -->|No| C[Login Page]
+    D[API Call] -->|200 OK| E[Process Data]
+    D -->|4xx/5xx| F[Handle Error]
+    G[Submit] -->|Valid| H[Save]
+    G -->|Invalid| I[Show Errors]
+```
+
+#### Styling
+
+Apply consistent colors to node types:
+
+```mermaid
+flowchart TD
+    A([Start]) --> B[Process]
+    B --> C{Decision}
+    C -->|Yes| D[(Save to DB)]
+    C -->|No| E[Handle Error]
+    D --> F([End])
+    E --> F
+
+    style A fill:#6366f1,color:#fff
+    style F fill:#6366f1,color:#fff
+    style C fill:#f59e0b,color:#000
+    style D fill:#10b981,color:#fff
+    style E fill:#ef4444,color:#fff
+```
+
+**Color convention:**
+- `#6366f1` (indigo) — Start/End points
+- `#10b981` (green) — Success paths, DB operations
+- `#f59e0b` (amber) — Decision points
+- `#ef4444` (red) — Error paths, failures
+- `#8b5cf6` (purple) — External service calls
+- `#3b82f6` (blue) — Processing steps
+- Default (no style) — Regular steps
+
+#### Subgraphs for Complex Flows
+
+Use subgraphs to group related steps:
+
+```mermaid
+flowchart TD
+    A([Request]) --> B
+
+    subgraph Middleware
+        B[Auth Check] --> C[Rate Limit] --> D[Parse Body]
+    end
+
+    D --> E
+
+    subgraph Handler
+        E[Validate Input] --> F{Valid?}
+        F -->|Yes| G[Process]
+        F -->|No| H[Return 400]
+    end
+
+    G --> I[(Save)]
+    I --> J[\200 OK/]
+    H --> K[\400 Error/]
+```
+
+### 4.4 Complexity Guidelines
+
+- **Simple flows** (3-8 nodes): Single linear or branching flow
+- **Medium flows** (8-15 nodes): Multiple branches, some subgraphs
+- **Complex flows** (15-25 nodes): Multiple subgraphs, parallel paths
+- **Do NOT exceed 25 nodes** per diagram — split into multiple flows instead
+
+If a flow is too complex:
+1. Create a high-level overview flow
+2. Create detailed sub-flows for each section
+3. Reference sub-flows in the overview's description
+
+### 4.5 Real-World Example
+
+For a Next.js API route `app/api/auth/login/route.ts`:
+
+````markdown
+---
+title: User Login
+category: Authentication
+tags: [auth, login, jwt, api]
+order: 1
+description: POST /api/auth/login — validates credentials and returns JWT tokens
+---
+
+```mermaid
+flowchart TD
+    A([POST /api/auth/login]) --> B[/Parse Request Body/]
+    B --> C{{Validate Email & Password}}
+    C -->|Invalid| D[\400 Bad Request/]
+    C -->|Valid| E[(Find User by Email)]
+    E -->|Not Found| F[\401 Unauthorized/]
+    E -->|Found| G{{Compare Password Hash}}
+    G -->|Mismatch| F
+    G -->|Match| H[Generate JWT Access Token]
+    H --> I[Generate Refresh Token]
+    I --> J[(Save Refresh Token)]
+    J --> K[\200 OK + Tokens/]
+
+    style A fill:#6366f1,color:#fff
+    style C fill:#f59e0b,color:#000
+    style G fill:#f59e0b,color:#000
+    style E fill:#10b981,color:#fff
+    style J fill:#10b981,color:#fff
+    style D fill:#ef4444,color:#fff
+    style F fill:#ef4444,color:#fff
+    style K fill:#10b981,color:#fff
+```
+````
+
+---
+
+## Phase 5: Verification
+
+### 5.1 Syntax Check
+
+For each generated `.flow.md` file:
+
+1. Verify YAML frontmatter is valid (title, category present)
+2. Verify mermaid code block is properly fenced (``` mermaid ```)
+3. Verify mermaid syntax has no obvious errors (matched brackets, valid node IDs)
+
+### 5.2 Build Verification
+
+```bash
+npx flowbook build 2>&1
+```
+
+If build fails:
+- Read error output
+- Fix the issue (likely malformed mermaid syntax)
+- Retry until build succeeds
+
+### 5.3 Visual Verification
+
+Start dev server and verify rendering:
+
+```bash
+npx flowbook dev &
+FB_PID=$!
+sleep 3
+```
+
+If the `playwright` skill is available, load it and:
+
+1. Navigate to `http://localhost:6200`
+2. Wait for Flowbook UI to load
+3. Check sidebar — all flow categories should appear
+4. Click through each flow — verify diagrams render (no error messages)
+5. Screenshot any failures
+
+```bash
+kill $FB_PID 2>/dev/null
+```
+
+### 5.4 Fix-and-Retry Loop
+
+If mermaid diagrams fail to render:
+1. Common issue: special characters in labels — wrap in quotes: `A["Label with (parens)"]`
+2. Common issue: reserved keywords — prefix with text: `A[End Point]` not `A[End]` alone as node content after using `End` as ID
+3. Re-run build verification
+4. Repeat until all diagrams render
+
+---
+
+## Phase 6: Summary Report
+
+Print a summary:
+
+```
+=== Flowbook Report ===
+Framework: {detected framework}
+Language: {detected language}
+
+Flows generated: {N}
+Categories:
+  - Authentication: {N} flows
+  - API: {N} flows
+  - Data: {N} flows
+  - State: {N} flows
+  - Business Logic: {N} flows
+  - DevOps: {N} flows
+
+Files created:
+  - flows/{filename}.flow.md — {title}
+  - flows/{filename}.flow.md — {title}
+  ...
+
+Build: ✅ / ❌
+```
+
+---
+
+## Troubleshooting
+
+### Flowbook init fails
+- **No package.json**: Run `npm init -y` first
+- **Permission error**: Check write permissions on project directory
+
+### Mermaid syntax errors
+- **Brackets**: Every `[`, `{`, `(` must be closed
+- **Special characters in labels**: Wrap in double quotes: `A["User's Input"]`
+- **Arrow syntax**: Use `-->` for solid, `-.->` for dotted, `==>` for thick
+- **Node ID reuse**: Each node ID must be unique per diagram. Reuse ID to reference same node.
+- **Subgraph naming**: Subgraph labels cannot contain special characters
+
+### Diagrams too complex
+- Split into overview + detail flows
+- Use subgraphs to group related logic
+- Keep each diagram under 25 nodes
+- Link related flows via description references
+
+### Build fails
+- Check mermaid version compatibility (flowbook uses Mermaid 11+)
+- Validate YAML frontmatter (no tabs, proper indentation)
+- Ensure code blocks use triple backticks with `mermaid` language tag