# hukernel/agent-memory-engineering architecture

> Architecture diagram of the GitHub repository hukernel/agent-memory-engineering, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hukernel/agent-memory-engineering
- Repository: https://github.com/hukernel/agent-memory-engineering

## Overview

This repository is an installable, instruction-only Agent Skill for designing and evaluating agent request-understanding, routing, memory, and context systems. The principal workflow begins when a user asks an agent for help; the agent uses the skill instructions to select a workflow and consults the relevant pattern or evaluation reference. Build, audit, debug, request-routing, and testing capabilities are documented in the README. No executable runtime or external service integration is described; links reflect documented guidance, not inspected source calls.

Main entry points: [`skills/agent-memory-engineering/SKILL.md`](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md) (Skill instructions), [`skills/agent-memory-engineering/references/architecture.md`](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/architecture.md) (Memory patterns), [`skills/agent-memory-engineering/references/testing.md`](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/testing.md) (Evaluation matrix), [`skills/agent-memory-engineering/references/request-understanding.md`](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/request-understanding.md) (Request patterns)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_activation["Skill workflows"]
  node_skill["Skill instructions<br/>[SKILL.md]"]
  node_build["Build workflow<br/>[SKILL.md]"]
  node_audit["Audit workflow<br/>[SKILL.md]"]
  node_debug["Debug workflow<br/>[SKILL.md]"]
end

subgraph group_request["Request routing"]
  node_request_patterns["Request patterns"]
end

subgraph group_memory["Memory and evaluation"]
  node_memory_patterns["Memory patterns<br/>[architecture.md]"]
  node_evaluation["Evaluation matrix<br/>[testing.md]"]
end

node_user(("User"))
node_agent(("Compatible agent"))

node_user -->|"asks for help"| node_agent
node_agent -->|"activates"| node_skill
node_skill -->|"guides"| node_build
node_skill -->|"guides"| node_audit
node_skill -->|"guides"| node_debug
node_skill -->|"consults"| node_request_patterns
node_skill -->|"consults"| node_memory_patterns
node_skill -->|"consults"| node_evaluation
node_build -->|"uses patterns"| node_memory_patterns
node_build -->|"uses patterns"| node_request_patterns
node_build -->|"evaluates"| node_evaluation
node_audit -->|"reviews against"| node_memory_patterns
node_debug -->|"traces against"| node_memory_patterns
node_debug -->|"verifies with"| node_evaluation

click node_skill "https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md"
click node_build "https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md"
click node_audit "https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md"
click node_debug "https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md"
click node_request_patterns "https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/request-understanding.md"
click node_memory_patterns "https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/architecture.md"
click node_evaluation "https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/testing.md"

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_skill,node_build,node_audit,node_debug,node_user toneBlue
class node_request_patterns toneAmber
class node_memory_patterns,node_evaluation toneMint
class node_agent toneIndigo
```

## Components

### Skill workflows

- [Skill instructions](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md): `skills/agent-memory-engineering/SKILL.md`
- [Build workflow](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md): `skills/agent-memory-engineering/SKILL.md`
- [Audit workflow](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md): `skills/agent-memory-engineering/SKILL.md`
- [Debug workflow](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/SKILL.md): `skills/agent-memory-engineering/SKILL.md`

### Request routing

- [Request patterns](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/request-understanding.md): `skills/agent-memory-engineering/references/request-understanding.md`

### Memory and evaluation

- [Memory patterns](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/architecture.md): `skills/agent-memory-engineering/references/architecture.md`
- [Evaluation matrix](https://github.com/hukernel/agent-memory-engineering/blob/main/skills/agent-memory-engineering/references/testing.md): `skills/agent-memory-engineering/references/testing.md`

### Other components

- **User**
- **Compatible agent**

## Connections

- User → Compatible agent: asks for help
- Compatible agent → Skill instructions: activates
- Skill instructions → Build workflow: guides
- Skill instructions → Audit workflow: guides
- Skill instructions → Debug workflow: guides
- Skill instructions → Request patterns: consults
- Skill instructions → Memory patterns: consults
- Skill instructions → Evaluation matrix: consults
- Build workflow → Memory patterns: uses patterns
- Build workflow → Request patterns: uses patterns
- Build workflow → Evaluation matrix: evaluates
- Audit workflow → Memory patterns: reviews against
- Debug workflow → Memory patterns: traces against
- Debug workflow → Evaluation matrix: verifies with