# multica-ai/andrej-karpathy-skills architecture

> Architecture diagram of the GitHub repository multica-ai/andrej-karpathy-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/multica-ai/andrej-karpathy-skills
- Repository: https://github.com/multica-ai/andrej-karpathy-skills
- Video tour (about a minute): https://gitdiagram.com/multica-ai/andrej-karpathy-skills/video

## Overview

This repository distributes Karpathy-inspired coding guidance rather than implementing a software runtime. A developer applies the guidance to a coding assistant through a project-level CLAUDE.md, a Claude Code plugin skill, or a committed Cursor rule. The guidance covers four distinct practices: clarify assumptions, favor simplicity, make surgical edits, and define verifiable goals. The README documents these delivery paths and principles; no source excerpts were provided, so relationships are limited to those documented there.

Main entry points: [`CLAUDE.md`](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md) (Claude guidelines), [`.claude-plugin/plugin.json`](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/.claude-plugin/plugin.json) (Claude Code plugin), [`skills/karpathy-guidelines/SKILL.md`](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/skills/karpathy-guidelines/SKILL.md) (Guidelines skill), [`.cursor/rules/karpathy-guidelines.mdc`](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/.cursor/rules/karpathy-guidelines.mdc) (Cursor rule)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Guidance"]
  node_claude_guidelines["Claude guidelines<br/>[CLAUDE.md]"]
  node_think_before_coding["Think before coding<br/>[CLAUDE.md]"]
  node_simplicity_first["Simplicity first<br/>[CLAUDE.md]"]
  node_surgical_changes["Surgical changes<br/>[CLAUDE.md]"]
  node_goal_driven["Goal-driven execution<br/>[CLAUDE.md]"]
end

subgraph group_delivery["Delivery"]
  node_plugin["Claude Code plugin<br/>[plugin.json]"]
  node_plugin_skill["Guidelines skill<br/>[SKILL.md]"]
  node_cursor_rule["Cursor rule"]
end

node_developer(("Developer"))
node_assistant(("Coding assistant"))

node_developer -->|"adds per project"| node_claude_guidelines
node_claude_guidelines -->|"guides coding"| node_assistant
node_developer -->|"installs plugin"| node_plugin
node_plugin -->|"makes available"| node_plugin_skill
node_plugin_skill -->|"guides coding"| node_assistant
node_developer -->|"opens project"| node_cursor_rule
node_cursor_rule -->|"guides coding"| node_assistant
node_claude_guidelines -->|"includes principle"| node_think_before_coding
node_claude_guidelines -->|"includes principle"| node_simplicity_first
node_claude_guidelines -->|"includes principle"| node_surgical_changes
node_claude_guidelines -->|"includes principle"| node_goal_driven

click node_claude_guidelines "https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md"
click node_think_before_coding "https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md"
click node_simplicity_first "https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md"
click node_surgical_changes "https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md"
click node_goal_driven "https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md"
click node_plugin "https://github.com/multica-ai/andrej-karpathy-skills/blob/main/.claude-plugin/plugin.json"
click node_plugin_skill "https://github.com/multica-ai/andrej-karpathy-skills/blob/main/skills/karpathy-guidelines/SKILL.md"
click node_cursor_rule "https://github.com/multica-ai/andrej-karpathy-skills/blob/main/.cursor/rules/karpathy-guidelines.mdc"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_claude_guidelines,node_think_before_coding,node_simplicity_first,node_surgical_changes,node_goal_driven toneBlue
class node_plugin,node_plugin_skill,node_cursor_rule toneAmber
class node_developer,node_assistant toneIndigo
```

## Components

### Guidance

- [Claude guidelines](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md): `CLAUDE.md`
- [Think before coding](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md): `CLAUDE.md`
- [Simplicity first](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md): `CLAUDE.md`
- [Surgical changes](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md): `CLAUDE.md`
- [Goal-driven execution](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md): `CLAUDE.md`

### Delivery

- [Claude Code plugin](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`
- [Guidelines skill](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/skills/karpathy-guidelines/SKILL.md): `skills/karpathy-guidelines/SKILL.md`
- [Cursor rule](https://github.com/multica-ai/andrej-karpathy-skills/blob/main/.cursor/rules/karpathy-guidelines.mdc): `.cursor/rules/karpathy-guidelines.mdc`

### Other components

- **Developer**
- **Coding assistant**

## Connections

- Developer → Claude guidelines: adds per project (evidence: `README.md`)
- Claude guidelines → Coding assistant: guides coding (evidence: `README.md`)
- Developer → Claude Code plugin: installs plugin (evidence: `README.md`)
- Claude Code plugin → Guidelines skill: makes available (evidence: `README.md`)
- Guidelines skill → Coding assistant: guides coding (evidence: `README.md`)
- Developer → Cursor rule: opens project (evidence: `README.md`)
- Cursor rule → Coding assistant: guides coding (evidence: `README.md`)
- Claude guidelines → Think before coding: includes principle (evidence: `README.md`)
- Claude guidelines → Simplicity first: includes principle (evidence: `README.md`)
- Claude guidelines → Surgical changes: includes principle (evidence: `README.md`)
- Claude guidelines → Goal-driven execution: includes principle (evidence: `README.md`)
