flowbook 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/README.de.md +66 -3
  2. package/README.es.md +66 -3
  3. package/README.fr.md +66 -3
  4. package/README.ja.md +66 -3
  5. package/README.ko.md +66 -3
  6. package/README.md +66 -3
  7. package/README.pt-BR.md +66 -3
  8. package/README.ru.md +66 -3
  9. package/README.zh-CN.md +66 -3
  10. package/dist/cli.js +53 -6
  11. package/package.json +5 -2
  12. package/src/node/init.ts +46 -2
  13. package/src/skills/flowbook/SKILL.md +499 -0
package/README.de.md CHANGED
@@ -12,9 +12,6 @@ Storybook für Flussdiagramme. Erkennt automatisch Mermaid-Diagrammdateien in Ih
12
12
  ## Schnellstart
13
13
 
14
14
  ```bash
15
- # Installieren
16
- npm install -D flowbook
17
-
18
15
  # Initialisieren — fügt Skripte + Beispieldatei hinzu
19
16
  npx flowbook@latest init
20
17
 
@@ -92,6 +89,72 @@ Flowbook durchsucht standardmäßig folgende Muster:
92
89
 
93
90
  Ignoriert `node_modules/`, `.git/` und `dist/`.
94
91
 
92
+ ## KI-Agent-Fähigkeit
93
+
94
+ `flowbook init` installiert automatisch KI-Agent-Fähigkeiten in alle unterstützten Codierungs-Agent-Verzeichnisse.
95
+ 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:
96
+
97
+ 1. Ihre Codebasis auf logische Abläufe analysieren (API-Routen, Authentifizierung, Zustandsverwaltung, Geschäftslogik usw.)
98
+ 2. Flowbook einrichten, falls noch nicht initialisiert
99
+ 3. `.flow.md`-Dateien mit Mermaid-Diagrammen für jeden bedeutenden Ablauf generieren
100
+ 4. Den Build überprüfen
101
+
102
+ ### Manuelle Fähigkeitsinstallation
103
+
104
+ Wenn Sie `flowbook init` nicht verwendet haben, kopieren Sie die Fähigkeit manuell:
105
+
106
+ ```bash
107
+ # Claude Code
108
+ mkdir -p .claude/skills/flowbook
109
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
110
+
111
+ # OpenAI Codex
112
+ mkdir -p .agents/skills/flowbook
113
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
114
+
115
+ # VS Code / GitHub Copilot
116
+ mkdir -p .github/skills/flowbook
117
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
118
+
119
+ # Google Antigravity
120
+ mkdir -p .agent/skills/flowbook
121
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
122
+
123
+ # Gemini CLI
124
+ mkdir -p .gemini/skills/flowbook
125
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
126
+
127
+ # Cursor
128
+ mkdir -p .cursor/skills/flowbook
129
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
130
+
131
+ # Windsurf (Codeium)
132
+ mkdir -p .windsurf/skills/flowbook
133
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
134
+
135
+ # AmpCode
136
+ mkdir -p .amp/skills/flowbook
137
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
138
+
139
+ # OpenCode / oh-my-opencode
140
+ mkdir -p .opencode/skills/flowbook
141
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
142
+ ```
143
+
144
+ ### Kompatible Agenten
145
+
146
+ | Agent | Fähigkeitsort |
147
+ |-------|---------------|
148
+ | Claude Code | `.claude/skills/flowbook/SKILL.md` |
149
+ | OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
150
+ | VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
151
+ | Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
152
+ | Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
153
+ | Cursor | `.cursor/skills/flowbook/SKILL.md` |
154
+ | Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
155
+ | AmpCode | `.amp/skills/flowbook/SKILL.md` |
156
+ | OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
157
+
95
158
  ## Funktionsweise
96
159
 
97
160
  ```
package/README.es.md CHANGED
@@ -12,9 +12,6 @@ Storybook para diagramas de flujo. Descubre automáticamente archivos de diagram
12
12
  ## Inicio Rápido
13
13
 
14
14
  ```bash
15
- # Instalar
16
- npm install -D flowbook
17
-
18
15
  # Inicializar — agrega scripts + archivo de ejemplo
19
16
  npx flowbook@latest init
20
17
 
@@ -92,6 +89,72 @@ Flowbook escanea estos patrones por defecto:
92
89
 
93
90
  Ignora `node_modules/`, `.git/` y `dist/`.
94
91
 
92
+ ## Habilidad de Agente IA
93
+
94
+ `flowbook init` instala automáticamente habilidades de agente IA en todos los directorios de agentes de codificación soportados.
95
+ 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á:
96
+
97
+ 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.)
98
+ 2. Configurar Flowbook si aún no está inicializado
99
+ 3. Generar archivos `.flow.md` con diagramas Mermaid para cada flujo significativo
100
+ 4. Verificar la compilación
101
+
102
+ ### Instalación Manual de Habilidad
103
+
104
+ Si no usaste `flowbook init`, copia la habilidad manualmente:
105
+
106
+ ```bash
107
+ # Claude Code
108
+ mkdir -p .claude/skills/flowbook
109
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
110
+
111
+ # OpenAI Codex
112
+ mkdir -p .agents/skills/flowbook
113
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
114
+
115
+ # VS Code / GitHub Copilot
116
+ mkdir -p .github/skills/flowbook
117
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
118
+
119
+ # Google Antigravity
120
+ mkdir -p .agent/skills/flowbook
121
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
122
+
123
+ # Gemini CLI
124
+ mkdir -p .gemini/skills/flowbook
125
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
126
+
127
+ # Cursor
128
+ mkdir -p .cursor/skills/flowbook
129
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
130
+
131
+ # Windsurf (Codeium)
132
+ mkdir -p .windsurf/skills/flowbook
133
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
134
+
135
+ # AmpCode
136
+ mkdir -p .amp/skills/flowbook
137
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
138
+
139
+ # OpenCode / oh-my-opencode
140
+ mkdir -p .opencode/skills/flowbook
141
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
142
+ ```
143
+
144
+ ### Agentes Compatibles
145
+
146
+ | Agente | Ubicación de Habilidad |
147
+ |-------|---------------|
148
+ | Claude Code | `.claude/skills/flowbook/SKILL.md` |
149
+ | OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
150
+ | VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
151
+ | Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
152
+ | Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
153
+ | Cursor | `.cursor/skills/flowbook/SKILL.md` |
154
+ | Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
155
+ | AmpCode | `.amp/skills/flowbook/SKILL.md` |
156
+ | OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
157
+
95
158
  ## Cómo Funciona
96
159
 
97
160
  ```
package/README.fr.md CHANGED
@@ -12,9 +12,6 @@ Storybook pour les diagrammes de flux. Découvre automatiquement les fichiers de
12
12
  ## Démarrage Rapide
13
13
 
14
14
  ```bash
15
- # Installer
16
- npm install -D flowbook
17
-
18
15
  # Initialiser — ajoute les scripts + fichier d'exemple
19
16
  npx flowbook@latest init
20
17
 
@@ -92,6 +89,72 @@ Flowbook analyse ces motifs par défaut :
92
89
 
93
90
  Ignore `node_modules/`, `.git/` et `dist/`.
94
91
 
92
+ ## Compétence Agent IA
93
+
94
+ `flowbook init` installe automatiquement les compétences d'agent IA dans tous les répertoires d'agents de codage supportés.
95
+ 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 :
96
+
97
+ 1. Analyse votre base de code pour les flux logiques (routes API, authentification, gestion d'état, logique métier, etc.)
98
+ 2. Configure Flowbook s'il n'est pas déjà initialisé
99
+ 3. Génère des fichiers `.flow.md` avec des diagrammes Mermaid pour chaque flux significatif
100
+ 4. Vérifie la compilation
101
+
102
+ ### Installation Manuelle de Compétence
103
+
104
+ Si vous n'avez pas utilisé `flowbook init`, copiez la compétence manuellement :
105
+
106
+ ```bash
107
+ # Claude Code
108
+ mkdir -p .claude/skills/flowbook
109
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
110
+
111
+ # OpenAI Codex
112
+ mkdir -p .agents/skills/flowbook
113
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
114
+
115
+ # VS Code / GitHub Copilot
116
+ mkdir -p .github/skills/flowbook
117
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
118
+
119
+ # Google Antigravity
120
+ mkdir -p .agent/skills/flowbook
121
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
122
+
123
+ # Gemini CLI
124
+ mkdir -p .gemini/skills/flowbook
125
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
126
+
127
+ # Cursor
128
+ mkdir -p .cursor/skills/flowbook
129
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
130
+
131
+ # Windsurf (Codeium)
132
+ mkdir -p .windsurf/skills/flowbook
133
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
134
+
135
+ # AmpCode
136
+ mkdir -p .amp/skills/flowbook
137
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
138
+
139
+ # OpenCode / oh-my-opencode
140
+ mkdir -p .opencode/skills/flowbook
141
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
142
+ ```
143
+
144
+ ### Agents Compatibles
145
+
146
+ | Agent | Emplacement de Compétence |
147
+ |-------|---------------|
148
+ | Claude Code | `.claude/skills/flowbook/SKILL.md` |
149
+ | OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
150
+ | VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
151
+ | Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
152
+ | Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
153
+ | Cursor | `.cursor/skills/flowbook/SKILL.md` |
154
+ | Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
155
+ | AmpCode | `.amp/skills/flowbook/SKILL.md` |
156
+ | OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
157
+
95
158
  ## Fonctionnement
96
159
 
97
160
  ```
package/README.ja.md CHANGED
@@ -12,9 +12,6 @@
12
12
  ## クイックスタート
13
13
 
14
14
  ```bash
15
- # インストール
16
- npm install -D flowbook
17
-
18
15
  # 初期化 — スクリプト + サンプルファイルを追加
19
16
  npx flowbook@latest init
20
17
 
@@ -92,6 +89,72 @@ Flowbook はデフォルトで以下のパターンをスキャンします：
92
89
 
93
90
  `node_modules/`、`.git/`、`dist/` は無視します。
94
91
 
92
+ ## AI Agent Skill
93
+
94
+ `flowbook init` はサポートされているすべてのコーディングエージェントディレクトリに AI エージェントスキルを自動的にインストールします。
95
+ コーディングエージェント（Claude Code、OpenAI Codex、VS Code Copilot、Cursor、Gemini CLI など）がプロンプト内の **"flowbook"** キーワードを検出した場合、以下を実行します：
96
+
97
+ 1. コードベース内の論理的なフローを分析（API ルート、認証、状态管理、ビジネスロジックなど）
98
+ 2. まだ初期化されていない場合、Flowbook を設定
99
+ 3. すべての重要なフローに対して Mermaid ダイアグラム付き `.flow.md` ファイルを生成
100
+ 4. ビルドを検証
101
+
102
+ ### 手動スキルインストール
103
+
104
+ `flowbook init` を使用しなかった場合、スキルを手動でコピーしてください：
105
+
106
+ ```bash
107
+ # Claude Code
108
+ mkdir -p .claude/skills/flowbook
109
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
110
+
111
+ # OpenAI Codex
112
+ mkdir -p .agents/skills/flowbook
113
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
114
+
115
+ # VS Code / GitHub Copilot
116
+ mkdir -p .github/skills/flowbook
117
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
118
+
119
+ # Google Antigravity
120
+ mkdir -p .agent/skills/flowbook
121
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
122
+
123
+ # Gemini CLI
124
+ mkdir -p .gemini/skills/flowbook
125
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
126
+
127
+ # Cursor
128
+ mkdir -p .cursor/skills/flowbook
129
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
130
+
131
+ # Windsurf (Codeium)
132
+ mkdir -p .windsurf/skills/flowbook
133
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
134
+
135
+ # AmpCode
136
+ mkdir -p .amp/skills/flowbook
137
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
138
+
139
+ # OpenCode / oh-my-opencode
140
+ mkdir -p .opencode/skills/flowbook
141
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
142
+ ```
143
+
144
+ ### 互換性のあるエージェント
145
+
146
+ | エージェント | スキル位置 |
147
+ |-------|---------------|
148
+ | Claude Code | `.claude/skills/flowbook/SKILL.md` |
149
+ | OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
150
+ | VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
151
+ | Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
152
+ | Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
153
+ | Cursor | `.cursor/skills/flowbook/SKILL.md` |
154
+ | Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
155
+ | AmpCode | `.amp/skills/flowbook/SKILL.md` |
156
+ | OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
157
+
95
158
  ## 仕組み
96
159
 
97
160
  ```
package/README.ko.md CHANGED
@@ -12,9 +12,6 @@
12
12
  ## 빠른 시작
13
13
 
14
14
  ```bash
15
- # 설치
16
- npm install -D flowbook
17
-
18
15
  # 초기화 — 스크립트 + 예제 파일 추가
19
16
  npx flowbook@latest init
20
17
 
@@ -92,6 +89,72 @@ Flowbook은 기본적으로 다음 패턴을 스캔합니다:
92
89
 
93
90
  `node_modules/`, `.git/`, `dist/`는 무시합니다.
94
91
 
92
+ ## AI Agent Skill
93
+
94
+ `flowbook init`은 지원하는 모든 코딩 에이전트 디렉토리에 AI 에이전트 스킬을 자동으로 설치합니다.
95
+ 코딩 에이전트(Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI 등)가 프롬프트에서 **"flowbook"** 키워드를 감지하면 다음을 수행합니다:
96
+
97
+ 1. 코드베이스에서 논리적 흐름 분석 (API 라우트, 인증, 상태 관리, 비즈니스 로직 등)
98
+ 2. 아직 초기화되지 않았으면 Flowbook 설정
99
+ 3. 모든 중요한 흐름에 대해 Mermaid 다이어그램이 포함된 `.flow.md` 파일 생성
100
+ 4. 빌드 검증
101
+
102
+ ### 수동 스킬 설치
103
+
104
+ `flowbook init`을 사용하지 않았다면 스킬을 수동으로 복사하세요:
105
+
106
+ ```bash
107
+ # Claude Code
108
+ mkdir -p .claude/skills/flowbook
109
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
110
+
111
+ # OpenAI Codex
112
+ mkdir -p .agents/skills/flowbook
113
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
114
+
115
+ # VS Code / GitHub Copilot
116
+ mkdir -p .github/skills/flowbook
117
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
118
+
119
+ # Google Antigravity
120
+ mkdir -p .agent/skills/flowbook
121
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
122
+
123
+ # Gemini CLI
124
+ mkdir -p .gemini/skills/flowbook
125
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
126
+
127
+ # Cursor
128
+ mkdir -p .cursor/skills/flowbook
129
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
130
+
131
+ # Windsurf (Codeium)
132
+ mkdir -p .windsurf/skills/flowbook
133
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
134
+
135
+ # AmpCode
136
+ mkdir -p .amp/skills/flowbook
137
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
138
+
139
+ # OpenCode / oh-my-opencode
140
+ mkdir -p .opencode/skills/flowbook
141
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
142
+ ```
143
+
144
+ ### 호환 에이전트
145
+
146
+ | 에이전트 | 스킬 위치 |
147
+ |-------|---------------|
148
+ | Claude Code | `.claude/skills/flowbook/SKILL.md` |
149
+ | OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
150
+ | VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
151
+ | Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
152
+ | Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
153
+ | Cursor | `.cursor/skills/flowbook/SKILL.md` |
154
+ | Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
155
+ | AmpCode | `.amp/skills/flowbook/SKILL.md` |
156
+ | OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
157
+
95
158
  ## 동작 원리
96
159
 
97
160
  ```
package/README.md CHANGED
@@ -12,9 +12,6 @@ Storybook for flowcharts. Auto-discovers Mermaid diagram files from your codebas
12
12
  ## Quick Start
13
13
 
14
14
  ```bash
15
- # Install
16
- npm install -D flowbook
17
-
18
15
  # Initialize — adds scripts + example file
19
16
  npx flowbook@latest init
20
17
 
@@ -92,6 +89,72 @@ Flowbook scans for these patterns by default:
92
89
 
93
90
  Ignores `node_modules/`, `.git/`, and `dist/`.
94
91
 
92
+ ## AI Agent Skill
93
+
94
+ `flowbook init` automatically installs AI agent skills to all supported coding agent directories.
95
+ When a coding agent (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI, etc.) detects the keyword **"flowbook"** in your prompt, it will:
96
+
97
+ 1. Analyze your codebase for logical flows (API routes, auth, state management, business logic, etc.)
98
+ 2. Set up Flowbook if not already initialized
99
+ 3. Generate `.flow.md` files with Mermaid diagrams for every significant flow
100
+ 4. Verify the build
101
+
102
+ ### Manual Skill Installation
103
+
104
+ If you didn't use `flowbook init`, copy the skill manually:
105
+
106
+ ```bash
107
+ # Claude Code
108
+ mkdir -p .claude/skills/flowbook
109
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
110
+
111
+ # OpenAI Codex
112
+ mkdir -p .agents/skills/flowbook
113
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
114
+
115
+ # VS Code / GitHub Copilot
116
+ mkdir -p .github/skills/flowbook
117
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
118
+
119
+ # Google Antigravity
120
+ mkdir -p .agent/skills/flowbook
121
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
122
+
123
+ # Gemini CLI
124
+ mkdir -p .gemini/skills/flowbook
125
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
126
+
127
+ # Cursor
128
+ mkdir -p .cursor/skills/flowbook
129
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
130
+
131
+ # Windsurf (Codeium)
132
+ mkdir -p .windsurf/skills/flowbook
133
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
134
+
135
+ # AmpCode
136
+ mkdir -p .amp/skills/flowbook
137
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
138
+
139
+ # OpenCode / oh-my-opencode
140
+ mkdir -p .opencode/skills/flowbook
141
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
142
+ ```
143
+
144
+ ### Compatible Agents
145
+
146
+ | Agent | Skill Location |
147
+ |-------|---------------|
148
+ | Claude Code | `.claude/skills/flowbook/SKILL.md` |
149
+ | OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
150
+ | VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
151
+ | Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
152
+ | Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
153
+ | Cursor | `.cursor/skills/flowbook/SKILL.md` |
154
+ | Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
155
+ | AmpCode | `.amp/skills/flowbook/SKILL.md` |
156
+ | OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
157
+
95
158
  ## How It Works
96
159
 
97
160
  ```
package/README.pt-BR.md CHANGED
@@ -12,9 +12,6 @@ Storybook para fluxogramas. Descobre automaticamente arquivos de diagramas Merma
12
12
  ## Início Rápido
13
13
 
14
14
  ```bash
15
- # Instalar
16
- npm install -D flowbook
17
-
18
15
  # Inicializar — adiciona scripts + arquivo de exemplo
19
16
  npx flowbook@latest init
20
17
 
@@ -92,6 +89,72 @@ O Flowbook escaneia estes padrões por padrão:
92
89
 
93
90
  Ignora `node_modules/`, `.git/` e `dist/`.
94
91
 
92
+ ## Habilidade de Agente IA
93
+
94
+ `flowbook init` instala automaticamente habilidades de agente IA em todos os diretórios de agentes de codificação suportados.
95
+ 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á:
96
+
97
+ 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.)
98
+ 2. Configurar Flowbook se ainda não estiver inicializado
99
+ 3. Gerar arquivos `.flow.md` com diagramas Mermaid para cada fluxo significativo
100
+ 4. Verificar a compilação
101
+
102
+ ### Instalação Manual de Habilidade
103
+
104
+ Se você não usou `flowbook init`, copie a habilidade manualmente:
105
+
106
+ ```bash
107
+ # Claude Code
108
+ mkdir -p .claude/skills/flowbook
109
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
110
+
111
+ # OpenAI Codex
112
+ mkdir -p .agents/skills/flowbook
113
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
114
+
115
+ # VS Code / GitHub Copilot
116
+ mkdir -p .github/skills/flowbook
117
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
118
+
119
+ # Google Antigravity
120
+ mkdir -p .agent/skills/flowbook
121
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
122
+
123
+ # Gemini CLI
124
+ mkdir -p .gemini/skills/flowbook
125
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
126
+
127
+ # Cursor
128
+ mkdir -p .cursor/skills/flowbook
129
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
130
+
131
+ # Windsurf (Codeium)
132
+ mkdir -p .windsurf/skills/flowbook
133
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
134
+
135
+ # AmpCode
136
+ mkdir -p .amp/skills/flowbook
137
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
138
+
139
+ # OpenCode / oh-my-opencode
140
+ mkdir -p .opencode/skills/flowbook
141
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
142
+ ```
143
+
144
+ ### Agentes Compatíveis
145
+
146
+ | Agente | Local da Habilidade |
147
+ |-------|---------------|
148
+ | Claude Code | `.claude/skills/flowbook/SKILL.md` |
149
+ | OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
150
+ | VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
151
+ | Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
152
+ | Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
153
+ | Cursor | `.cursor/skills/flowbook/SKILL.md` |
154
+ | Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
155
+ | AmpCode | `.amp/skills/flowbook/SKILL.md` |
156
+ | OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
157
+
95
158
  ## Como Funciona
96
159
 
97
160
  ```
package/README.ru.md CHANGED
@@ -12,9 +12,6 @@ Storybook для блок-схем. Автоматически обнаружи
12
12
  ## Быстрый Старт
13
13
 
14
14
  ```bash
15
- # Установка
16
- npm install -D flowbook
17
-
18
15
  # Инициализация — добавляет скрипты + файл-пример
19
16
  npx flowbook@latest init
20
17
 
@@ -92,6 +89,72 @@ Flowbook по умолчанию сканирует следующие шабл
92
89
 
93
90
  Игнорирует `node_modules/`, `.git/` и `dist/`.
94
91
 
92
+ ## Навык AI-агента
93
+
94
+ `flowbook init` автоматически устанавливает навыки AI-агента во все поддерживаемые директории агентов кодирования.
95
+ Когда агент кодирования (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI и т.д.) обнаружит ключевое слово **"flowbook"** в вашем промпте, он:
96
+
97
+ 1. Анализирует вашу базу кода на предмет логических потоков (API маршруты, аутентификация, управление состоянием, бизнес-логика и т.д.)
98
+ 2. Настраивает Flowbook, если он еще не инициализирован
99
+ 3. Генерирует файлы `.flow.md` с диаграммами Mermaid для каждого значимого потока
100
+ 4. Проверяет сборку
101
+
102
+ ### Настройка навыка вручную
103
+
104
+ Если вы не использовали `flowbook init`, скопируйте навык вручную:
105
+
106
+ ```bash
107
+ # Claude Code
108
+ mkdir -p .claude/skills/flowbook
109
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
110
+
111
+ # OpenAI Codex
112
+ mkdir -p .agents/skills/flowbook
113
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
114
+
115
+ # VS Code / GitHub Copilot
116
+ mkdir -p .github/skills/flowbook
117
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
118
+
119
+ # Google Antigravity
120
+ mkdir -p .agent/skills/flowbook
121
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
122
+
123
+ # Gemini CLI
124
+ mkdir -p .gemini/skills/flowbook
125
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
126
+
127
+ # Cursor
128
+ mkdir -p .cursor/skills/flowbook
129
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
130
+
131
+ # Windsurf (Codeium)
132
+ mkdir -p .windsurf/skills/flowbook
133
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
134
+
135
+ # AmpCode
136
+ mkdir -p .amp/skills/flowbook
137
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
138
+
139
+ # OpenCode / oh-my-opencode
140
+ mkdir -p .opencode/skills/flowbook
141
+ cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
142
+ ```
143
+
144
+ ### Осведомленные агенты
145
+
146
+ | Агент | Местонахождение навыка |
147
+ |-------|---------------|
148
+ | Claude Code | `.claude/skills/flowbook/SKILL.md` |
149
+ | OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
150
+ | VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
151
+ | Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
152
+ | Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
153
+ | Cursor | `.cursor/skills/flowbook/SKILL.md` |
154
+ | Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
155
+ | AmpCode | `.amp/skills/flowbook/SKILL.md` |
156
+ | OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
157
+
95
158
  ## Как Это Работает
96
159
 
97
160
  ```