# plitzen85/aprende-skill architecture

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

- Interactive diagram: https://gitdiagram.com/plitzen85/aprende-skill
- Repository: https://github.com/plitzen85/aprende-skill

## Overview

aprende is a Markdown-based agent skill for turning conversation corrections into confirmed, reusable knowledge. The main workflow reviews a session, presents candidate learnings for user selection, then writes them to memory, lesson, skill-stub, or project-document destinations. Optional hooks capture error signals and remind users to run the workflow; review and portable export are additional capabilities. Relationships below are documented in the README; source excerpts were not provided.

Main entry points: [`skills/aprende/SKILL.md`](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/SKILL.md) (Aprende skill), [`hooks-handlers/stop-suggest.sh`](https://github.com/plitzen85/aprende-skill/blob/main/hooks-handlers/stop-suggest.sh) (Stop reminder hook), [`skills/aprende/references/review-workflow.md`](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/review-workflow.md) (Lesson review), [`hooks-handlers/capture-signal.sh`](https://github.com/plitzen85/aprende-skill/blob/main/hooks-handlers/capture-signal.sh) (Capture signal hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Learning workflow"]
  node_learn_skill["Aprende skill<br/>[SKILL.md]"]
  node_review_workflow["Lesson review<br/>[review-workflow.md]"]
  node_confirmation["Confirmation prompt"]
end

subgraph group_knowledge["Knowledge formats"]
  node_memory_format["Memory format<br/>[memory-format.md]"]
  node_lesson_format["Lesson format<br/>[lesson-format.md]"]
  node_signal_patterns["Signal patterns<br/>[signal-patterns.md]"]
  node_skill_stub["Skill stub template"]
  node_memory_store[("Memory and lessons")]
  node_skill_store[("Skill stubs")]
  node_project_docs["Project documents"]
  node_portable_store[("Portable lessons")]
end

subgraph group_hooks["Signal hooks"]
  node_capture_hook["Capture signal hook<br/>[capture-signal.sh]"]
  node_signal_log[("Signal log")]
  node_stop_hook["Stop reminder hook<br/>[stop-suggest.sh]"]
  node_hook_config["Hook configuration<br/>[hooks.json]"]
end

subgraph group_commands["Commands and aliases"]
  node_learn_command["Learn command<br/>[aprende.md]"]
  node_enable_hooks["Enable hooks command"]
  node_disable_hooks["Disable hooks command"]
  node_learn_alias["English alias<br/>[SKILL.md]"]
end

node_user(("User"))
node_session["Conversation session"]
node_claude_code(("Claude Code"))
node_codex(("Codex"))

node_user -->|"runs"| node_learn_command
node_learn_command -->|"invokes"| node_learn_skill
node_learn_skill -->|"reviews"| node_session
node_learn_skill -->|"presents candidates"| node_confirmation
node_user -->|"selects learnings"| node_confirmation
node_learn_skill -->|"writes memories"| node_memory_store
node_learn_skill -->|"writes lessons"| node_memory_store
node_learn_skill -->|"drafts stubs"| node_skill_store
node_learn_skill -->|"dual-writes"| node_project_docs
node_claude_code -->|"reads CLAUDE.md"| node_project_docs
node_codex -->|"reads AGENTS.md"| node_project_docs
node_user -->|"requests review"| node_review_workflow
node_review_workflow -->|"reviews lessons"| node_memory_store
node_user -->|"requests portable run"| node_learn_skill
node_learn_skill -->|"mirrors lessons"| node_portable_store
node_portable_store -->|"provides lessons"| node_codex
node_claude_code -->|"dispatches after tools"| node_capture_hook
node_capture_hook -->|"appends signals"| node_signal_log
node_claude_code -->|"dispatches at stop"| node_stop_hook
node_stop_hook -->|"checks signals"| node_signal_log
node_stop_hook -->|"suggests learning"| node_user
node_enable_hooks -->|"installs entries"| node_hook_config
node_disable_hooks -->|"removes entries"| node_hook_config
node_learn_alias -->|"aliases workflow"| node_learn_skill

click node_learn_command "https://github.com/plitzen85/aprende-skill/blob/main/commands/aprende.md"
click node_learn_skill "https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/SKILL.md"
click node_review_workflow "https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/review-workflow.md"
click node_confirmation "https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/prompts/confirmation-template.md"
click node_memory_format "https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/memory-format.md"
click node_lesson_format "https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/lesson-format.md"
click node_signal_patterns "https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/signal-patterns.md"
click node_skill_stub "https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/skill-stub-template.md"
click node_capture_hook "https://github.com/plitzen85/aprende-skill/blob/main/hooks-handlers/capture-signal.sh"
click node_stop_hook "https://github.com/plitzen85/aprende-skill/blob/main/hooks-handlers/stop-suggest.sh"
click node_hook_config "https://github.com/plitzen85/aprende-skill/blob/main/hooks/hooks.json"
click node_enable_hooks "https://github.com/plitzen85/aprende-skill/blob/main/commands/aprende-enable-hooks.md"
click node_disable_hooks "https://github.com/plitzen85/aprende-skill/blob/main/commands/aprende-disable-hooks.md"
click node_learn_alias "https://github.com/plitzen85/aprende-skill/blob/main/skills/learn/SKILL.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_learn_skill,node_review_workflow,node_confirmation,node_user toneBlue
class node_memory_format,node_lesson_format,node_signal_patterns,node_skill_stub,node_memory_store,node_skill_store,node_project_docs,node_portable_store toneAmber
class node_capture_hook,node_signal_log,node_stop_hook,node_hook_config toneMint
class node_learn_command,node_enable_hooks,node_disable_hooks,node_learn_alias toneRose
class node_session,node_claude_code,node_codex toneIndigo
```

## Components

### Learning workflow

- [Aprende skill](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/SKILL.md): `skills/aprende/SKILL.md`
- [Lesson review](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/review-workflow.md): `skills/aprende/references/review-workflow.md`
- [Confirmation prompt](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/prompts/confirmation-template.md): `skills/aprende/prompts/confirmation-template.md`

### Knowledge formats

- [Memory format](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/memory-format.md): `skills/aprende/references/memory-format.md`
- [Lesson format](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/lesson-format.md): `skills/aprende/references/lesson-format.md`
- [Signal patterns](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/signal-patterns.md): `skills/aprende/references/signal-patterns.md`
- [Skill stub template](https://github.com/plitzen85/aprende-skill/blob/main/skills/aprende/references/skill-stub-template.md): `skills/aprende/references/skill-stub-template.md`
- **Memory and lessons**
- **Skill stubs**
- **Project documents**
- **Portable lessons**

### Signal hooks

- [Capture signal hook](https://github.com/plitzen85/aprende-skill/blob/main/hooks-handlers/capture-signal.sh): `hooks-handlers/capture-signal.sh`
- **Signal log**
- [Stop reminder hook](https://github.com/plitzen85/aprende-skill/blob/main/hooks-handlers/stop-suggest.sh): `hooks-handlers/stop-suggest.sh`
- [Hook configuration](https://github.com/plitzen85/aprende-skill/blob/main/hooks/hooks.json): `hooks/hooks.json`

### Commands and aliases

- [Learn command](https://github.com/plitzen85/aprende-skill/blob/main/commands/aprende.md): `commands/aprende.md`
- [Enable hooks command](https://github.com/plitzen85/aprende-skill/blob/main/commands/aprende-enable-hooks.md): `commands/aprende-enable-hooks.md`
- [Disable hooks command](https://github.com/plitzen85/aprende-skill/blob/main/commands/aprende-disable-hooks.md): `commands/aprende-disable-hooks.md`
- [English alias](https://github.com/plitzen85/aprende-skill/blob/main/skills/learn/SKILL.md): `skills/learn/SKILL.md`

### Other components

- **User**
- **Conversation session**
- **Claude Code**
- **Codex**

## Connections

- User → Learn command: runs (evidence: `README.md`)
- Learn command → Aprende skill: invokes (evidence: `README.md`)
- Aprende skill → Conversation session: reviews (evidence: `README.md`)
- Aprende skill → Confirmation prompt: presents candidates (evidence: `README.md`)
- User → Confirmation prompt: selects learnings (evidence: `README.md`)
- Aprende skill → Memory and lessons: writes memories (evidence: `README.md`)
- Aprende skill → Memory and lessons: writes lessons (evidence: `README.md`)
- Aprende skill → Skill stubs: drafts stubs (evidence: `README.md`)
- Aprende skill → Project documents: dual-writes (evidence: `README.md`)
- Claude Code → Project documents: reads CLAUDE.md (evidence: `README.md`)
- Codex → Project documents: reads AGENTS.md (evidence: `README.md`)
- User → Lesson review: requests review (evidence: `README.md`)
- Lesson review → Memory and lessons: reviews lessons (evidence: `README.md`)
- User → Aprende skill: requests portable run (evidence: `README.md`)
- Aprende skill → Portable lessons: mirrors lessons (evidence: `README.md`)
- Portable lessons → Codex: provides lessons (evidence: `README.md`)
- Claude Code → Capture signal hook: dispatches after tools (evidence: `README.md`)
- Capture signal hook → Signal log: appends signals (evidence: `README.md`)
- Claude Code → Stop reminder hook: dispatches at stop (evidence: `README.md`)
- Stop reminder hook → Signal log: checks signals (evidence: `README.md`)
- Stop reminder hook → User: suggests learning (evidence: `README.md`)
- Enable hooks command → Hook configuration: installs entries (evidence: `README.md`)
- Disable hooks command → Hook configuration: removes entries (evidence: `README.md`)
- English alias → Aprende skill: aliases workflow (evidence: `README.md`)
