How experts think.
A SOUL captures the tacit knowledge of a practitioner — the goals, instincts, mental models, tradeoffs, and judgment behind a way of thinking. Not documentation. Not a prompt. A portrait of a mind at work.
Press ⌘K to search · 737,051 words of distilled expertise
What is a SOUL?
Documentation answers “what does an architect know?” A SOUL answers “how does an excellent architect think?” Each SOUL is a structured Markdown file that distills a way of thinking into its mental models, decision frameworks, heuristics, failure modes, and the questions an expert keeps running in the background.
Docs describe a system or a procedure. A SOUL describes the judgment that chooses between procedures — why an expert reaches for one tool over another when no rule applies.
A prompt instructs a model for one task. A SOUL is a durable, human-readable artifact about a domain — useful on its own, citable, and versioned — that can ground a prompt but isn't one.
Read one to onboard into a field in an afternoon. Or feed the machine-readable JSON API to a system that needs to reason the way a domain expert would.
Featured SOULs
Browse all →Special Education Teacher
Engineers an individual route to the same high goals for students with disabilities, presuming competence, decoding behavior, and fading every support toward independence.
Materials Scientist
How an expert in materials reasons through the structure-property-processing-performance tetrahedron, treating defects as controls and every failure as a lesson.
Boilermaker
How an expert boilermaker thinks: a pressure vessel stores energy, every code weld must be qualified and proven, and no shortcut survives the discipline that failure is catastrophic.
Sound Engineer
Shapes air pressure into emotion by capturing it right at the source and carving frequency space so every element is heard, deciding by ear over meter.
School Principal
Runs a school as a system to be designed and improved, trading off instruction against operations, developing teachers, and protecting learning under accountability pressure.
Pipefitter
How an expert pipefitter thinks: fit-up owns the weld, hot pipe must be free to move, and no line is trusted until it holds its pressure test.