---
id: "action-codify-into-markdown"
type: "action-item"
source_timestamps: ["§ What Separates Leaders from Laggards"]
tags: ["technical-implementation", "documentation"]
related: ["entity-nathan-mapp", "concept-judgment-architect"]
action: "Translate deep domain expertise into structured markdown files for real-time agent reference."
outcome: "Allows a small team to perform the work of a much larger team with consistent, top-tier judgment."
speakers: ["Jen Stave", "Ryan Kurt", "John Winsor"]
sources: ["agentic"]
sourceVaultSlug: "hbr-seg-agentic"
originDay: 6
articleStem: "hbr-new-27-teach-ai-your-decisions"
sourceUrl: "https://hbr.org/2026/06/teach-your-ai-how-you-make-decisions"
sourceTitle: "Teach Your AI How You Make Decisions"
---
# Codify expertise into markdown files

**Action:** Translate deep domain expertise into structured markdown files for real-time agent reference.

For individual managers with deep domain expertise, translate that knowledge into structured formats like markdown files. These files can then be referenced in real time by agents (like [[entity-claude-d27|Claude]]) to ensure consistent application of judgment across tasks — the exact method used by [[entity-nathan-mapp|Nathan Mapp]], who codified 12+ years of finance expertise this way.

**Outcome:** Allows a small team to perform the work of a much larger team (a team of two doing the work of ten) with consistent, top-tier judgment.

A concrete instance of [[concept-judgment-architect]] and [[concept-codifying-judgment]]; depends on [[prereq-llm-context-windows]].


## Related across articles
- [[action-convert-to-markdown]]
- [[action-codify-brand-code]]