Takomi

---

What Is Takomi?

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.

---

Takomi Code

See Takomi Code for the companion project.

---

Features

• 🧠 160+ Skills Across 31 Suites - Specialized capabilities from WebGL creative development to CommonKADS expert systems, AI video, and security audits, installed on demand
• 🔄 Universal IDE Sync - Install once, sync to Antigravity, Claude Code, Codex, Cursor, Kilo Code, Pi, and Windsurf
• 🏗️ Full Project Lifecycle - From genesis (planning) through design, build, and finalize, with verification gates at every step
• 🎭 Specialized Agent Modes - Orchestrator, Architect, Coder, Debugger, Reviewer, each with purpose-built workflows
• 📦 Codex-Native Skills - Use natural language (use takomi genesis), no slash commands required
• 🔌 Pi Harness Integration - First-class Pi support with context management, model routing, and optional feature packs
• 🌐 Global Skills Router - One ~/.takomi/ store, synced to every IDE via symlinks or copy

---

Quick Start

npm 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

---

Skill Ecosystem

Think of skills as specialized team members you can summon on demand. Takomi ships 160+ skills across 31 curated suites organized by category.

Core Skills (Default Install)

takomi                 grill-me               sync-docs
code-review            security-audit         avoid-feature-creep
agent-recovery         git-commit-generation  unslop
babysit-pr             html-private-pages

Install More Skills

# 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

---

Workflows & Modes

Project Lifecycle

Specialized Modes

Daily Commands

---

Supported IDEs

Install once into ~/.takomi/ — Takomi syncs skills to each harness automatically.

---

Repository Structure

---

Philosophy

• Structured Collaboration — Clear roles for each AI agent, not free-form chatting
• Documentation-Driven — Every project gets proper docs, issues, and roadmaps
• Verification Gates — tsc --noEmit after every edit, 1:1 feature-to-issue mapping
• Scalable — Works for tiny scripts or enterprise applications
• Own Your Stack — No vendor lock-in, works across every major IDE

---

Contributing

This is a living system. If you discover improvements:

1. Test your changes with real projects
2. Add reference materials to Deep_Source_Prompts/ if needed
3. Create workflows in .agent/workflows/ for agentic IDEs
4. Update legacy prompts in Legacy (Manual Method)/ for browser users
5. Open a GitHub Issue with your proposed changes

---

License

Takomi is licensed under the ISC License. Feel free to use, modify, and share. The goal is to improve AI-human collaboration for everyone.

---