# gabrieldeassiscordeiro/materiais-obsidian architecture

> Architecture diagram of the GitHub repository gabrieldeassiscordeiro/materiais-obsidian, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gabrieldeassiscordeiro/materiais-obsidian
- Repository: https://github.com/gabrieldeassiscordeiro/materiais-obsidian

## Overview

This repository is a Portuguese-language Obsidian learning vault, not a single application: a learner opens it in Obsidian or browses it on GitHub, then follows each subject’s Home, Index, and learning path into course notes, exercises, and references. Shared templates, glossary entries, and canvases support the collections. A distinct runnable branch provides simulated LLM-security labs and defensive examples. The README documents the vault structure and course capabilities; sampled code shows labkit’s internal calls, but not how the defensive examples are used by learners.

Main entry points: [`Assembly Vault/00 - Início`](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Assembly%20Vault/00%20-%20In%C3%ADcio) (Course entry points), [`Jailbreaking-Vault/06 - Laboratórios/labkit/runner.py`](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/runner.py) (Suite runner), [`Jailbreaking-Vault/06 - Laboratórios/labkit/cli.py`](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/cli.py) (Lab CLI), [`Jailbreaking-Vault/06 - Laboratórios/labkit/cases.py`](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/cases.py) (Lab cases)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Vault navigation"]
  node_course_entry["Course entry points"]
end

subgraph group_languages["Programming courses"]
  node_assembly["Assembly"]
  node_python["Python"]
  node_rust["Rust"]
  node_cpp["C++"]
end

subgraph group_systems["Systems courses"]
  node_docker["Docker"]
  node_obsidian_course["Obsidian course"]
  node_operating_systems["Operating systems"]
  node_openclaw["OpenClaw"]
end

subgraph group_security["Security courses"]
  node_sandbox["Sandbox course"]
  node_jailbreaking["LLM security course"]
  node_cybersecurity["Cybersecurity course"]
end

subgraph group_shared["Shared resources and labs"]
  node_glossary["Shared glossary<br/>[Glossário.md]"]
  node_templates["Note templates"]
  node_annexes["Canvases and bases"]
  node_lab_cli["Lab CLI<br/>[cli.py]"]
  node_lab_cases["Lab cases<br/>[cases.py]"]
  node_lab_targets["Lab targets<br/>[targets.py]"]
  node_lab_backend["Model backends<br/>[backends.py]"]
  node_lab_runner["Suite runner<br/>[runner.py]"]
  node_lab_stats["Statistics<br/>[stats.py]"]
  node_lab_textnorm["Text filters<br/>[textnorm.py]"]
  node_lab_tools["Simulated tools<br/>[tools.py]"]
  node_output_contract["Output contract<br/>[contrato_saida.py]"]
  node_tool_policy["Tool policy"]
  node_regression_gate["Regression gate<br/>[gate_regressao.py]"]
  node_alerts["Security alerts<br/>[alertas.py]"]
end

node_learner(("Learner"))
node_obsidian(("Obsidian or GitHub"))

node_learner -->|"opens vault"| node_obsidian
node_learner -->|"browses materials"| node_obsidian
node_obsidian -->|"navigates from"| node_course_entry
node_course_entry -->|"starts course"| node_assembly
node_course_entry -->|"starts course"| node_python
node_course_entry -->|"starts course"| node_rust
node_course_entry -->|"starts course"| node_cpp
node_course_entry -->|"starts course"| node_docker
node_course_entry -->|"starts course"| node_obsidian_course
node_course_entry -->|"starts course"| node_operating_systems
node_course_entry -->|"starts course"| node_openclaw
node_course_entry -->|"starts course"| node_sandbox
node_course_entry -->|"starts course"| node_jailbreaking
node_course_entry -->|"starts course"| node_cybersecurity
node_course_entry -->|"uses shared terms"| node_glossary
node_course_entry -->|"uses templates"| node_templates
node_course_entry -->|"uses references"| node_annexes
node_lab_cli -->|"loads suites"| node_lab_cases
node_lab_cli -->|"runs suites"| node_lab_runner
node_lab_cli -->|"creates backend"| node_lab_backend
node_lab_cli -->|"formats rates"| node_lab_stats
node_lab_cli -->|"loads configurations"| node_lab_targets
node_lab_cases -->|"uses targets"| node_lab_targets
node_lab_cases -->|"uses markers"| node_lab_textnorm
node_lab_targets -->|"formats prompts"| node_lab_textnorm
node_lab_backend -->|"normalizes text"| node_lab_textnorm
node_lab_runner -->|"calls backend"| node_lab_backend
node_lab_runner -->|"executes cases"| node_lab_cases
node_lab_runner -->|"uses configurations"| node_lab_targets
node_lab_runner -->|"aggregates results"| node_lab_stats
node_lab_runner -->|"filters outputs"| node_lab_textnorm
node_lab_runner -->|"checks tool calls"| node_lab_tools

click node_course_entry "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Assembly%20Vault/00%20-%20In%C3%ADcio"
click node_assembly "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Assembly%20Vault"
click node_python "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Python-Vault"
click node_rust "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Rust-Vault"
click node_cpp "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Cpp-Vault"
click node_docker "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Docker-Vault"
click node_obsidian_course "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Obsidian-Vault"
click node_operating_systems "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Sistemas-Operacionais-Vault"
click node_openclaw "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/OpenClaw-Vault"
click node_sandbox "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Sandbox-Vault"
click node_jailbreaking "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Jailbreaking-Vault"
click node_cybersecurity "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Ciberseguranca-Vault"
click node_glossary "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Gloss%C3%A1rio.md"
click node_templates "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Templates"
click node_annexes "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Anexos"
click node_lab_cli "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/cli.py"
click node_lab_cases "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/cases.py"
click node_lab_targets "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/targets.py"
click node_lab_backend "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/backends.py"
click node_lab_runner "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/runner.py"
click node_lab_stats "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/stats.py"
click node_lab_textnorm "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/textnorm.py"
click node_lab_tools "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/tools.py"
click node_output_contract "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/07%20-%20Defesa%20e%20Mitiga%C3%A7%C3%A3o/codigo/contrato_saida.py"
click node_tool_policy "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/07%20-%20Defesa%20e%20Mitiga%C3%A7%C3%A3o/codigo/politica_ferramentas.py"
click node_regression_gate "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/07%20-%20Defesa%20e%20Mitiga%C3%A7%C3%A3o/codigo/gate_regressao.py"
click node_alerts "https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/07%20-%20Defesa%20e%20Mitiga%C3%A7%C3%A3o/codigo/alertas.py"

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_course_entry toneBlue
class node_assembly,node_python,node_rust,node_cpp toneAmber
class node_docker,node_obsidian_course,node_operating_systems,node_openclaw toneMint
class node_sandbox,node_jailbreaking,node_cybersecurity toneRose
class node_glossary,node_templates,node_annexes,node_lab_cli,node_lab_cases,node_lab_targets,node_lab_backend,node_lab_runner,node_lab_stats,node_lab_textnorm,node_lab_tools,node_output_contract,node_tool_policy,node_regression_gate,node_alerts,node_learner,node_obsidian toneIndigo
```

## Components

### Vault navigation

- [Course entry points](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Assembly%20Vault/00%20-%20In%C3%ADcio): `Assembly Vault/00 - Início`

### Programming courses

- [Assembly](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Assembly%20Vault): `Assembly Vault`
- [Python](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Python-Vault): `Python-Vault`
- [Rust](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Rust-Vault): `Rust-Vault`
- [C++](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Cpp-Vault): `Cpp-Vault`

### Systems courses

- [Docker](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Docker-Vault): `Docker-Vault`
- [Obsidian course](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Obsidian-Vault): `Obsidian-Vault`
- [Operating systems](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Sistemas-Operacionais-Vault): `Sistemas-Operacionais-Vault`
- [OpenClaw](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/OpenClaw-Vault): `OpenClaw-Vault`

### Security courses

- [Sandbox course](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Sandbox-Vault): `Sandbox-Vault`
- [LLM security course](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Jailbreaking-Vault): `Jailbreaking-Vault`
- [Cybersecurity course](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Ciberseguranca-Vault): `Ciberseguranca-Vault`

### Shared resources and labs

- [Shared glossary](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Gloss%C3%A1rio.md): `Glossário.md`
- [Note templates](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Templates): `Templates`
- [Canvases and bases](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/tree/main/Anexos): `Anexos`
- [Lab CLI](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/cli.py): `Jailbreaking-Vault/06 - Laboratórios/labkit/cli.py`
- [Lab cases](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/cases.py): `Jailbreaking-Vault/06 - Laboratórios/labkit/cases.py`
- [Lab targets](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/targets.py): `Jailbreaking-Vault/06 - Laboratórios/labkit/targets.py`
- [Model backends](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/backends.py): `Jailbreaking-Vault/06 - Laboratórios/labkit/backends.py`
- [Suite runner](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/runner.py): `Jailbreaking-Vault/06 - Laboratórios/labkit/runner.py`
- [Statistics](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/stats.py): `Jailbreaking-Vault/06 - Laboratórios/labkit/stats.py`
- [Text filters](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/textnorm.py): `Jailbreaking-Vault/06 - Laboratórios/labkit/textnorm.py`
- [Simulated tools](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/06%20-%20Laborat%C3%B3rios/labkit/tools.py): `Jailbreaking-Vault/06 - Laboratórios/labkit/tools.py`
- [Output contract](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/07%20-%20Defesa%20e%20Mitiga%C3%A7%C3%A3o/codigo/contrato_saida.py): `Jailbreaking-Vault/07 - Defesa e Mitigação/codigo/contrato_saida.py`
- [Tool policy](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/07%20-%20Defesa%20e%20Mitiga%C3%A7%C3%A3o/codigo/politica_ferramentas.py): `Jailbreaking-Vault/07 - Defesa e Mitigação/codigo/politica_ferramentas.py`
- [Regression gate](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/07%20-%20Defesa%20e%20Mitiga%C3%A7%C3%A3o/codigo/gate_regressao.py): `Jailbreaking-Vault/07 - Defesa e Mitigação/codigo/gate_regressao.py`
- [Security alerts](https://github.com/gabrieldeassiscordeiro/materiais-obsidian/blob/main/Jailbreaking-Vault/07%20-%20Defesa%20e%20Mitiga%C3%A7%C3%A3o/codigo/alertas.py): `Jailbreaking-Vault/07 - Defesa e Mitigação/codigo/alertas.py`

### Other components

- **Learner**
- **Obsidian or GitHub**

## Connections

- Learner → Obsidian or GitHub: opens vault (evidence: `README.md`)
- Learner → Obsidian or GitHub: browses materials (evidence: `README.md`)
- Obsidian or GitHub → Course entry points: navigates from (evidence: `README.md`)
- Course entry points → Assembly: starts course (evidence: `README.md`)
- Course entry points → Python: starts course (evidence: `README.md`)
- Course entry points → Rust: starts course (evidence: `README.md`)
- Course entry points → C++: starts course (evidence: `README.md`)
- Course entry points → Docker: starts course (evidence: `README.md`)
- Course entry points → Obsidian course: starts course (evidence: `README.md`)
- Course entry points → Operating systems: starts course (evidence: `README.md`)
- Course entry points → OpenClaw: starts course (evidence: `README.md`)
- Course entry points → Sandbox course: starts course (evidence: `README.md`)
- Course entry points → LLM security course: starts course (evidence: `README.md`)
- Course entry points → Cybersecurity course: starts course (evidence: `README.md`)
- Course entry points → Shared glossary: uses shared terms (evidence: `README.md`)
- Course entry points → Note templates: uses templates (evidence: `README.md`)
- Course entry points → Canvases and bases: uses references (evidence: `README.md`)
- Lab CLI → Lab cases: loads suites (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/cli.py`)
- Lab CLI → Suite runner: runs suites (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/cli.py`)
- Lab CLI → Model backends: creates backend (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/cli.py`)
- Lab CLI → Statistics: formats rates (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/cli.py`)
- Lab CLI → Lab targets: loads configurations (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/cli.py`)
- Lab cases → Lab targets: uses targets (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/cases.py`)
- Lab cases → Text filters: uses markers (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/cases.py`)
- Lab targets → Text filters: formats prompts (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/targets.py`)
- Model backends → Text filters: normalizes text (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/backends.py`)
- Suite runner → Model backends: calls backend (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/runner.py`)
- Suite runner → Lab cases: executes cases (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/runner.py`)
- Suite runner → Lab targets: uses configurations (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/runner.py`)
- Suite runner → Statistics: aggregates results (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/runner.py`)
- Suite runner → Text filters: filters outputs (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/runner.py`)
- Suite runner → Simulated tools: checks tool calls (evidence: `Jailbreaking-Vault/06 - Laboratórios/labkit/runner.py`)
