iiRecord
Agentic AI Atlas · Instruction File Hierarchy Pattern
memory-system:instruction-file-hierarchya5c.ai
II.
MemorySystem JSON

memory-system:instruction-file-hierarchy

Structured · live

Instruction File Hierarchy Pattern json

Inspect the normalized record payload exactly as the atlas UI reads it.

File · domain/knowledge-fabric/memory-systems.yamlCluster · domain
Record JSON
{
  "id": "memory-system:instruction-file-hierarchy",
  "_kind": "MemorySystem",
  "_file": "domain/knowledge-fabric/memory-systems.yaml",
  "_cluster": "domain",
  "attributes": {
    "displayName": "Instruction File Hierarchy Pattern",
    "description": "The canonical instruction-file memory pattern used across coding agents:\na filesystem hierarchy of instruction files where project root → nested\ndirectories → user home forms a layered scope. Each level can provide,\nextend, or override instructions from outer scopes. Implementations\ninclude CLAUDE.md (Claude Code, Pi), AGENTS.md (Codex, Amp, Gemini CLI,\nGoose, OpenCode), .cursorrules and .cursor/rules/*.mdc (Cursor),\n.clinerules (Cline), .windsurfrules (Windsurf), and .roorules (Roo Code).\nThe pattern is version-controllable, diff-readable, and requires no\nruntime infrastructure. Cross-agent convergence is visible: Cursor added\nAGENTS.md support, Pi adopted CLAUDE.md. The hierarchy depth and merge\nsemantics (override vs append) vary by agent but the core pattern —\nscoped instruction files loaded at session start — is universal.\n",
    "memoryKind": "file-based",
    "persistence": "project-scoped",
    "autoExtraction": false,
    "consolidation": "manual",
    "storageFormat": "markdown",
    "privacyFilter": false,
    "deduplication": "none"
  },
  "outgoingEdges": [
    {
      "from": "memory-system:instruction-file-hierarchy",
      "to": "layer:12-knowledge-fabric",
      "kind": "realizes",
      "attributes": {}
    }
  ],
  "incomingEdges": [
    {
      "from": "agent-version:agent-mux@current",
      "to": "memory-system:instruction-file-hierarchy",
      "kind": "uses_memory_system",
      "attributes": {}
    },
    {
      "from": "agent-version:agent-mux-remote@current",
      "to": "memory-system:instruction-file-hierarchy",
      "kind": "uses_memory_system",
      "attributes": {}
    },
    {
      "from": "agentVersion:babysitter-agent:ge-5-0-0",
      "to": "memory-system:instruction-file-hierarchy",
      "kind": "uses_memory_system",
      "attributes": {}
    },
    {
      "from": "agent-version:babysitter@current",
      "to": "memory-system:instruction-file-hierarchy",
      "kind": "uses_memory_system",
      "attributes": {}
    },
    {
      "from": "agent-version:babysitter-sdk@current",
      "to": "memory-system:instruction-file-hierarchy",
      "kind": "uses_memory_system",
      "attributes": {}
    },
    {
      "from": "agent-version:claude-agent-sdk@current",
      "to": "memory-system:instruction-file-hierarchy",
      "kind": "uses_memory_system",
      "attributes": {}
    },
    {
      "from": "agentVersion:copilot:ge-0-0-0",
      "to": "memory-system:instruction-file-hierarchy",
      "kind": "uses_memory_system",
      "attributes": {}
    },
    {
      "from": "agent-version:v0@current",
      "to": "memory-system:instruction-file-hierarchy",
      "kind": "uses_memory_system",
      "attributes": {}
    }
  ]
}