takomi 2.1.39 → 2.1.40

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 (26) hide show
  1. package/README.md +217 -422
  2. package/assets/.agent/skills/takomi-flow/SKILL.md +10 -1
  3. package/docs/features/TakomiFlow_Portable_Plugin.md +7 -3
  4. package/docs/takomi-flow-onboarding.md +10 -0
  5. package/package.json +1 -1
  6. package/plugins/takomi-flow/assets/capabilities.json +33 -1
  7. package/plugins/takomi-flow/assets/request.schema.json +24 -0
  8. package/plugins/takomi-flow/assets/result.schema.json +1 -0
  9. package/plugins/takomi-flow/assets/templates/image-request.json +4 -0
  10. package/plugins/takomi-flow/assets/templates/video-request.json +4 -0
  11. package/plugins/takomi-flow/references/flow-provider-contract.md +25 -2
  12. package/plugins/takomi-flow/scripts/lib/agent-plan.mjs +10 -0
  13. package/plugins/takomi-flow/scripts/lib/args.mjs +12 -3
  14. package/plugins/takomi-flow/scripts/lib/browser.mjs +42 -3
  15. package/plugins/takomi-flow/scripts/lib/commands.mjs +28 -11
  16. package/plugins/takomi-flow/scripts/lib/flow-media.mjs +39 -0
  17. package/plugins/takomi-flow/scripts/lib/flow-outcome.mjs +37 -12
  18. package/plugins/takomi-flow/scripts/lib/flow-project-session.mjs +153 -0
  19. package/plugins/takomi-flow/scripts/lib/flow-ui.mjs +54 -15
  20. package/plugins/takomi-flow/scripts/lib/generation.mjs +128 -28
  21. package/plugins/takomi-flow/scripts/lib/mcp-tools.mjs +15 -0
  22. package/plugins/takomi-flow/scripts/lib/request-validator.mjs +15 -0
  23. package/plugins/takomi-flow/scripts/lib/request.mjs +12 -1
  24. package/plugins/takomi-flow/scripts/lib/settings-plan.mjs +6 -1
  25. package/plugins/takomi-flow/scripts/mcp-smoke.mjs +2 -0
  26. package/plugins/takomi-flow/skills/takomi-flow/SKILL.md +10 -1
package/README.md CHANGED
@@ -2,511 +2,300 @@
2
2
 
3
3
  <div align="center">
4
4
  <h3>🎯 Stop Wrestling With AI. Start Building With Purpose.</h3>
5
- <p><em>The artisan's toolkit that transforms AI from chatbot to development partner — powered by the VibeCode Protocol</em></p>
5
+ <p><em>The artisan's toolkit that transforms AI from chatbot to development partner</em></p>
6
+
7
+ [![npm version](https://img.shields.io/npm/v/takomi?color=%23cb3837&label=npm)](https://www.npmjs.com/package/takomi)
8
+ [![npm downloads](https://img.shields.io/npm/dm/takomi?color=%232b8a3e&label=downloads)](https://www.npmjs.com/package/takomi)
9
+ [![GitHub stars](https://img.shields.io/github/stars/JStaRFilms/VibeCode-Protocol-Suite?style=flat&color=%23e3b341&label=stars)](https://github.com/JStaRFilms/VibeCode-Protocol-Suite)
10
+ [![License: ISC](https://img.shields.io/npm/l/takomi?color=%234c1)](https://github.com/JStaRFilms/VibeCode-Protocol-Suite/blob/main/LICENSE)
6
11
  </div>
7
12
 
8
13
  ---
9
14
 
10
- > **🎉 Rebrand Notice:** VibeSuite is now **Takomi**!
11
- > If you're following tutorials that reference `vibesuite` or `VibeCode`, simply use `takomi` instead.
12
- > Example: `npx vibesuite install` `npx takomi install`
13
- > The VibeCode Protocol lives on as the engine powering Takomi.
15
+ ## What Is Takomi?
16
+
17
+ **AI shouldn't feel like a chatbot. It should feel like a teammate.**
18
+
19
+ Takomi is a complete workflow system for collaborating with AI to build software. Think of yourself as the CEO, and your AI assistants as a specialized, high-performance development team — an Architect who plans, a Builder who implements, a Reviewer who catches mistakes, and an Orchestrator who coordinates them all.
20
+
21
+ This isn't prompt engineering. This is **orchestrated development** — a battle-tested collection of protocols, workflows, and skills that transform AI coding assistants into genuine project partners. It works across every major AI-powered IDE and even browser-based AI like ChatGPT and Claude.
14
22
 
15
23
  ---
16
24
 
17
- ## 🚀 Quick Start (Recommended)
25
+ ## Features
26
+
27
+ - **🧠 72+ Skills** — Specialized capabilities from security audits to AI video generation, installed on demand
28
+ - **🔄 Universal IDE Sync** — Install once, sync to Antigravity, Claude Code, Codex, Cursor, Kilo Code, Pi, and Windsurf
29
+ - **🏗️ Full Project Lifecycle** — From genesis (planning) through design, build, and finalize — with verification gates at every step
30
+ - **🎭 Specialized Agent Modes** — Orchestrator, Architect, Coder, Debugger, Reviewer — each with purpose-built workflows
31
+ - **📦 Codex-Native Skills** — Use natural language (`use takomi genesis`) — no slash commands required
32
+ - **🔌 Pi Harness Integration** — First-class Pi support with context management, model routing, and optional feature packs
33
+ - **🌐 Global Skills Router** — One `~/.takomi/` store, synced to every IDE via symlinks or copy
34
+
35
+ ---
18
36
 
19
- ### Takomi Pi Harness
37
+ ## Quick Start
20
38
 
21
39
  ```bash
22
40
  npm install -g takomi
23
- takomi setup pi
24
- cd my-project
25
- takomi
41
+ takomi setup
26
42
  ```
27
43
 
28
- Optional global skills:
44
+ That's it. Takomi auto-detects your installed IDEs, creates your toolkit at `~/.takomi/`, and syncs your selected skills everywhere.
29
45
 
30
46
  ```bash
31
- takomi setup skills
32
- # First install defaults to Core Skills.
33
- # Repeat installs default to Leave As Is so existing selections are not pruned accidentally.
34
- # Custom opens a color-coded category TUI with expandable skill rows when a TTY is available.
35
- # Optional Pi feature packs can also be managed later:
36
- takomi setup pi-features
47
+ # Day-to-day usage
48
+ takomi # Launch in your current project
49
+ takomi status # See what's connected
50
+ takomi refresh # One-command update for everything
51
+ takomi doctor # Run diagnostics
37
52
  ```
38
53
 
39
- Useful management commands:
54
+ <details>
55
+ <summary><strong>📋 More install options (Pi, Codex, per-project, browser)</strong></summary>
40
56
 
41
- ```bash
42
- takomi refresh # one-command update: Takomi + Pi/assets/skills
43
- takomi status
44
- takomi doctor
45
- takomi setup all
46
- takomi setup project
47
- ```
48
-
49
- ### TakomiFlow For Google Flow Assets
50
-
51
- TakomiFlow packages Google Flow image/video generation as a Codex plugin with MCP tools plus a CLI fallback. It can generate Flow keyframes, short video shots, moodboards, collect downloaded assets, extract review frames, and record Flow project URLs.
52
-
53
- Install the full plugin from this suite:
54
-
55
- ```powershell
56
- .\scripts\install-takomi-flow.ps1 -InstallDependencies
57
- ```
58
-
59
- If someone only has skills but not the plugin, install/use the bundled `takomi-flow` skill first. It teaches Codex how to use the skill directly, fetch this suite when needed, install the full TakomiFlow plugin globally after approval, and verify the setup.
60
-
61
- See [TakomiFlow Onboarding](docs/takomi-flow-onboarding.md) and [TakomiFlow Public Distribution](docs/takomi-flow-public-distribution.md).
62
-
63
- Legacy commands like `takomi install pi`, `takomi sync pi`, `takomi upgrade`, and `takomi init` still work, but the simpler mental model is: **setup once, refresh when stale, run `takomi` to use it.**
64
-
65
- During `takomi setup pi` or `takomi setup pi-features`, Takomi offers optional Pi feature packs with recommended/manual/select-all/skip choices. Current defaults install **Takomi Interview** (`npm:@juicesharp/rpiv-ask-user-question`) so models can ask structured clarification questions. **Takomi Todo** (`npm:@juicesharp/rpiv-todo`), **Takomi Browser QA** (`npm:pi-chrome`), and **Takomi Doc Preview** (`npm:pi-markdown-preview`) remain opt-in. `takomi refresh` runs Pi's package updater so installed optional, custom, old, and new Pi packages are reconciled together.
66
-
67
- Takomi keeps `pi-subagents` installed as an internal runtime module, but setup/refresh now detects legacy raw Pi subagent activation (`npm:pi-subagents` in Pi settings or `~/.pi/agent/extensions/subagent`) and offers to disable it so models see `takomi_subagent` instead of two competing subagent tools.
68
-
69
- ### Context Manager
70
-
71
- Takomi now ships a Pi-native `takomi-context-manager` extension. It reduces prompt bloat with progressive context loading:
72
-
73
- - skill names are always visible, while descriptions and full `SKILL.md` files load only when needed
74
- - `skill_manifest`, `skill_load`, `policy_manifest`, `policy_load`, and `context_report` tools expose context on demand
75
- - `/takomi routing` remains the source of truth for model-routing policy
76
- - `takomi_subagent` is guarded by routing-policy context and can recover from wrong-provider model choices
77
- - `/context-report` shows prompt compaction, loaded skills/policies, blocked actions, model-routing corrections, and duplicate extension diagnostics
78
-
79
- `context_report` is context-manager-specific rather than a clone of Pi's Alt-C window. It restores its own hidden snapshots and Pi tool-result history after `/reload`/restart, and labels any remaining gaps instead of reporting fresh in-memory zeros as session truth. It supports `mode: "summary" | "verbose" | "problems"`; `verbose: true` remains a compatibility alias for `mode: "verbose"`. The `/context-report` slash command supports argument completions for `summary`, `verbose`, and `problems`.
80
-
81
- ### Option A: Global Install (Best for Multi-IDE Users) ⭐
82
-
83
- Install once. Use everywhere. Your skills follow you across detected AI harnesses (Antigravity, Claude Code, Codex, Cursor, Kilo Code, Pi/shared Agent Skills, Windsurf):
57
+ ### Pi Harness
84
58
 
85
59
  ```bash
86
- # Using pnpm
87
- pnpm dlx takomi install
88
-
89
- # Using npx
90
- npx takomi install
60
+ takomi setup pi
61
+ cd my-project
62
+ takomi
91
63
  ```
92
64
 
93
- What happens next:
94
- - 🔍 **Auto-detects** every AI harness on your machine
95
- - 📦 **Creates your command center** at `~/.takomi/`
96
- - 🧰 **Lets you choose Core, Present Custom, Custom, All, or Leave As Is for skills**
97
- - 📡 **Syncs your selected toolkit** to every IDE automatically
98
- - 🔄 **Keeps KiloCode in sync** across CLI and VS Code
99
-
100
- ### Option B: Per-Project Setup
101
-
102
- Need workflows for just this project? Drop them in with one command:
65
+ Optional global skills and feature packs:
103
66
 
104
67
  ```bash
105
- pnpm dlx takomi init
68
+ takomi setup skills # Core Skills on first install, custom category browser on repeat
69
+ takomi setup pi-features # Optional Pi packages (Interview, Todo, Browser QA, Doc Preview)
106
70
  ```
107
71
 
108
- Choose your weapons:
109
- - ✅ **.agent Folder** — Workflows for Cursor, Windsurf, Gemini Code Assist
110
- - ✅ **Agent YAMLs** — Custom modes for Kilo Code
111
- - ✅ **Legacy Protocols** — Copy-paste prompts for browser AI
112
- - ✅ **Cherry-pick** exactly the workflows and skills you need
72
+ ### Codex Plugin Marketplace
113
73
 
114
- ---
74
+ Add the Takomi marketplace to Codex and browse plugins directly from the Codex UI:
75
+
76
+ **Add the marketplace source** — In Codex, go to **Plugins → Add plugin marketplace** and enter:
115
77
 
116
- ## Codex Takomi Skills (No Slash Required)
78
+ | Field | Value |
79
+ |-------|-------|
80
+ | **Source** | `JStaRFilms/VibeCode-Protocol-Suite` |
81
+ | **Git ref** | `main` |
82
+ | **Sparse paths** | `.agents/plugins`<br>`plugins` |
117
83
 
118
- Takomi now supports a full skill-native protocol path in Codex:
119
- - Router skill: `takomi`
120
- - Specialist skills: `takomi-*` (migrated from non-legacy workflows)
121
- - Backward phrase aliases: `vibe genesis`, `vibe build`, `mode code`, and related prior names
84
+ > **Tip:** For the full J StaR plugin catalog, use `.agents/plugins` and `plugins` as sparse paths instead.
122
85
 
123
- Use natural language:
86
+ Once added, search for "TakomiFlow" or "takomi-codex" inside the Codex plugin browser and install.
87
+
88
+ You can also use Takomi skills with natural language — no slash commands needed:
124
89
 
125
90
  ```text
126
91
  use takomi
127
92
  use takomi genesis
128
- run vibe genesis
129
93
  continue build with takomi
130
94
  ```
131
95
 
132
- Install the Takomi protocol suite:
133
-
134
- ```bash
135
- npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill takomi
136
- ```
137
-
138
- Original Takomi-authored skills in this bundle include `21st-dev-components`, `takomi`, `global-brand-namer`, `jstar-reviewer`, and the core VibeCode/Takomi workflow skills that ship with the CLI.
139
-
140
- ### Codex Plugin Quick Start
141
-
142
- For the newer repo-local Codex plugin path, enable `takomi-codex` from `.agents/plugins/marketplace.json`. That marketplace entry points Codex at `./plugins/takomi-codex`, which includes plugin metadata, the `takomi-codex` skill, and local verification scripts.
96
+ See [Takomi Codex Onboarding](docs/takomi-codex-onboarding.md) for activation, policy loading, roadbooks, and troubleshooting.
143
97
 
144
- This plugin path is distinct from `skills add --skill takomi`, which installs the older global Takomi skill. Use natural language such as `use takomi-codex to inspect this repo`, `use Takomi to plan this feature`, or `create a Takomi roadbook for this work`.
98
+ ### Per-Project Setup
145
99
 
146
- See [Takomi Codex Onboarding](docs/takomi-codex-onboarding.md) for activation, first-run verification, policy loading, roadbooks, dry-run dispatch, no-Pi fallback, and troubleshooting.
100
+ Drop workflows into a single project without global install:
147
101
 
148
- ---
149
-
150
- ## 📦 Skill Ecosystem
151
-
152
- Think of skills as specialized team members you can summon on demand. From security audits to AI video generation — there's a skill for that.
153
-
154
- Takomi's own installer no longer installs every bundled skill by default. `takomi setup skills` uses **Core Skills** for first-time installs, **Leave As Is** for repeat installs, and ownership-safe cleanup when you explicitly deselect Takomi-managed skills. Manual/user-added skills are preserved. Custom selection opens a color-coded category browser with expandable rows on capable terminals, and falls back to simple prompts elsewhere. The global store/harness sync path uses the same ownership model so deselected Takomi-managed skills and workflows can be pruned from `~/.takomi/` and synced harness folders without touching manual or imported resources.
155
-
156
- The published bundle currently ships **72 top-level skills**, including the original `21st-dev-components` workflow for guided 21st.dev integration. The `pr-comment-fix` skill is sourced from https://gist.github.com/GSonofNun/35c67304c35dac7d6b43308b5371f671.
157
-
158
- ### Interactive Search & Install
159
102
  ```bash
160
- # Using pnpm
161
- pnpm dlx skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite
162
-
163
- # Using npx
164
- npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite
103
+ npx takomi init
165
104
  ```
166
105
 
167
- ### Core Essentials (Start Here)
168
- The recommended Takomi installer defaults are:
106
+ Choose from `.agent` folder (Cursor, Windsurf, Gemini Code Assist), Agent YAMLs (Kilo Code), or legacy protocols (browser AI).
169
107
 
170
- ```txt
171
- takomi
172
- sync-docs
173
- code-review
174
- security-audit
175
- optimize-agent-context
176
- agent-recovery
177
- avoid-feature-creep
178
- ai-sdk
179
- git-commit-generation
180
- ```
108
+ ### Global Install (Multi-IDE)
181
109
 
182
- For the external `skills` CLI, install only the router skill if you want the smallest possible footprint:
110
+ Install once. Use everywhere. Skills follow you across all detected AI harnesses:
183
111
 
184
112
  ```bash
185
- npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill takomi
113
+ npx takomi install
186
114
  ```
187
115
 
188
- ### Convex Development Suite
189
- Backend superpowers for the Convex ecosystem:
190
- ```bash
191
- npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill convex --skill convex-agents --skill convex-best-practices --skill convex-component-authoring --skill convex-cron-jobs --skill convex-file-storage --skill convex-functions --skill convex-http-actions --skill convex-migrations --skill convex-realtime --skill convex-schema-validator --skill convex-security-audit --skill convex-security-check
192
- ```
116
+ ### Browser-Based AI (ChatGPT, Claude.ai, Gemini)
193
117
 
194
- ### AI Media Suite (Paid / Advanced)
195
- For when you need more than code — videos, voice, images, and automation:
196
- ```bash
197
- npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill ai-avatar-video --skill ai-marketing-videos --skill ai-podcast-creation --skill ai-product-photography --skill ai-social-media-content --skill ai-voice-cloning
198
- ```
118
+ 1. Open a `.md` file from `Legacy (Manual Method)/`
119
+ 2. Copy the entire prompt
120
+ 3. Paste into your AI chat
121
+ 4. Follow the conversation flow
199
122
 
200
- ### The Full Arsenal (Free)
201
- Everything else — SEO, research, documentation, testing, and beyond:
202
- ```bash
203
- npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill 21st-dev-components --skill agent-recovery --skill algorithmic-art --skill audit-website --skill avoid-feature-creep --skill building-native-ui --skill code-review --skill component-analysis --skill context7 --skill convex --skill convex-agents --skill convex-best-practices --skill convex-component-authoring --skill convex-cron-jobs --skill convex-file-storage --skill convex-functions --skill convex-http-actions --skill convex-migrations --skill convex-realtime --skill convex-schema-validator --skill convex-security-audit --skill convex-security-check --skill copywriting --skill crafting-effective-readmes --skill docx --skill domain-name-brainstormer --skill frontend-design --skill gemini --skill git-worktree --skill github-ops --skill global-brand-namer --skill google-trends --skill high-fidelity-extraction --skill jstar-reviewer --skill jules --skill marketing-ideas --skill monorepo-management --skill nextjs-standards --skill optimize-agent-context --skill pdf --skill pptx --skill pr-comment-fix --skill pricing-strategy --skill programmatic-seo --skill prompt-engineering --skill remotion --skill security-audit --skill seo-ready --skill skill-creator --skill social-content --skill spawn-task --skill stitch --skill subagent-driven-development --skill sync-docs --skill twitter-automation --skill ui-ux-pro-max --skill upgrading-expo --skill webapp-testing --skill web-design-guidelines --skill xlsx --skill youtube-pipeline
204
- ```
123
+ | # | Protocol | Purpose |
124
+ |---|----------|---------|
125
+ | 1 | **Project Genesis Protocol** | Start any new project |
126
+ | 2 | **Ultimate Orchestration Prompt** | One-shot prompt for quick scripts |
127
+ | 3 | **Design System Genesis Protocol** | Create visual design systems |
128
+ | 5 | **Escalation & Handoff Protocol** | When AI gets stuck |
129
+ | 9 | **Reverse Genesis Protocol** | Onboard AI to existing codebases |
205
130
 
206
- ---
131
+ </details>
207
132
 
208
- ## 🌐 Global Skills Router (v2.0)
133
+ <details>
134
+ <summary><strong>🔌 TakomiFlow (Google Flow Assets)</strong></summary>
209
135
 
210
- **One install. Every IDE. Zero friction.**
136
+ TakomiFlow packages Google Flow image/video generation as a Codex plugin with MCP tools plus a CLI fallback. It can generate Flow keyframes, short video shots, moodboards, collect downloaded assets, extract review frames, and record Flow project URLs.
211
137
 
212
- Takomi v2.0 introduces the **Global Skills Router** — install skills once into `~/.takomi/`, and Takomi syncs them into each harness' current global skills directory. You can choose symlink/junction mode for one canonical copy, auto fallback, or plain copy mode. Works on Mac & Windows.
138
+ ```powershell
139
+ .\scripts\install-takomi-flow.ps1 -InstallDependencies
140
+ ```
213
141
 
214
- Note: `SKILL.md` is portable, but `~/.agents/skills` is **not** a universal global skills directory. Pi does load `~/.agents/skills`, and Takomi keeps that as the Pi/shared Agent Skills target. Other harnesses use their own global paths. See `docs/skills-harness-targets.md` for the current checked path table.
142
+ See [TakomiFlow Onboarding](docs/takomi-flow-onboarding.md) and [TakomiFlow Public Distribution](docs/takomi-flow-public-distribution.md).
215
143
 
216
- ### Supported Harnesses
144
+ </details>
217
145
 
218
- | Harness | Global Skills Path | Global Workflows Path |
219
- |---|---|---|
220
- | **Antigravity** | `~/.gemini/config/skills/` | `~/.gemini/config/global_workflows/` |
221
- | **Claude Code** | `~/.claude/skills/` | _(skills only)_ |
222
- | **Codex** | `~/.codex/skills/` | _(skills only)_ |
223
- | **Cursor** | `~/.cursor/skills/` | _(skills only)_ |
224
- | **Kilo Code** | `~/.kilocode/skills/` | `~/.kilocode/workflows/` |
225
- | **Pi / shared Agent Skills** | `~/.agents/skills/` | _(skills only)_ |
226
- | **Windsurf** | `~/.codeium/windsurf/skills/` | `~/.codeium/windsurf/global_workflows/` |
146
+ ---
227
147
 
228
- ### CLI Commands
148
+ ## Skill Ecosystem
229
149
 
230
- | Command | What It Does |
231
- |---|---|
232
- | `takomi` | Launch Takomi in the current project |
233
- | `takomi setup` | One-time guided setup — detects IDEs, creates your toolkit, syncs everything |
234
- | `takomi setup pi\|skills\|project\|all` | Targeted setup without memorizing installer internals |
235
- | `takomi refresh` | One-command update for Takomi CLI, Pi/assets, and skills |
236
- | `takomi refresh pi\|skills\|project\|all` | Targeted refresh when you need it |
237
- | `takomi add <url>` | Pull skills from any GitHub repo into your global store |
238
- | `takomi status` | See what's connected and your toolkit status |
239
- | `takomi doctor` | Run detailed diagnostics |
150
+ Think of skills as specialized team members you can summon on demand. Takomi ships **72+ skills** organized by category.
240
151
 
241
- Legacy aliases remain supported: `install` → `setup`, `sync`/`upgrade` → `refresh`, `init` → `setup project`, `harnesses` → `status`, `update` → `refresh project`.
152
+ ### Core Skills (Default Install)
242
153
 
243
- ### Example: Add Remote Skills
154
+ ```
155
+ takomi ai-sdk sync-docs
156
+ code-review security-audit optimize-agent-context
157
+ agent-recovery avoid-feature-creep git-commit-generation
158
+ ```
244
159
 
245
- ```bash
246
- # Pull skills from any GitHub repo into your global store
247
- pnpm dlx takomi add https://github.com/JStaRFilms/VibeCode-Protocol-Suite
160
+ ### Install More Skills
248
161
 
249
- # See what's connected
250
- pnpm dlx takomi status
162
+ ```bash
163
+ # Interactive browser — pick what you need
164
+ takomi setup skills
251
165
 
252
- # Refresh everything
253
- pnpm dlx takomi refresh
166
+ # Or via the external skills CLI
167
+ npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite
254
168
  ```
255
169
 
256
- ### KiloCode YAML Auto-Sync
170
+ <details>
171
+ <summary><strong>📚 Full skill categories</strong></summary>
257
172
 
258
- When KiloCode is detected, `takomi install` syncs `custom_modes.yaml` to **both** locations automatically:
259
- - CLI: `~/.kilocode/cli/global/settings/custom_modes.yaml`
260
- - Extension: `%APPDATA%/Antigravity/User/globalStorage/kilocode.kilo-code/settings/custom_modes.yaml`
173
+ **Developer / Frameworks** `ai-sdk`, `nextjs-standards`, `context7`, `monorepo-management`, `upgrading-expo`, `github-ops`, `git-worktree`, `git-commit-generation`, `pr-comment-fix`, `jules`, `gemini`, `anti-gravity`
261
174
 
262
- ---
175
+ **Security / Review** — `security-audit`, `audit-website`, `code-review`, `jstar-reviewer`, `convex-security-audit`, `convex-security-check`
263
176
 
264
- ## 🌟 What Is Takomi?
177
+ **Convex** `convex`, `convex-agents`, `convex-best-practices`, `convex-component-authoring`, `convex-cron-jobs`, `convex-file-storage`, `convex-functions`, `convex-http-actions`, `convex-migrations`, `convex-realtime`, `convex-schema-validator`, `convex-security-audit`, `convex-security-check`
265
178
 
266
- **AI shouldn't feel like a chatbot. It should feel like a teammate.**
179
+ **Frontend / UI** `frontend-design`, `web-design-guidelines`, `building-native-ui`, `ui-ux-pro-max`, `component-analysis`, `21st-dev-components`, `stitch`, `webapp-testing`
267
180
 
268
- Takomi is a complete workflow system for collaborating with AI to build software. Think of yourself as the Visionary/CEO, and your AI assistants as a specialized, high-performance development team that actually delivers.
181
+ **Docs / Office / Extraction** `pdf`, `docx`, `pptx`, `xlsx`, `high-fidelity-extraction`, `crafting-effective-readmes`, `exam-creator-skill`
269
182
 
270
- This isn't prompt engineering. This is **orchestrated development** a battle-tested collection of protocols, workflows, and prompts that transform AI from code generators into genuine project partners.
183
+ **Marketing / SEO / Copy** — `copywriting`, `marketing-ideas`, `pricing-strategy`, `programmatic-seo`, `seo-ready`, `social-content`, `twitter-automation`, `google-trends`, `domain-name-brainstormer`, `global-brand-namer`, `youtube-pipeline`
271
184
 
272
- ---
185
+ **AI Media / Content Creation** — `ai-avatar-video`, `ai-marketing-videos`, `ai-podcast-creation`, `ai-product-photography`, `ai-social-media-content`, `ai-voice-cloning`, `takomi-flow`
273
186
 
274
- ## 📂 Repository Structure
187
+ **Creative / Video / Art** — `algorithmic-art`, `blender-mcp-scene-director`, `takomi-flow`, `remotion`, `youtube-pipeline`, `ai-avatar-video`, `ai-marketing-videos`, `photo-book-builder`
275
188
 
276
- Built for two types of builders:
189
+ **Skill Building / Prompting / Orchestration** — `skill-creator`, `prompt-engineering`, `subagent-driven-development`, `spawn-task`
277
190
 
278
- | Folder | Purpose | Who It's For |
279
- |--------|---------|--------------|
280
- | **`.agent/`** | Workflows & Skills for agentic IDEs | Cursor, Windsurf, Gemini Code Assist users |
281
- | **`Legacy (Manual Method)/`** | Copy-paste prompts & protocols | Browser-based AI users (ChatGPT, Claude.ai) |
282
- | **`Deep_Source_Prompts/`** | Reference docs & source materials | Prompt engineers, contributors |
191
+ </details>
283
192
 
284
193
  ---
285
194
 
286
- ## 🤖 For Agentic IDE Users (Recommended)
195
+ ## Workflows & Modes
287
196
 
288
- **Using Cursor, Windsurf, VS Code + Gemini Code Assist, or similar?**
289
- Everything you need is in the **`.agent/`** folder.
197
+ ### Project Lifecycle
290
198
 
291
- ### Quick Setup
292
-
293
- 1. Copy the `.agent/` folder to your project root
294
- 2. Your IDE automatically detects workflows and skills
295
- 3. Invoke with natural language in Codex (e.g., `use takomi genesis`) - slash commands are optional
296
-
297
- ### What's Inside `.agent/`
298
-
299
- ```
300
- .agent/
301
- ├── workflows/ # Executable step-by-step workflows
302
- │ ├── vibe-genesis.md # Start new projects (V3)
303
- │ ├── vibe-design.md # Generate design systems
304
- │ ├── vibe-build.md # Execute the build
305
- │ ├── vibe-continueBuild.md # Resume work in new sessions
306
- │ ├── vibe-finalize.md # Final verification & handoff
307
- │ ├── vibe-spawnTask.md # Break down complex features
308
- │ ├── vibe-syncDocs.md # Update documentation
309
- │ ├── vibe-primeAgent.md # Load project context
310
- │ ├── reverse_genesis.md # Onboard to existing codebases
311
- │ │
312
- │ ├── mode-orchestrator.md # Coordinate multi-agent projects
313
- │ ├── mode-architect.md # Plan and design systems
314
- │ ├── mode-code.md # Write and refactor code
315
- │ ├── mode-debug.md # Diagnose issues
316
- │ ├── mode-ask.md # Explain and analyze
317
- │ ├── mode-review.md # Code review (manual)
318
- │ └── ...
319
-
320
- └── skills/ # Implicit capabilities (auto-activated)
321
- ├── prime-agent/ # Load project context
322
- ├── code-review/ # J-Star code review loop
323
- ├── security-audit/ # Deep security analysis
324
- ├── nextjs-standards/ # Next.js coding standards
325
- ├── vercel-ai-sdk/ # AI SDK reference docs
326
- ├── youtube-pipeline/ # Video production workflow
327
- └── ...
328
- ```
329
-
330
- ### Key Workflows
331
-
332
- #### 🏗️ Project Lifecycle (V3)
333
- | Slash Command | What It Does |
334
- |---------------|--------------|
335
- | `/vibe-genesis` | Architect a new project with PRD, Issues, and Guidelines |
199
+ | Command | What It Does |
200
+ |---------|--------------|
201
+ | `/vibe-genesis` | Architect a new project — PRD, issues, guidelines |
336
202
  | `/vibe-design` | Generate design system and page mockups |
337
- | `/vibe-build` | Scaffold and build the project with verification gates |
203
+ | `/vibe-build` | Scaffold and build with verification gates |
338
204
  | `/vibe-continueBuild` | Resume work in a new chat session |
339
205
  | `/vibe-finalize` | Final verification and handoff report |
340
206
  | `/reverse_genesis` | Onboard AI to an existing codebase |
341
207
 
342
- #### 🎯 Mode Workflows (Specialized Roles)
343
- | Slash Command | What It Does |
344
- |---------------|--------------|
345
- | `/mode-orchestrator` | Coordinate complex multi-agent projects |
346
- | `/mode-architect` | Plan and design technical systems |
347
- | `/mode-code` | Write and refactor code |
348
- | `/mode-debug` | Diagnose and troubleshoot issues |
349
- | `/mode-ask` | Explain and analyze without making changes |
350
- | `/mode-review` | Manual code review before commits |
351
-
352
- #### 🔄 Daily Development
353
- | Slash Command | What It Does |
354
- |---------------|--------------|
355
- | `/vibe-primeAgent` | Load project context at start of session |
208
+ ### Specialized Modes
209
+
210
+ | Command | Role | When to Use |
211
+ |---------|------|-------------|
212
+ | `/mode-orchestrator` | Coordinator | Complex multi-agent projects |
213
+ | `/mode-architect` | Planner | System design before coding |
214
+ | `/mode-code` | Implementer | Day-to-day coding |
215
+ | `/mode-debug` | Diagnostician | Hard-to-find bugs |
216
+ | `/mode-ask` | Analyst | Explain without changing code |
217
+ | `/mode-review` | Reviewer | Pre-commit quality gates |
218
+
219
+ ### Daily Commands
220
+
221
+ | Command | What It Does |
222
+ |---------|--------------|
223
+ | `/vibe-primeAgent` | Load project context at session start |
356
224
  | `/vibe-spawnTask` | Break down complex features into tasks |
357
- | `/vibe-syncDocs` | Update documentation after code changes |
358
- | `/mode-review_code` | Run J-Star automated code review |
225
+ | `/vibe-syncDocs` | Update docs after code changes |
359
226
  | `/escalate` | Generate escalation report when stuck |
360
- | `/migrate` | Transfer context to a new chat session |
227
+ | `/migrate` | Transfer context to a new session |
361
228
 
362
229
  ---
363
230
 
364
- ## 📋 For Browser-Based AI Users
365
-
366
- **Using ChatGPT, Claude.ai, or Gemini in the browser?**
367
- Use the **`Legacy (Manual Method)/`** folder with copy-paste prompts.
231
+ ## Supported IDEs
368
232
 
369
- ### The Protocol Library
233
+ Install once into `~/.takomi/` — Takomi syncs skills to each harness automatically.
370
234
 
371
- | # | Protocol | Purpose |
372
- |---|---|----------|
373
- | 0 | **Takomi User Manual** | Complete guide to the system |
374
- | 1 | **Project Genesis Protocol** | Start any new project (99% of cases) |
375
- | 2 | **Ultimate Orchestration Prompt** | One-shot prompt for quick scripts |
376
- | 3 | **Design System Genesis Protocol** | Create visual design systems |
377
- | 4 | **GitHub Issue Meta-Prompt** | Structured issue creation |
378
- | 5 | **Escalation & Handoff Protocol** | When AI gets stuck |
379
- | 8 | **Seamless Migration Meta-Prompt** | Transfer context between sessions |
380
- | 9 | **Reverse Genesis Protocol** | Onboard AI to existing codebases |
235
+ | Harness | Skills Path | Workflows Path |
236
+ |---------|-------------|----------------|
237
+ | **Antigravity** | `~/.gemini/config/skills/` | `~/.gemini/config/global_workflows/` |
238
+ | **Claude Code** | `~/.claude/skills/` | |
239
+ | **Codex** | `~/.codex/skills/` | |
240
+ | **Cursor** | `~/.cursor/skills/` | |
241
+ | **Kilo Code** | `~/.kilocode/skills/` | `~/.kilocode/workflows/` |
242
+ | **Pi / Agent Skills** | `~/.agents/skills/` | |
243
+ | **Windsurf** | `~/.codeium/windsurf/skills/` | `~/.codeium/windsurf/global_workflows/` |
381
244
 
382
- ### How to Use
245
+ <details>
246
+ <summary><strong>🔧 CLI reference</strong></summary>
383
247
 
384
- 1. Open the relevant `.md` file from `Legacy (Manual Method)/`
385
- 2. Copy the entire prompt
386
- 3. Paste it into your AI chat interface
387
- 4. Follow the conversation flow
248
+ | Command | What It Does |
249
+ |---------|--------------|
250
+ | `takomi` | Launch in the current project |
251
+ | `takomi setup` | Guided first-time setup |
252
+ | `takomi setup pi\|skills\|project\|all` | Targeted setup |
253
+ | `takomi refresh` | One-command update (CLI + Pi + skills) |
254
+ | `takomi refresh pi\|skills\|project\|all` | Targeted refresh |
255
+ | `takomi add <url>` | Pull skills from any GitHub repo |
256
+ | `takomi status` | See connections and toolkit status |
257
+ | `takomi doctor` | Run diagnostics |
388
258
 
389
- ---
259
+ Legacy aliases: `install` → `setup`, `sync`/`upgrade` → `refresh`, `init` → `setup project`.
390
260
 
391
- ## 📚 Deep Source Prompts (For Contributors)
261
+ </details>
392
262
 
393
- The **`Deep_Source_Prompts/`** folder contains the **reference documentation** and **source materials** used to create the workflows and protocols.
263
+ <details>
264
+ <summary><strong>🧩 Context Manager (Pi)</strong></summary>
394
265
 
395
- ### Contents
266
+ Takomi ships a Pi-native `takomi-context-manager` extension that reduces prompt bloat with progressive context loading:
396
267
 
397
- - **Coding Guidelines** React/TypeScript and Next.js App Router standards
398
- - **Vercel AI SDK Docs** Complete AI SDK reference (building RAG, streaming, tools)
399
- - **Design System Docs** Google's Material Design 3, mobile-first patterns
400
- - **Agent Prompts** Raw system prompts for various AI agents
401
- - **OpenRouter Docs** API reference for multi-model routing
268
+ - Skill names are always visible; descriptions and full `SKILL.md` files load only when needed
269
+ - Tools: `skill_manifest`, `skill_load`, `policy_manifest`, `policy_load`, `context_report`
270
+ - `/takomi routing` is the source of truth for model-routing policy
271
+ - `/context-report` shows prompt compaction, loaded skills/policies, blocked actions, and diagnostics
272
+ - Supports `mode: "summary" | "verbose" | "problems"`
402
273
 
403
- > **Note:** These are raw, unprocessed reference materials. They're useful for understanding *why* the workflows are structured the way they are, or for creating new workflows.
274
+ </details>
404
275
 
405
276
  ---
406
277
 
407
- ## 🎯 The Takomi Philosophy
408
-
409
- - **Structured Collaboration**: Clear roles for different AI agents (Genesis, Designer, Builder, Orchestrator, Architect, Coder, Debugger)
410
- - **End-to-End Workflows**: From project genesis to debugging escalations
411
- - **Documentation-Driven**: Every project gets proper docs, issues, and roadmaps
412
- - **Multi-Agent Orchestration**: Coordinate specialized agents for complex projects
413
- - **Scalable**: Works for tiny scripts or enterprise applications
414
-
415
- ## 🆕 What's New (V3 + Mode Workflows)
416
-
417
- ### V3 Project Workflows
418
- The V3 workflows introduce verification gates, TypeScript strict mode, and better continuation support:
419
- - `tsc --noEmit` after every file edit
420
- - 1:1 Feature Requirement ↔ Issue correlation
421
- - Templates from `nextjs-standards` skill
422
- - Seamless session continuation with `/vibe-continueBuild`
423
-
424
- ### Mode Workflows (KiloCode-Inspired)
425
- New specialized mode workflows for targeted tasks:
426
- - `/mode-orchestrator` — Coordinate multi-agent projects with session-based task management
427
- - `/mode-architect` — Plan and design before coding
428
- - `/mode-code` — Focused implementation mode
429
- - `/mode-debug` — Systematic troubleshooting
430
- - `/mode-ask` — Analysis without changes
431
- - `/mode-review` — Quality assessment
432
-
433
- ### Naming Convention
434
- - **`vibe-*`** workflows = Project lifecycle (genesis, design, build, continue, finalize)
435
- - **`mode-*`** workflows = Specialized agent modes (orchestrator, architect, code, debug, ask, review)
436
- - **Skills** = Reusable capabilities with auto-loading (in `.agent/skills/`)
278
+ ## Repository Structure
437
279
 
438
- ---
439
-
440
- ## 👥 Your AI Team
441
-
442
- ### Project Workflows (Vibe Series)
443
- | Role | Workflow | Responsibility | When to Use |
444
- |------|----------|---------------|-------------|
445
- | **Genesis** | `/vibe-genesis` | Strategic planning, PRD creation, issue generation | Starting new projects |
446
- | **Designer** | `/vibe-design` | Visual design systems, UI mockups | Before implementation |
447
- | **Builder** | `/vibe-build` | Initial code implementation with verification | Building the foundation |
448
- | **Continuer** | `/vibe-continueBuild` | Resume work in new sessions | Continuing after breaks |
449
- | **Finalizer** | `/vibe-finalize` | Verification, handoff reports | Project completion |
450
-
451
- ### Mode Workflows (Specialized Modes)
452
- | Role | Workflow | Responsibility | When to Use |
453
- |------|----------|---------------|-------------|
454
- | **Orchestrator** | `/mode-orchestrator` | Coordinate multi-agent projects, delegate tasks | Complex projects requiring coordination |
455
- | **Architect** | `/mode-architect` | Technical planning, system design | Before coding complex features |
456
- | **Coder** | `/mode-code` | Write, refactor, implement code | Day-to-day coding tasks |
457
- | **Debugger** | `/mode-debug` | Systematic issue diagnosis | When bugs are hard to find |
458
- | **Analyst** | `/mode-ask` | Explain, analyze, recommend | Understanding code without changes |
459
- | **Reviewer** | `/mode-review` | Code quality assessment | Pre-commit quality gates |
280
+ | Folder | Purpose | Who It's For |
281
+ |--------|---------|--------------|
282
+ | **`.agent/`** | Workflows & Skills for agentic IDEs | Cursor, Windsurf, Gemini Code Assist |
283
+ | **`Legacy (Manual Method)/`** | Copy-paste prompts & protocols | Browser AI users |
284
+ | **`Deep_Source_Prompts/`** | Reference docs & source materials | Contributors, prompt engineers |
460
285
 
461
286
  ---
462
287
 
463
- ## 🚀 Quick Start Guide
464
-
465
- ### For Agentic IDE Users
466
- ```bash
467
- # 1. Copy .agent folder to your project root
468
- cp -r path/to/VibeCode-Protocol-Suite/.agent ./
469
-
470
- # 2. Start a new project (V3 Workflow)
471
- # Type: /vibe-genesis
472
-
473
- # 3. Generate design system
474
- # Type: /vibe-design
475
-
476
- # 4. Build the project
477
- # Type: /vibe-build
478
-
479
- # 5. Continue in new sessions
480
- # Type: /vibe-continueBuild
288
+ ## Philosophy
481
289
 
482
- # 6. Finalize and handoff
483
- # Type: /vibe-finalize
484
- ```
485
-
486
- ### For Complex Multi-Agent Projects
487
- See the Takumi orchestration build plan: `docs/takumi_code_v0.001_plan.md`.
488
- ```bash
489
- # Use the orchestrator to coordinate multiple specialized agents
490
- # Type: /mode-orchestrator
491
-
492
- # The orchestrator will:
493
- # 1. Break down your project into subtasks
494
- # 2. Create task files in docs/tasks/orchestrator-sessions/[ID]/
495
- # 3. Guide you to spawn sub-agents for each task
496
- # 4. Track completion and synthesize results
497
- ```
498
-
499
- ### For Browser AI Users
500
- ```bash
501
- # 1. Open: Legacy (Manual Method)/1 Project Genesis Protocol The VibeCode Workflow.md
502
- # 2. Copy the entire content
503
- # 3. Paste into ChatGPT/Claude/Gemini
504
- # 4. Follow the conversation flow
505
- ```
290
+ - **Structured Collaboration** Clear roles for each AI agent, not free-form chatting
291
+ - **Documentation-Driven** — Every project gets proper docs, issues, and roadmaps
292
+ - **Verification Gates** — `tsc --noEmit` after every edit, 1:1 feature-to-issue mapping
293
+ - **Scalable** — Works for tiny scripts or enterprise applications
294
+ - **Own Your Stack** — No vendor lock-in, works across every major IDE
506
295
 
507
296
  ---
508
297
 
509
- ## 🤝 Contributing
298
+ ## Contributing
510
299
 
511
300
  This is a living system. If you discover improvements:
512
301
 
@@ -514,39 +303,45 @@ This is a living system. If you discover improvements:
514
303
  2. Add reference materials to `Deep_Source_Prompts/` if needed
515
304
  3. Create workflows in `.agent/workflows/` for agentic IDEs
516
305
  4. Update legacy prompts in `Legacy (Manual Method)/` for browser users
517
- 5. Create a GitHub Issue with your proposed changes
306
+ 5. Open a [GitHub Issue](https://github.com/JStaRFilms/VibeCode-Protocol-Suite/issues) with your proposed changes
518
307
 
519
308
  ---
520
309
 
521
- ## 🙏 Acknowledgements
522
-
523
- Externally sourced skills and optional Pi packages retain credit to their upstream creators. Takomi-original skills, workflows, and Takomi runtime/orchestration extensions in this repository, including `21st-dev-components`, remain authored and maintained by J StaR Films Studios.
524
-
525
- - **Pi Coding Agent**: Built for [Pi](https://github.com/earendil-works/pi) / `@earendil-works/pi-coding-agent` by **Mario Zechner** and Earendil Works — the MIT-licensed coding-agent runtime and extension API that powers the Pi-native Takomi harness.
526
- - **Anthropic Skills**: From [anthropics/skills](https://github.com/anthropics/skills) a massive collection including **Office Suite** (PDF/DOCX/PPTX/XLSX), **Frontend Design**, **Webapp Testing**, **Algorithmic Art**, **Monorepo Management**, and **Skill Creator**.
527
- - **Inference.sh Skills**: From [inference.sh/skills](https://github.com/inference-sh/skills) — complete media & automation suite including **Marketing Videos**, **Voice Cloning**, **Social Content**, **Twitter Automation**, **Product Photography**, and **Prompt Engineering**.
528
- - **Marketing Skills**: From [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) the complete marketer's toolkit: **Copywriting**, **Pricing Strategy**, **Social Strategy**, **Programmatic SEO**, and **Marketing Ideas**.
529
- - **Expo Skills**: From [Expo](https://github.com/expo/skills) **Building Native UI** (React Native/Expo Router) and **Upgrading Expo** guide.
530
- - **Vercel AI SDK**: From [vercel/ai](https://github.com/vercel/ai) **AI SDK** reference and **Web Design Guidelines**.
531
- - **UI/UX Pro Max**: From [Next Level Builder](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) premium design intelligence.
532
- - **Remotion**: From [Remotion](https://github.com/remotion-dev/skills) programmatic video creation.
533
- - **Subagent Development**: From [obra/superpowers](https://github.com/obra/superpowers) advanced implementation planning.
534
- - **Context7**: From [upstash/context7](https://github.com/upstash/context7) fresh library documentation fetcher.
535
- - **Audit Website**: From [squirrelscan/skills](https://github.com/squirrelscan/skills) professional website auditor.
536
- - **Convex Skills**: From [waynesutton/convexskills](https://github.com/waynesutton/convexskills) — complete Convex development suite including **Functions**, **Schema Validation**, **Realtime**, **Agents**, **File Storage**, **Migrations**, **HTTP Actions**, **Cron Jobs**, **Component Authoring**, **Best Practices**, **Security Audit**, **Security Check**, **Avoid Feature Creep**, and **Optimize Agent Context**.
537
- - **Anti-Gravity**: Custom skill for running Google's current Anti-Gravity CLI workflow for large-context review and analysis.
538
- - **Google Stitch Skills**: From [google-labs-code/stitch-skills](https://github.com/google-labs-code/stitch-skills) — Design-to-code suite including **design-md**, **enhance-prompt**, **stitch-loop**, **react-components**, and **shadcn-ui**.
539
- - **Jules**: From [sanjay3290/ai-skills](https://github.com/sanjay3290/ai-skills) delegate coding tasks to Google Jules AI agent.
540
- - **Subagent Execution**: Built on **[`pi-subagents`](https://github.com/nicobailon/pi-subagents)** by **Nico Bailon** — providing the underlying Pi extension for delegated subagent runs (result rendering, live progress, single/parallel/chain execution, session/artifact handling, and related subagent tooling), upon which Takomi adds its own lifecycle orchestration, model-routing policy, and workflow metadata.
541
- - **Takomi Interview / Todo Optional Packs**: Optional setup integrates **[`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question)** and **[`@juicesharp/rpiv-todo`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-todo)** by **juicesharp** MIT-licensed Pi extensions for structured user questions and live todo overlays.
542
- - **Takomi Browser QA Optional Pack**: Optional setup can install **[`pi-chrome`](https://github.com/tianrendong/pi-chrome)** by **tianrendong** an MIT-licensed Pi extension for explicitly authorized Chrome/browser automation.
543
- - **Takomi Doc Preview Optional Pack**: Optional setup can install **[`pi-markdown-preview`](https://github.com/omaclaren/pi-markdown-preview)** by **omaclaren** an MIT-licensed Pi extension for terminal/browser/PDF markdown and LaTeX previews.
544
- - **Context Mode Research / Optional Power User Tooling**: **[`context-mode`](https://github.com/mksglu/context-mode)** by **Mert Koseoğlu** is credited as an external context-window and session-continuity project. It is not bundled as a Takomi default; users can install/evaluate it separately under its own license.
545
- - **Git Commit Generation**: From the **[`kilocode`](https://github.com/Kilo-Org/kilocode)** repository by **Kilo-Org** (specifically, [git-commit-generation.md](https://github.com/Kilo-Org/kilocode/blob/main/packages/kilo-docs/pages/code-with-ai/features/git-commit-generation.md)) enabling automated, high-quality conventional git commit messages based on staged changes.
546
-
547
- ## 📄 License
548
-
549
- This repository contains workflow protocols and prompts. Feel free to use, modify, and share. The goal is to improve AI-human collaboration for everyone.
310
+ <details>
311
+ <summary><strong>🙏 Acknowledgements</strong></summary>
312
+
313
+ Takomi-original skills, workflows, and runtime extensions — including `21st-dev-components` — are authored and maintained by **J StaR Films Studios**.
314
+
315
+ | Source | Skills / Packages |
316
+ |--------|-------------------|
317
+ | **[Pi](https://github.com/earendil-works/pi)** by Mario Zechner / Earendil Works | MIT-licensed coding-agent runtime powering the Pi-native Takomi harness |
318
+ | **[Anthropic Skills](https://github.com/anthropics/skills)** | Office Suite (PDF/DOCX/PPTX/XLSX), Frontend Design, Webapp Testing, Algorithmic Art, Monorepo Management, Skill Creator |
319
+ | **[Inference.sh](https://github.com/inference-sh/skills)** | Marketing Videos, Voice Cloning, Social Content, Twitter Automation, Product Photography, Prompt Engineering |
320
+ | **[Marketing Skills](https://github.com/coreyhaines31/marketingskills)** | Copywriting, Pricing Strategy, Social Strategy, Programmatic SEO, Marketing Ideas |
321
+ | **[Expo](https://github.com/expo/skills)** | Building Native UI, Upgrading Expo |
322
+ | **[Vercel AI SDK](https://github.com/vercel/ai)** | AI SDK reference, Web Design Guidelines |
323
+ | **[UI/UX Pro Max](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)** | Premium design intelligence |
324
+ | **[Remotion](https://github.com/remotion-dev/skills)** | Programmatic video creation |
325
+ | **[Subagent Development](https://github.com/obra/superpowers)** | Advanced implementation planning |
326
+ | **[Context7](https://github.com/upstash/context7)** | Library documentation fetcher |
327
+ | **[Audit Website](https://github.com/squirrelscan/skills)** | Professional website auditor |
328
+ | **[Convex Skills](https://github.com/waynesutton/convexskills)** | Full Convex suite (Functions, Schema, Realtime, Agents, File Storage, Migrations, HTTP Actions, Cron, Components, Security) |
329
+ | **[Google Stitch](https://github.com/google-labs-code/stitch-skills)** | Design-to-code suite (design-md, enhance-prompt, stitch-loop, react-components, shadcn-ui) |
330
+ | **[Jules](https://github.com/sanjay3290/ai-skills)** | Google Jules AI agent delegation |
331
+ | **[pi-subagents](https://github.com/nicobailon/pi-subagents)** by Nico Bailon | Pi extension for delegated subagent runs |
332
+ | **[rpiv-ask-user-question](https://github.com/juicesharp/rpiv-mono)** by juicesharp | Structured user questions (optional Pi pack) |
333
+ | **[rpiv-todo](https://github.com/juicesharp/rpiv-mono)** by juicesharp | Live todo overlays (optional Pi pack) |
334
+ | **[pi-chrome](https://github.com/tianrendong/pi-chrome)** by tianrendong | Browser automation (optional Pi pack) |
335
+ | **[pi-markdown-preview](https://github.com/omaclaren/pi-markdown-preview)** by omaclaren | Markdown/LaTeX previews (optional Pi pack) |
336
+ | **[context-mode](https://github.com/mksglu/context-mode)** by Mert Koseoğlu | External context-window project (not bundled) |
337
+ | **[kilocode](https://github.com/Kilo-Org/kilocode)** by Kilo-Org | Git commit generation |
338
+ | **[pr-comment-fix](https://gist.github.com/GSonofNun/35c67304c35dac7d6b43308b5371f671)** | PR review comment automation |
339
+
340
+ </details>
341
+
342
+ ## License
343
+
344
+ Takomi is licensed under the [ISC License](LICENSE). Feel free to use, modify, and share. The goal is to improve AI-human collaboration for everyone.
550
345
 
551
346
  ---
552
347