A comprehensive suite of protocols, meta-prompts, and orchestration tools designed to streamline software development workflows, project management, and team collaboration. Includes the VibeCode Protocol Suite with web interface, user manuals, and reusable templates for efficient development processes.
24
stars
312
commits
JavaScript
primary language
Sep 10, 2026
updated
The artisan's toolkit that transforms AI from chatbot to development partner
AI shouldn't feel like a chatbot. It should feel like a teammate.
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.
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.
use takomi genesis), no slash commands required~/.takomi/ store, synced to every IDE via symlinks or copynpm install -g takomi
takomi setup
That's it. Takomi auto-detects your installed IDEs, creates your toolkit at ~/.takomi/, and syncs your selected skills everywhere.
# Day-to-day usage
takomi # Launch in your current project
takomi status # See what's connected
takomi refresh # One-command update for everything
takomi doctor # Run diagnostics
takomi setup pi
cd my-project
takomi
Optional global skills and feature packs:
takomi setup skills # Core Skills on first install, custom category browser on repeat
takomi setup pi-features # Optional Pi packages (Interview, Todo, Browser QA, Doc Preview)
Add the Takomi marketplace to Codex and browse plugins directly from the Codex UI:
Add the marketplace source - In Codex, go to Plugins → Add plugin marketplace and enter:
| Field | Value |
|---|---|
| Source | JStaRFilms/VibeCode-Protocol-Suite |
| Git ref | main |
| Sparse paths | .agents/pluginsplugins |
Tip: For the full J StaR plugin catalog, use
.agents/pluginsandpluginsas sparse paths instead.
Once added, search for "TakomiFlow" or "takomi-codex" inside the Codex plugin browser and install.
You can also use Takomi skills with natural language, no slash commands needed:
use takomi
use takomi genesis
continue build with takomi
See Takomi Codex Onboarding for activation, policy loading, roadbooks, and troubleshooting.
Drop workflows into a single project without global install:
npx takomi init
Choose from .agent folder (Cursor, Windsurf, Gemini Code Assist), Agent YAMLs (Kilo Code), or legacy protocols (browser AI).
Install once. Use everywhere. Skills follow you across all detected AI harnesses:
npx takomi install
.md file from Legacy (Manual Method)/| # | Protocol | Purpose |
|---|---|---|
| 1 | Project Genesis Protocol | Start any new project |
| 2 | Ultimate Orchestration Prompt | One-shot prompt for quick scripts |
| 3 | Design System Genesis Protocol | Create visual design systems |
| 5 | Escalation & Handoff Protocol | When AI gets stuck |
| 9 | Reverse Genesis Protocol | Onboard AI to existing codebases |
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.
.\scripts\install-takomi-flow.ps1 -InstallDependencies
See TakomiFlow Onboarding and TakomiFlow Public Distribution.
Think of skills as specialized team members you can summon on demand. Takomi ships 160+ skills across 31 curated suites organized by category.
takomi grill-me sync-docs
code-review security-audit avoid-feature-creep
agent-recovery git-commit-generation
# Interactive browser - pick what you need
takomi setup skills
# Or via the external skills CLI
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite
Frontend / UI - frontend-ui (creative-web-development WebGL/Three.js/GLSL/GSAP, prototyping-variants, frontend-design, ui-ux-pro-max, 21st-dev-components, web-design-guidelines, building-native-ui, figma, stitch, component-analysis, webapp-testing)
Agent Engineering & Prompting - agent-engineering (skill-curator, skill-creator, source-to-skill, expert-system-engineer CommonKADS/MYCIN, domain-modeling, conversation-to-spec, spawn-task, to-questionnaire, arena, automate-me, reflect, create-verification-skill, maintain-verification-skill, subagent-driven-development, prompt-engineering, optimize-agent-context, writing-for-agents, crafting-effective-readmes)
Code Intelligence & Comprehension - code-intelligence (why decision archaeology, how runtime traces, blast-radius, diagnosing-bugs, teach, show-me-your-work)
Engineering Principles - engineering-principles (21 foundational discipline principles: boundary-discipline, build-the-lever, model-the-domain, type-system-discipline, guard-the-context-window, prove-it-works, subtract-before-you-add, and more)
Developer / Frameworks - web-dev-standards (nextjs-standards, typescript-standards, test-driven-development, codebase-design, interactive-wizard, monorepo-management, upgrading-expo, shared-resend-portfolio), ai-sdk, git-github-tools (github-ops, git-worktree, issue-pr-triage, pr-comment-fix, resolving-merge-conflicts), context7, jules, anti-gravity, wait-what, bro, poteto-mode
Security & Web Audits - security-audit, audit-website
Convex Suite - 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)
Video / Motion / Art - hyperframes (19 video creation and animation sub-skills), remotion (remotion, remotion-real-ui-video), zack-d-films-production-suite, algorithmic-art
AI Media / Content Creation - ai-media (ai-avatar-video, ai-marketing-videos, ai-podcast-creation, ai-product-photography, ai-social-media-content, ai-voice-cloning, photo-book-builder, google-flow)
Marketing / SEO / Growth - marketing-growth (copywriting, marketing-ideas, pricing-strategy, programmatic-seo, seo-ready, social-content, twitter-automation, google-trends, domain-name-brainstormer, global-brand-namer, youtube-pipeline)
Docs / Office / Extraction - office-docs (pdf, docx, pptx, xlsx, technical-writing), high-fidelity-extraction
| Command | What It Does |
|---|---|
/vibe-genesis | Architect a new project — PRD, issues, guidelines |
/vibe-design | Generate design system and page mockups |
/vibe-build | Scaffold and build with verification gates |
/vibe-continueBuild | Resume work in a new chat session |
/vibe-finalize | Final verification and handoff report |
/reverse_genesis | Onboard AI to an existing codebase |
| Command | Role | When to Use |
|---|---|---|
/mode-orchestrator | Coordinator | Complex multi-agent projects |
/mode-architect | Planner | System design before coding |
/mode-code | Implementer | Day-to-day coding |
/mode-debug | Diagnostician | Hard-to-find bugs |
/mode-ask | Analyst | Explain without changing code |
/mode-review | Reviewer | Pre-commit quality gates |
| Command | What It Does |
|---|---|
/vibe-primeAgent | Load project context at session start |
/vibe-spawnTask | Break down complex features into tasks |
/vibe-syncDocs | Update docs after code changes |
/escalate | Generate escalation report when stuck |
/migrate | Transfer context to a new session |
Install once into ~/.takomi/ — Takomi syncs skills to each harness automatically.
| Harness | Skills Path | Workflows Path |
|---|---|---|
| Antigravity | ~/.gemini/config/skills/ | ~/.gemini/config/global_workflows/ |
| Claude Code | ~/.claude/skills/ | — |
| Codex | ~/.codex/skills/ | — |
| Cursor | ~/.cursor/skills/ | — |
| Kilo Code | ~/.kilocode/skills/ | ~/.kilocode/workflows/ |
| Pi / Agent Skills | ~/.agents/skills/ | — |
| Windsurf | ~/.codeium/windsurf/skills/ | ~/.codeium/windsurf/global_workflows/ |
| Command | What It Does |
|---|---|
takomi | Launch in the current project |
takomi setup | Guided first-time setup |
takomi setup pi|skills|project|all | Targeted setup |
takomi refresh | One-command update (CLI + Pi + skills) |
takomi refresh pi|skills|project|all | Targeted refresh |
takomi add <url> | Pull skills from any GitHub repo |
takomi status | See connections and toolkit status |
takomi doctor | Run diagnostics |
Legacy aliases: install → setup, sync/upgrade → refresh, init → setup project.
Takomi ships a Pi-native takomi-context-manager extension that reduces prompt bloat with progressive context loading:
SKILL.md files load only when neededskill_manifest, skill_load, policy_manifest, policy_load, context_report/takomi routing is the source of truth for model-routing policy/context-report shows prompt compaction, loaded skills/policies, blocked actions, and diagnosticsmode: "summary" | "verbose" | "problems"| Folder | Purpose | Who It's For |
|---|---|---|
.agent/ | Workflows & Skills for agentic IDEs | Cursor, Windsurf, Gemini Code Assist |
Legacy (Manual Method)/ | Copy-paste prompts & protocols | Browser AI users |
Deep_Source_Prompts/ | Reference docs & source materials | Contributors, prompt engineers |
tsc --noEmit after every edit, 1:1 feature-to-issue mappingThis is a living system. If you discover improvements:
Deep_Source_Prompts/ if needed.agent/workflows/ for agentic IDEsLegacy (Manual Method)/ for browser usersTakomi-original skills, workflows, and runtime extensions — including 21st-dev-components — are authored and maintained by J StaR Films Studios.
| Source | Skills / Packages |
|---|---|
| Pi by Mario Zechner / Earendil Works | MIT-licensed coding-agent runtime powering the Pi-native Takomi harness |
| Anthropic Skills | Office Suite (PDF/DOCX/PPTX/XLSX), Frontend Design, Webapp Testing, Algorithmic Art, Monorepo Management, Skill Creator |
| Inference.sh | Marketing Videos, Voice Cloning, Social Content, Twitter Automation, Product Photography, Prompt Engineering |
| Marketing Skills | Copywriting, Pricing Strategy, Social Strategy, Programmatic SEO, Marketing Ideas |
| Expo | Building Native UI, Upgrading Expo |
| Vercel AI SDK | AI SDK reference, Web Design Guidelines |
| UI/UX Pro Max | Premium design intelligence |
| Remotion | Programmatic video creation |
| HyperFrames | HTML-native video creation and animation framework: HyperFrames core, keyframes, creative, media OS, animation engine, registry, CLI, and specialized creator workflows (product launch, website showcase, faceless explainer, music video, PR walkthrough, overlays, captions) |
| Subagent Development | Advanced implementation planning |
| Context7 | Library documentation fetcher |
| Audit Website | Professional website auditor |
| Convex Skills | Full Convex suite (Functions, Schema, Realtime, Agents, File Storage, Migrations, HTTP Actions, Cron, Components, Security) |
| Google Stitch | Design-to-code suite (design-md, enhance-prompt, stitch-loop, react-components, shadcn-ui) |
| Jules | Google Jules AI agent delegation |
| pi-subagents by Nico Bailon | Pi extension for delegated subagent runs |
| rpiv-ask-user-question by juicesharp | Structured user questions (optional Pi pack) |
| rpiv-todo by juicesharp | Live todo overlays (optional Pi pack) |
| pi-chrome by tianrendong | Browser automation (optional Pi pack) |
| pi-markdown-preview by omaclaren | Markdown/LaTeX previews (optional Pi pack) |
| context-mode by Mert Koseoğlu | External context-window project (not bundled) |
| kilocode by Kilo-Org | Git commit generation |
| pr-comment-fix | PR review comment automation |
Takomi is licensed under the ISC License. Feel free to use, modify, and share. The goal is to improve AI-human collaboration for everyone.
Less chatting with bots. More shipping code.
Engineered with ❤️ by J StaR Films Studios for developers who take craftsmanship seriously.
312 commits
JavaScript
41.6%
HTML
29.4%
TypeScript
15.9%
Python
10.3%
Shell
1.5%
PowerShell
1.2%
A comprehensive suite of protocols, meta-prompts, and orchestration tools designed to streamline software development workflows, project management, and team collaboration. Includes the VibeCode Protocol Suite with web interface, user manuals, and reusable templates for efficient development processes.
24
stars
312
commits
JavaScript
primary language
Sep 10, 2026
updated
The artisan's toolkit that transforms AI from chatbot to development partner
AI shouldn't feel like a chatbot. It should feel like a teammate.
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.
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.
use takomi genesis), no slash commands required~/.takomi/ store, synced to every IDE via symlinks or copynpm install -g takomi
takomi setup
That's it. Takomi auto-detects your installed IDEs, creates your toolkit at ~/.takomi/, and syncs your selected skills everywhere.
# Day-to-day usage
takomi # Launch in your current project
takomi status # See what's connected
takomi refresh # One-command update for everything
takomi doctor # Run diagnostics
takomi setup pi
cd my-project
takomi
Optional global skills and feature packs:
takomi setup skills # Core Skills on first install, custom category browser on repeat
takomi setup pi-features # Optional Pi packages (Interview, Todo, Browser QA, Doc Preview)
Add the Takomi marketplace to Codex and browse plugins directly from the Codex UI:
Add the marketplace source - In Codex, go to Plugins → Add plugin marketplace and enter:
| Field | Value |
|---|---|
| Source | JStaRFilms/VibeCode-Protocol-Suite |
| Git ref | main |
| Sparse paths | .agents/pluginsplugins |
Tip: For the full J StaR plugin catalog, use
.agents/pluginsandpluginsas sparse paths instead.
Once added, search for "TakomiFlow" or "takomi-codex" inside the Codex plugin browser and install.
You can also use Takomi skills with natural language, no slash commands needed:
use takomi
use takomi genesis
continue build with takomi
See Takomi Codex Onboarding for activation, policy loading, roadbooks, and troubleshooting.
Drop workflows into a single project without global install:
npx takomi init
Choose from .agent folder (Cursor, Windsurf, Gemini Code Assist), Agent YAMLs (Kilo Code), or legacy protocols (browser AI).
Install once. Use everywhere. Skills follow you across all detected AI harnesses:
npx takomi install
.md file from Legacy (Manual Method)/| # | Protocol | Purpose |
|---|---|---|
| 1 | Project Genesis Protocol | Start any new project |
| 2 | Ultimate Orchestration Prompt | One-shot prompt for quick scripts |
| 3 | Design System Genesis Protocol | Create visual design systems |
| 5 | Escalation & Handoff Protocol | When AI gets stuck |
| 9 | Reverse Genesis Protocol | Onboard AI to existing codebases |
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.
.\scripts\install-takomi-flow.ps1 -InstallDependencies
See TakomiFlow Onboarding and TakomiFlow Public Distribution.
Think of skills as specialized team members you can summon on demand. Takomi ships 160+ skills across 31 curated suites organized by category.
takomi grill-me sync-docs
code-review security-audit avoid-feature-creep
agent-recovery git-commit-generation
# Interactive browser - pick what you need
takomi setup skills
# Or via the external skills CLI
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite
Frontend / UI - frontend-ui (creative-web-development WebGL/Three.js/GLSL/GSAP, prototyping-variants, frontend-design, ui-ux-pro-max, 21st-dev-components, web-design-guidelines, building-native-ui, figma, stitch, component-analysis, webapp-testing)
Agent Engineering & Prompting - agent-engineering (skill-curator, skill-creator, source-to-skill, expert-system-engineer CommonKADS/MYCIN, domain-modeling, conversation-to-spec, spawn-task, to-questionnaire, arena, automate-me, reflect, create-verification-skill, maintain-verification-skill, subagent-driven-development, prompt-engineering, optimize-agent-context, writing-for-agents, crafting-effective-readmes)
Code Intelligence & Comprehension - code-intelligence (why decision archaeology, how runtime traces, blast-radius, diagnosing-bugs, teach, show-me-your-work)
Engineering Principles - engineering-principles (21 foundational discipline principles: boundary-discipline, build-the-lever, model-the-domain, type-system-discipline, guard-the-context-window, prove-it-works, subtract-before-you-add, and more)
Developer / Frameworks - web-dev-standards (nextjs-standards, typescript-standards, test-driven-development, codebase-design, interactive-wizard, monorepo-management, upgrading-expo, shared-resend-portfolio), ai-sdk, git-github-tools (github-ops, git-worktree, issue-pr-triage, pr-comment-fix, resolving-merge-conflicts), context7, jules, anti-gravity, wait-what, bro, poteto-mode
Security & Web Audits - security-audit, audit-website
Convex Suite - 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)
Video / Motion / Art - hyperframes (19 video creation and animation sub-skills), remotion (remotion, remotion-real-ui-video), zack-d-films-production-suite, algorithmic-art
AI Media / Content Creation - ai-media (ai-avatar-video, ai-marketing-videos, ai-podcast-creation, ai-product-photography, ai-social-media-content, ai-voice-cloning, photo-book-builder, google-flow)
Marketing / SEO / Growth - marketing-growth (copywriting, marketing-ideas, pricing-strategy, programmatic-seo, seo-ready, social-content, twitter-automation, google-trends, domain-name-brainstormer, global-brand-namer, youtube-pipeline)
Docs / Office / Extraction - office-docs (pdf, docx, pptx, xlsx, technical-writing), high-fidelity-extraction
| Command | What It Does |
|---|---|
/vibe-genesis | Architect a new project — PRD, issues, guidelines |
/vibe-design | Generate design system and page mockups |
/vibe-build | Scaffold and build with verification gates |
/vibe-continueBuild | Resume work in a new chat session |
/vibe-finalize | Final verification and handoff report |
/reverse_genesis | Onboard AI to an existing codebase |
| Command | Role | When to Use |
|---|---|---|
/mode-orchestrator | Coordinator | Complex multi-agent projects |
/mode-architect | Planner | System design before coding |
/mode-code | Implementer | Day-to-day coding |
/mode-debug | Diagnostician | Hard-to-find bugs |
/mode-ask | Analyst | Explain without changing code |
/mode-review | Reviewer | Pre-commit quality gates |
| Command | What It Does |
|---|---|
/vibe-primeAgent | Load project context at session start |
/vibe-spawnTask | Break down complex features into tasks |
/vibe-syncDocs | Update docs after code changes |
/escalate | Generate escalation report when stuck |
/migrate | Transfer context to a new session |
Install once into ~/.takomi/ — Takomi syncs skills to each harness automatically.
| Harness | Skills Path | Workflows Path |
|---|---|---|
| Antigravity | ~/.gemini/config/skills/ | ~/.gemini/config/global_workflows/ |
| Claude Code | ~/.claude/skills/ | — |
| Codex | ~/.codex/skills/ | — |
| Cursor | ~/.cursor/skills/ | — |
| Kilo Code | ~/.kilocode/skills/ | ~/.kilocode/workflows/ |
| Pi / Agent Skills | ~/.agents/skills/ | — |
| Windsurf | ~/.codeium/windsurf/skills/ | ~/.codeium/windsurf/global_workflows/ |
| Command | What It Does |
|---|---|
takomi | Launch in the current project |
takomi setup | Guided first-time setup |
takomi setup pi|skills|project|all | Targeted setup |
takomi refresh | One-command update (CLI + Pi + skills) |
takomi refresh pi|skills|project|all | Targeted refresh |
takomi add <url> | Pull skills from any GitHub repo |
takomi status | See connections and toolkit status |
takomi doctor | Run diagnostics |
Legacy aliases: install → setup, sync/upgrade → refresh, init → setup project.
Takomi ships a Pi-native takomi-context-manager extension that reduces prompt bloat with progressive context loading:
SKILL.md files load only when neededskill_manifest, skill_load, policy_manifest, policy_load, context_report/takomi routing is the source of truth for model-routing policy/context-report shows prompt compaction, loaded skills/policies, blocked actions, and diagnosticsmode: "summary" | "verbose" | "problems"| Folder | Purpose | Who It's For |
|---|---|---|
.agent/ | Workflows & Skills for agentic IDEs | Cursor, Windsurf, Gemini Code Assist |
Legacy (Manual Method)/ | Copy-paste prompts & protocols | Browser AI users |
Deep_Source_Prompts/ | Reference docs & source materials | Contributors, prompt engineers |
tsc --noEmit after every edit, 1:1 feature-to-issue mappingThis is a living system. If you discover improvements:
Deep_Source_Prompts/ if needed.agent/workflows/ for agentic IDEsLegacy (Manual Method)/ for browser usersTakomi-original skills, workflows, and runtime extensions — including 21st-dev-components — are authored and maintained by J StaR Films Studios.
| Source | Skills / Packages |
|---|---|
| Pi by Mario Zechner / Earendil Works | MIT-licensed coding-agent runtime powering the Pi-native Takomi harness |
| Anthropic Skills | Office Suite (PDF/DOCX/PPTX/XLSX), Frontend Design, Webapp Testing, Algorithmic Art, Monorepo Management, Skill Creator |
| Inference.sh | Marketing Videos, Voice Cloning, Social Content, Twitter Automation, Product Photography, Prompt Engineering |
| Marketing Skills | Copywriting, Pricing Strategy, Social Strategy, Programmatic SEO, Marketing Ideas |
| Expo | Building Native UI, Upgrading Expo |
| Vercel AI SDK | AI SDK reference, Web Design Guidelines |
| UI/UX Pro Max | Premium design intelligence |
| Remotion | Programmatic video creation |
| HyperFrames | HTML-native video creation and animation framework: HyperFrames core, keyframes, creative, media OS, animation engine, registry, CLI, and specialized creator workflows (product launch, website showcase, faceless explainer, music video, PR walkthrough, overlays, captions) |
| Subagent Development | Advanced implementation planning |
| Context7 | Library documentation fetcher |
| Audit Website | Professional website auditor |
| Convex Skills | Full Convex suite (Functions, Schema, Realtime, Agents, File Storage, Migrations, HTTP Actions, Cron, Components, Security) |
| Google Stitch | Design-to-code suite (design-md, enhance-prompt, stitch-loop, react-components, shadcn-ui) |
| Jules | Google Jules AI agent delegation |
| pi-subagents by Nico Bailon | Pi extension for delegated subagent runs |
| rpiv-ask-user-question by juicesharp | Structured user questions (optional Pi pack) |
| rpiv-todo by juicesharp | Live todo overlays (optional Pi pack) |
| pi-chrome by tianrendong | Browser automation (optional Pi pack) |
| pi-markdown-preview by omaclaren | Markdown/LaTeX previews (optional Pi pack) |
| context-mode by Mert Koseoğlu | External context-window project (not bundled) |
| kilocode by Kilo-Org | Git commit generation |
| pr-comment-fix | PR review comment automation |
Takomi is licensed under the ISC License. Feel free to use, modify, and share. The goal is to improve AI-human collaboration for everyone.
Less chatting with bots. More shipping code.
Engineered with ❤️ by J StaR Films Studios for developers who take craftsmanship seriously.
312 commits
JavaScript
41.6%
HTML
29.4%
TypeScript
15.9%
Python
10.3%
Shell
1.5%
PowerShell
1.2%