Then install skills for your AI:

think-better init --ai claude        # Claude Code
think-better init --ai copilot       # GitHub Copilot
think-better init --ai antigravity   # Antigravity

Other install methods: go install github.com/HoangTheQuyen/think-better/cmd/make-decision@latest or clone & make build

How It Works

Just talk to your AI naturally. Think Better auto-activates when it detects a decision or problem:

You: "Should we migrate from React to Next.js for our main app?"

AI:  → Detects: Binary Choice
     → Framework: Reversibility Filter
     → Warns: Overconfidence Bias, Status Quo Bias, Sunk Cost
     → Generates: Weighted comparison matrix + action plan

You: "Revenue dropped 20% despite market growth"

AI:  → Detects: Opportunity Gap
     → Decomposition: Profitability Tree (MECE)
     → Analysis: Root Cause (5 Whys) + Fermi Estimation
     → Warns: Anchoring Bias, Confirmation Bias

Two Skills

/decide — For Choices

"choose", "compare", "should I", "pros and cons", "nên chọn cái nào", "phân vân"

| | | |---|---| | 10 Frameworks | Reversibility Filter, Weighted Matrix, Hypothesis-Driven, Pre-Mortem, Pros-Cons-Fixes... | | 12 Bias Warnings | Overconfidence, Anchoring, Sunk Cost, Status Quo, Confirmation... | | Comparison Matrix | --matrix "A vs B vs C" with weighted scoring | | Decision Journal | Track → Review → Improve calibration |

/solve — For Problems

"solve", "debug", "root cause", "I'm stuck", "tại sao bị vậy", "không biết làm sao"

| | | |---|---| | 7-Step Method | Define → Decompose → Prioritize → Analyze → Synthesize → Communicate | | 15 Decomposition Frameworks | Issue Tree, MECE, Hypothesis Tree, Profitability Tree, Systems Map... | | 12 Mental Models | First Principles, Inversion, Bayesian Updating, Pareto... | | 10 Communication Patterns | Pyramid Principle, BLUF, SCR, Action Titles... |

Depth Levels

Control analysis depth with slash commands:

| Command | Depth | Records | Best For | |---------|-------|---------|----------| | /solve.quick · /decide.quick | Quick | 0.5× | Fast scan, simple problems | | /solve · /decide | Standard | 1.0× | Default for most situations | | /solve.deep · /decide.deep | Deep | 1.7× | Complex, high-stakes decisions | | /solve.exec · /decide.exec | Executive | 2.5× | Board reports, stakeholder briefings |

Examples:

/solve.quick API latency spiked after deploy
/decide.deep AWS vs Azure vs GCP for cloud migration
/solve.exec Revenue declined 20% quarter over quarter

Architecture

YOU ─── "Revenue dropped 20%" ──────────────────────────────────┐
                                                                │
  ┌─────────────────────────────────────────────────────────────▼──┐
  │  AI ASSISTANT (Claude / Copilot / Antigravity)                 │
  │                                                                │
  │  ┌─ Auto-detect ──────────┐    ┌─ Slash Command ────────────┐ │
  │  │ SKILL.md triggers      │ OR │ /solve.deep → deep mode    │ │
  │  │ "solve" → problem-pro  │    │ /decide.quick → quick mode │ │
  │  └────────────┬───────────┘    └────────────┬───────────────┘ │
  │               └───────────┬────────────────┘                  │
  │                           ▼                                    │
  │  ┌────────────────────────────────────────────────────────┐   │
  │  │  🐍 BM25 Search Engine                                 │   │
  │  │  160 records × depth multiplier (0.5× → 2.5×)         │   │
  │  └────────────────────────┬───────────────────────────────┘   │
  │                           ▼                                    │
  │  ┌────────────────────────────────────────────────────────┐   │
  │  │  📋 Advisor Engine                                      │   │
  │  │  Classify → Framework → Bias Detection → Plan          │   │
  │  └────────────────────────┬───────────────────────────────┘   │
  │                           ▼                                    │
  │  📄 Structured Output + Next-step suggestions                 │
  └───────────────────────────────────────────────────────────────┘

Step-by-Step Workspace

Add "save step-by-step" to any prompt to generate a full markdown workspace:

solving-plans/project/               decision-plans/project/
├── 00-OVERVIEW.md                   ├── 00-OVERVIEW.md
├── 01-PROBLEM-DEFINITION.md         ├── 01-DECISION-TYPE.md
├── 02-DECOMPOSITION.md              ├── 02-FRAMEWORK.md
├── 03-PRIORITIZATION.md             ├── 03-CRITERIA.md
├── 04-ANALYSIS-PLAN.md              ├── 04-ANALYSIS.md
├── 05-FINDINGS.md                   ├── 05-OPTIONS.md
├── 06-SYNTHESIS.md                  ├── 06-DECISION.md
├── 07-RECOMMENDATION.md             ├── BIAS-WARNINGS.md
├── BIAS-WARNINGS.md                 └── DECISION-LOG.md
└── DECISION-LOG.md

CLI Commands

think-better init             # Install skills for your AI
think-better list             # Show installed skills
think-better check            # Verify prerequisites (Python 3)
think-better uninstall        # Remove skills
think-better version          # Show version

Project Structure

think-better/
├── cmd/make-decision/           # CLI entry point (Go)
├── internal/                    # Core logic
│   ├── skills/                  # Skill registry + embedded data
│   ├── targets/                 # AI platform definitions
│   ├── installer/               # Install/uninstall logic
│   └── cli/                     # Command handlers
├── .agents/
│   ├── skills/
│   │   ├── make-decision/       # Decision skill (SKILL.md, scripts, CSVs)
│   │   └── problem-solving-pro/ # Problem-solving skill
│   └── workflows/               # Slash command definitions
└── specs/                       # Specifications

Stats: 13 Go files · 7 Python scripts · 16 CSVs (160 records) · 8 workflows

Requirements

| Method | Requirements | |--------|-------------| | Binary download | None — just run | | go install | Go 1.25+ | | Build from source | Go 1.25+ | | Running skills | Python 3 |

Contributing

See CONTRIBUTING.md for guidelines.

🇻🇳 Tiếng Việt

Ngừng Đoán Mò. Bắt Đầu Tư Duy Có Cấu Trúc.

AI viết code nhanh nhưng ra quyết định tệ. Think Better tiêm framework tư duy vào prompt — biến AI thành Staff Engineer.

Cài Đặt

# macOS / Linux
curl -sSL https://raw.githubusercontent.com/HoangTheQuyen/think-better/main/install.sh | bash

# Windows
irm https://raw.githubusercontent.com/HoangTheQuyen/think-better/main/install.ps1 | iex

# Cài skill
think-better init --ai claude

Cách Dùng

Nói chuyện với AI bình thường — Think Better tự kích hoạt:

| Bạn Nói | AI Làm | |---------|--------| | "Nên chọn công ty lớn hay startup?" | make-decision → Weighted Matrix, cảnh báo Status Quo Bias | | "So sánh React vs Vue vs Angular" | Bảng so sánh với tiêu chí có trọng số | | "Tại sao doanh thu giảm?" | problem-solving-pro → Issue Tree, Root Cause Analysis | | "Bị kẹt, không biết làm sao" | 7 bước: Định nghĩa → Phân tách → Ưu tiên → Phân tích |

2 Skill

/decide — Chọn lựa

• 10 framework · 12 bias · So sánh đa tiêu chí · Nhật ký quyết định

/solve — Giải quyết vấn đề

• 7 bước McKinsey · 15 framework phân tách · 12 mô hình tư duy

Slash Commands

| Lệnh | Khi Nào | |------|---------| | /solve.quick · /decide.quick | Scan nhanh | | /solve · /decide | Phân tích chuẩn | | /solve.deep · /decide.deep | Phức tạp, high-stakes | | /solve.exec · /decide.exec | Báo cáo cho leadership |

/solve.quick API chậm sau deploy
/decide.deep Nên dùng AWS hay Azure hay GCP?

Lưu Ý

• Knowledge base tiếng Anh — AI tự dịch keyword trước khi search
• Cần Python 3 cho script phân tích
• Hỗ trợ Claude, Copilot, Antigravity

MIT License · Built by HoangTheQuyen

⭐ Star if Think Better helped you think better.