AI Berkshire Explained: Turning Claude Code and Codex into a Disciplined Investment Research Team

TLDR

AI Berkshire is an open-source investment research framework that packages value-investing workflows as reusable AI skills for Claude Code and Codex.

What it solves: Generic AI analysis is often vague and inconsistent; AI Berkshire enforces structured outputs and explicit decisions.
Why it matters: It introduces process discipline, cross-checking, and reproducibility for investment research.
Core idea: Four-investor perspective system (Buffett, Munger, Duan Yongping, Li Lu) plus multi-agent execution.
Best for: Users who want a repeatable workflow for company research, portfolio reviews, and thesis tracking.

Beginner Map

If you are a student or totally new to this topic, read this post in three passes:

Start with the Mental Model section to understand the big idea first.
Move to Investigation to see how the repository works in practice.
End at Resolution and try one tiny setup step to make the learning stick.

The goal is simple: you should finish this article knowing what problem the repo solves, when to use it, and how to start without confusion.

Student First Assignment

Pick one tiny task from this repo and finish it in under 45 minutes. Example: run one command, observe output, write down 3 things you learned, and 1 thing you still do not understand.

This method helps you move from passive reading to active engineering practice quickly.

Part 1: Foundations - The Mental Model

Markdy animation

Most AI investment prompts fail in one of two ways:

They sound smart but end with “it depends.”
They produce different structure and depth every time.

AI Berkshire treats this as a workflow problem, not a prompt-wording problem.

Instead of asking one model for one long answer, it defines a research operating system:

A fixed set of specialized skills (deep research, earnings review, funnel screening, portfolio management).
Explicit decision outputs (pass / fail / gray zone) with price ranges and assumptions.
A built-in anti-bias checklist that prefers “unknown” over fake certainty.

If you think of normal AI chat as “one analyst brainstorming out loud,” AI Berkshire is closer to “a small investment committee following a playbook.”

Part 2: The Investigation - How the Framework Works

1. Skill layer: 20 scenario-specific commands

The repo organizes workflows into distinct skills such as:

/investment-research
/investment-team
/earnings-review
/industry-funnel
/quality-screen
/portfolio-review
/thesis-tracker

This removes ambiguity. You pick the workflow first, then run analysis.

2. Agent layer: solo and team modes

Single-agent skills run a strict analysis sequence. Team skills orchestrate multiple agents in parallel to compare viewpoints before synthesis.

That design reduces single-path reasoning errors and surfaces disagreement earlier.

3. Tool layer: financial rigor and verification

The project ships a tooling module (tools/financial_rigor.py) for:

market-cap checks (price x shares)
valuation sanity checks
multi-source cross-validation
scenario calculations with precise decimal arithmetic

This is important: numeric mistakes are among the easiest ways AI reports fail silently.

Part 3: The Diagnosis - What Makes It Different from “Just Ask AI”

Structured conclusions, not diplomatic essays

AI Berkshire forces judgment with constrained outputs and rationale. You can compare reports over time because format and criteria stay stable.

Multi-perspective tension by design

The framework intentionally creates conflict between lenses:

value vs certainty
moat vs disruption risk
valuation cheapness vs long-term survivability

That tension is exactly what many one-shot prompts miss.

Reproducibility and process auditability

Because the workflow is explicit, teams can re-run the same analysis later and inspect what changed: assumptions, inputs, or market conditions.

Part 4: The Resolution - Getting Started Quickly

Markdy animation

Clone the repository:

git clone https://github.com/xbtlin/ai-berkshire.git
cd ai-berkshire

Install your client path:

Claude Code users install command files via project scripts.
Codex users install generated skills (and optional slash prompts) via project scripts.

Start with a lightweight workflow first:

/quality-screen <company>
/news-pulse <ticker>

Escalate to deep research only when warranted:

/investment-research <company>
/investment-team <company>

This “funnel-first, deep-later” usage pattern is the practical way to control token cost while preserving analysis quality.

Final Mental Model

AI Berkshire is not a stock-picking bot. It is a discipline engine for AI-assisted investment research.

If your current process is “ask AI and hope,” this framework upgrades it to “run a repeatable method, verify numbers, and make explicit decisions with clear uncertainty boundaries.”

Disclaimer: This post summarizes an open-source framework and is not investment advice.