think-better
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 103 GitHub stars
Code Fail
- rm -rf — Recursive force deletion command in build.sh
Permissions Pass
- Permissions — No dangerous permissions requested
This tool injects structured decision-making frameworks and cognitive bias detectors into AI prompts, helping models generate rigorous, well-analyzed responses rather than generic answers.
Security Assessment
The tool poses a Medium overall risk. The primary concern is its installation method: it instructs users to pipe remote shell scripts directly into bash or PowerShell (`curl ... | bash`). While common, this practice is inherently dangerous if the remote repository is ever compromised. Furthermore, the automated scan flagged a recursive force deletion command (`rm -rf`) inside a build script, which can be destructive if executed in an unexpected environment or if a path variable is flawed. There are no hardcoded secrets, no dangerous permissions requested, and no indication that the tool itself accesses sensitive local data. However, users should be aware that it is designed to intercept and process your conversational AI prompts.
Quality Assessment
The project is in excellent health and shows strong signs of community validation. It is actively maintained, with repository updates pushed as recently as today. It has garnered over 100 GitHub stars, indicating solid community trust for a niche utility. The code is fully open-source and distributed under the standard, permissive MIT license. The documentation is clear, thorough, and provides multiple installation paths.
Verdict
Use with caution: the functional tool itself is safe and well-maintained, but you should review the installer and build scripts before execution to mitigate the risks of remote script execution and force deletion commands.
The Operating System for Clear Thinking & Better Decisions
Think Better
Your AI writes code fast but makes terrible decisions.
Think Better injects structured decision frameworks directly into your AI prompts.
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@latestor 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.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found