Skip to content

jmvbambico/think-better

 
 

Repository files navigation

Think Better

Think Better

Your AI writes code fast but makes terrible decisions.
Think Better injects structured decision frameworks directly into your AI prompts.

Go 1.25 License: MIT 2 AI Skills 10+ Frameworks
15 Decomposition 12 Biases 4 Depth Levels

Website · Documentation · Quick Reference · Contributing

Works with Claude · GitHub Copilot · Antigravity


The Problem

You ask your AI "Should we migrate to microservices?" and get a generic pros/cons list. No framework. No bias detection. No structured analysis. Just vibes.

Think Better fixes this. It gives your AI access to 10 decision frameworks, 15 decomposition methods, 12 cognitive bias detectors, and 160 knowledge records — turning surface-level responses into structured, rigorous analysis.


Quick Start

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

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

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.

About

The Operating System for Clear Thinking & Better Decisions

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 88.3%
  • Go 9.8%
  • Other 1.9%