toh-framework

🎯 Toh Framework

"Type Once, Have it all!" - AI-Orchestration Driven Development

📖 🇹🇭 Thai Documentation

💡 Why Toh?

Toh = Type Once, Have it all!

We believe Solo Developers and Solopreneurs should be able to build SaaS systems single-handedly without being an expert in every field.

Toh Framework enables you to:

• 💬 Command in natural language - No complex prompts needed
• 🤖 AI handles everything - Breaks down tasks, calls agents, executes until done
• 👀 See results instantly - No waiting, no answering questions
• 🚀 Production-ready - Not just a prototype

✨ Features

• 🧠 The Brain - /toh:plan analyzes, plans, and orchestrates all agents
• 💾 Auto Memory - Context persists across sessions, IDEs, and models
• 🚀 One Command Install - Easy setup via npx
• 🎨 UI First - See results immediately, no backend needed
• 🤖 No Questions - AI makes decisions, doesn't ask basic questions
• 🌍 Multi-language - Thai or English mock data and UI
• 🧪 Auto Testing - Automatic testing with auto-fix loop
• 💼 Production Ready - Not a prototype, ready for real use
• 🔧 Multi-IDE Support - Claude Code, Cursor, Gemini CLI, Codex CLI

🆕 What's New in v1.2.2

🧠 Memory Enforcement

Memory system now mandatory - no more forgotten context!

• All commands read memory before starting
• All commands save memory before finishing
• Confirmation required: "✅ Memory saved"

📊 Selective Read Protocol (Token-Optimized)

Smart memory loading to save tokens:

Always load (~2,000 tokens):
├── active.md     (~500 tokens)  - Current task
├── summary.md    (~1,000 tokens) - Project overview
└── decisions.md  (~500 tokens)  - Past decisions

❌ archive/ - Only loaded when user asks for history

🧠 /toh:plan - The Brain

/toh:plan Add user authentication with social login

The AI will analyze your project, create a plan, show you what it will do, then execute using the right agents.

💾 Auto Memory System

Your AI remembers everything across sessions:

• Switch IDEs (Claude → Cursor) - context preserved
• Token limit reached - start new chat, context preserved
• Come back tomorrow - context preserved

Files stored in .toh/memory/ - zero config, just works!

📦 Installation

# Interactive install (choose IDEs and language)
npx toh-framework install

# Quick install (Claude Code + Cursor, English)
npx toh-framework install --quick

# Specific IDE only
npx toh-framework install --ide claude
npx toh-framework install --ide cursor
npx toh-framework install --ide gemini
npx toh-framework install --ide codex

# Multiple IDEs
npx toh-framework install --ide "claude,cursor,gemini,codex"

🛠️ Supported IDEs & CLI Tools

Tool	Company	Config Location	Status
Claude Code	Anthropic	.claude/ + CLAUDE.md	✅ Full Support
Cursor	Cursor	.cursor/rules/	✅ Full Support
Gemini CLI	Google	.gemini/	✅ Full Support
Codex CLI	OpenAI	AGENTS.md	✅ Full Support

🚀 Quick Start

Claude Code (Anthropic)

After installation, use commands immediately:

# Open project with Claude Code
claude .

# Show all commands
/toh:help

# Create new project (natural language!)
/toh:vibe I want a coffee shop management system with POS, inventory, and sales reports

# Add UI
/toh:ui Add a dashboard page showing daily sales

# Improve Design
/toh:design Make it look professional and polished

# Test system (Auto fix until pass!)
/toh:test Test all pages

# Deploy
/toh:ship

Cursor

# Call Toh agent
@toh Create a meeting room booking system

# Or use specific command
@toh:ui Create a calendar page for room booking

Gemini CLI (Google)

# Start Gemini CLI in project directory
gemini

# Or use specific model
gemini --model gemini-2.5-pro

# Use commands like Claude Code
/toh:help
/toh:vibe Inventory management system

Codex CLI (OpenAI)

# Start Codex CLI in project directory
codex

# Toh Framework loads automatically from AGENTS.md
# Use commands directly
/toh:vibe Restaurant order management system

📋 Available Commands

Command	Shortcut	Description
/toh:help	/toh:h	❓ Show all available commands
/toh:plan	/toh:p	🧠 THE BRAIN - Analyze, plan, orchestrate all agents
/toh:vibe	/toh:v	🎨 Create new project with UI + Logic + Mock Data
/toh:ui	/toh:u	🖼️ Build UI - Pages, Components, Layouts
/toh:dev	/toh:d	⚙️ Add Logic - TypeScript, Zustand, Forms
/toh:design	/toh:ds	✨ Improve Design - Make it beautiful, not AI-looking
/toh:test	/toh:t	🧪 Test System - Auto test & fix until pass
/toh:connect	/toh:c	🔌 Connect Backend - Supabase, Auth, RLS
/toh:line	/toh:l	💚 LINE Mini App - LIFF integration
/toh:mobile	/toh:m	📱 Mobile App - Expo / React Native
/toh:fix	/toh:f	🔧 Fix Bugs - Debug and fix issues
/toh:ship	/toh:s	🚀 Deploy - Vercel, Production ready

🧠 Philosophy (AODD)

Toh Framework uses AI-Orchestration Driven Development (AODD) principles:

1. Natural Language → Tasks

Users command in natural language, system breaks it down into tasks automatically.

❌ "Create a Next.js project with Zustand store for products 
    with React Hook Form and Zod validation..."

✅ "I want an online store"

2. Orchestrator → Agents

System automatically calls relevant AI-Agents to work.

User: "Create a product management page"

Orchestrator thinks:
├── 📐 Call ui-builder to create UI
├── ⚙️ Call dev-builder to add logic
├── ✨ Call design-reviewer to polish
└── ✅ Deliver results

3. Users Don't Manage the Process

• No framework selection needed
• No questions to answer
• No need to know which agent does what
• Just receive results

4. Test → Fix → Loop

When tests find errors, system will:

• 🧪 Run tests with Playwright
• 🔍 Analyze errors
• 🔧 Call /toh:fix to repair
• 🔄 Retest until pass

🏗️ Tech Stack (Fixed)

Toh Framework uses a fixed tech stack - no decisions needed:

Category	Technology
Framework	Next.js 14 (App Router)
Styling	Tailwind CSS + shadcn/ui
State	Zustand
Forms	React Hook Form + Zod
Backend	Supabase
Testing	Playwright
Language	TypeScript (strict)

🤖 Agents

Agent	Description
ui-builder	Creates UI and Components
dev-builder	Adds Logic and State Management
design-reviewer	Improves Design to professional level
test-runner	Tests system with auto-fix
backend-connector	Connects to Supabase
platform-adapter	Adapts for LINE, Mobile, Desktop

📚 Skills

Skill	Description
vibe-orchestrator	Core methodology and workflow
ui-first-builder	UI patterns and component library
dev-engineer	TypeScript, Zustand, Forms
design-excellence	Design system and anti-patterns
test-engineer	Testing strategy and Playwright
backend-engineer	Supabase, RLS, Auth
platform-specialist	LINE, Expo, Tauri

🔄 Workflow Example

User: "Create a coffee shop management system"

┌─────────────────────────────────────────────────────┐
│  🎯 Toh Orchestrator                                │
├─────────────────────────────────────────────────────┤
│  1. Analyze requirements                            │
│     → POS system, inventory, reports                │
│                                                     │
│  2. Call ui-builder                                 │
│     → Create all UI pages + Mock data               │
│                                                     │
│  3. Call dev-builder                                │
│     → Add state management + forms                  │
│                                                     │
│  4. Call design-reviewer                            │
│     → Polish UI to professional look                │
│                                                     │
│  5. Call test-runner                                │
│     → Test all pages, auto-fix until pass           │
│                                                     │
│  ✅ Deliver ready-to-use system!                    │
└─────────────────────────────────────────────────────┘

🌐 Web Bundles

For use with ChatGPT, Claude.ai, or Gemini:

npx toh-framework bundle

Generated files:

• toh-full-bundle.txt - All features
• toh-ui-bundle.txt - UI only
• toh-dev-bundle.txt - Logic only

Copy and paste into Custom Instructions or System Prompt.

🔧 CLI Commands

# Install framework
npx toh-framework install

# List available commands
npx toh-framework list

# Check installation status
npx toh-framework status

# Generate web bundles
npx toh-framework bundle

🆚 Comparison

Feature	Traditional	Toh Framework
Setup Time	30+ min	2 min
Questions Asked	10+	0
Time to First UI	Hours	Minutes
Mock Data	Lorem ipsum	Realistic data
Tech Stack Decision	Every time	Fixed, optimized
Auto Testing	Manual setup	Built-in
Error Fixing	Manual	Auto loop

📖 Examples

Create E-commerce System

/toh:vibe Online store with product pages, cart, and checkout

Create Employee Management

/toh:vibe HR system with employee management, leave requests, approvals, reports

Create Dashboard

/toh:vibe Dashboard showing sales, charts, tables with date filters

Test and Fix

/toh:test Test all pages
# If errors → auto call /toh:fix → retest until pass

🎯 Target Users

• Solo Developers - Build SaaS single-handedly
• Solopreneurs - Create MVP to test market
• Startup Founders - Prototype for investors
• Freelancers - Deliver client work faster
• Students - Learn modern web development

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

• Fork the project
• Create your feature branch (git checkout -b feature/AmazingFeature)
• Commit your changes (git commit -m 'Add some AmazingFeature')
• Push to the branch (git push origin feature/AmazingFeature)
• Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Wasin Treesinthuros (Innovation Vantage)

• GitHub: @wasintoh
• Email: [e-mail]
• LINE OA [TH]: @dr.wasin.official

Made with ❤️ done you you Na Ja.

"Type Once, Have it all!"