karpathy-patterns

Distills 10 design principles for autonomous agent systems from Karpathy's projects.

13|2|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/mangowhoiscloud/geode --skill karpathy-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: karpathy-patterns
Source: https://github.com/mangowhoiscloud/geode/tree/main/.claude/skills/karpathy-patterns
Command: npx skills add https://github.com/mangowhoiscloud/geode --skill karpathy-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a distilled set of 10 core design principles for building autonomous agent systems, focusing on safety, efficiency, and effective context management.

Core Features & Use Cases

  • 10 Design Principles: Covers constraint-based design, single-file constraints, fixed time budgets, ratchet mechanisms, Git as a state machine, context budget management, program.md interface, dumb platforms, branchless DAGs, and simplicity selection.
  • Use Case: When designing a new autonomous agent, consult these principles to ensure a robust, safe, and efficient architecture, drawing from successful patterns in projects like karpathy/autoresearch and karpathy/agenthub.

Quick Start

Review the 10 design principles for autonomous agents.

Frequently Asked Questions about karpathy-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the best design principles for building safe autonomous LLM agents?

Constraint-based design provides 10 core principles for autonomous agents, including single-file constraints, ratchet mechanisms, and Git as a state machine. These patterns ensure safety and effective context management derived from real autonomous system projects.

How do I manage context budget limits for LLM agents?

Context budget management restricts information flow to prevent overload in autonomous agents. It pairs with single-file constraints and the program.md interface to maintain efficient operational boundaries for LLM agent systems.

Can I use Git as a state machine for autonomous system architecture?

Git serves as a state machine for autonomous systems by tracking state transitions reliably. This design principle enables ratchet mechanisms and branchless DAGs to manage agent progress safely and efficiently.

Does the program.md interface work for dumb platforms in agent design?

The program.md interface defines a simple interaction layer for dumb platforms, ensuring autonomous agents operate within fixed constraints. This design principle allows collaborative infrastructure without complex platform dependencies.

Why use a ratchet mechanism and fixed time budgets in agent architecture?

Ratchet mechanisms secure irreversible progress while fixed time budgets prevent infinite loops in autonomous agents. These design principles ensure safe constraint-based design and predictable execution for AI architecture.

What are the limitations of constraint-based design for autonomous agent systems?

Constraint-based design limits agent freedom to enforce safety, which may reduce flexibility in highly dynamic tasks. These design principles prioritize controlled execution through branchless DAGs and single-file constraints over open-ended autonomous exploration.