GETTING STARTED // ARCHITECTURE

Thinker Toolkit Documentation

Thinker Toolkit is an open, protocol-driven engineering runtime for AI coding assistants. It enforces strict, automated disciplines directly into your IDE—replacing speculative AI guesswork with deterministic root cause proofs, invariant test barriers, and isolated Git worktree subagents.

The Core Invariant PremiseTraditional AI coding tools jump directly to proposing speculative file edits based on probabilistic pattern matching. Thinker reverses this dynamic: no code modification is permitted without an isolated automated test proving the defect first, and zero tasks can be marked complete without passing deterministic exit-code gates.

The Three Invariant Pillars

Pillar 01
Systematic Forensics

Automated reproduction tests before editing. Falsifiable hypotheses isolated to exact symbols.

Pillar 02
Invariant Contract Barriers

Test-driven development (TDD) that locks public API schemas and TypeScript strictNullChecks before code commits.

Pillar 03
Subagent Worktree Swarms

Dedicated on-disk Git worktrees per agent. Parallel feature building with fast-forward, conflict-free merges.

Quick Initialization

Run the following command in your repository root to detect your stack and inject native rules:

bash
npx thinker-toolkit init