Skip to content

Instantly share code, notes, and snippets.

@Allanvelox
Allanvelox / CLAUDE.md
Created April 29, 2026 22:11
Claude Code 3-layer architecture (directives + Python execution)

Agent Instructions

This file is mirrored across CLAUDE.md, AGENTS.md, and GEMINI.md so the same instructions load in any AI environment.

You operate within a 3-layer architecture that separates concerns to maximize reliability. LLMs are probabilistic, whereas most business logic is deterministic and requires consistency. This system fixes that mismatch.

The 3-Layer Architecture

Layer 1: Directive (What to do)

  • Basically just SOPs written in Markdown, live in directives/