GrandMinds

GrandMinds is a thinking framework inspired by great historical minds.

This project is built out of deep respect for these figures, for the seriousness of their ideas, and for the lasting ways their work has shaped the world. It exists as a personal research and reflection project: a way to study how major thinkers approached power, order, strategy, statecraft, and long-range decision-making.

It is not meant to imitate, glorify, or politically endorse any historical figure. The analyses and materials here do not represent the author's personal political views or policy positions. They are framework-based research notes created for personal interest, structured thinking, and historical study.

Current Shape

GrandMinds now has:

• Bilingual ontology files in ontology/zh/ and ontology/en/
• A local skill contract in .claude/skills/grand-minds/SKILL.md
• A Python CLI for listing minds, building model-ready briefs, and generating judgment-ledger scaffolds

Quick Start

Use the CLI without installation:

PYTHONPATH=src python -m grandminds list-minds --lang zh
PYTHONPATH=src python -m grandminds build-brief "台海局势" --lang zh --minds lee_kuan_yew,deng_xiaoping
PYTHONPATH=src python -m grandminds new-ledger "台海局势" --lang zh
PYTHONPATH=src python -m grandminds new-ledger "US-China competition" --lang auto --minds lee_kuan_yew,henry_kissinger

Or install it locally:

python -m pip install -e .
grandminds list-minds --lang en
grandminds build-brief "US-China competition" --lang auto
grandminds new-ledger "Middle East escalation" --lang auto

Commands

list-minds

Lists available ontology files for the chosen language.

PYTHONPATH=src python -m grandminds list-minds --lang en

new-ledger

Creates a dated markdown file under ledger/ using the template in templates/judgment_ledger_entry.md.

PYTHONPATH=src python -m grandminds new-ledger "Semiconductor export controls" --lang en

Useful flags:

• --lang auto|zh|en
• --minds lee_kuan_yew,deng_xiaoping
• --stdout
• --force

build-brief

Builds a compact analysis brief from the selected ontology files so you can feed the topic plus the relevant mind frameworks into a deeper writing or agent step.

PYTHONPATH=src python -m grandminds build-brief "Taiwan Strait tensions" --lang en --minds lee_kuan_yew,henry_kissinger,zbigniew_brzezinski

Testing

Run the lightweight test suite with:

PYTHONPATH=src python -m unittest discover -s tests