# mhsnnclk/leonidas architecture

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

- Interactive diagram: https://gitdiagram.com/mhsnnclk/leonidas
- Repository: https://github.com/mhsnnclk/leonidas

## Overview

This repository is an Obsidian-style research and personal knowledge vault with OpenCode commands and skills for capturing, organizing, and querying material. A typical user workflow is to capture a session or research, ingest it into the wiki, then query or lint the resulting notes. The tree supports these workflow stages by name, but no README or workflow source was provided, so command-to-skill wiring and detailed processing behavior are not shown. Install and test scripts are omitted as support machinery.

Main entry points: [`wiki`](https://github.com/mhsnnclk/leonidas/tree/master/wiki) (Wiki notes), [`.opencode/commands/wiki-ingest.md`](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/wiki-ingest.md) (Wiki ingest), [`.opencode/commands/oturum-kaydet.md`](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/oturum-kaydet.md) (Session capture), [`.opencode/commands/research-weekly.md`](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/research-weekly.md) (Weekly research)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflows["OpenCode workflows"]
  node_capture["Session capture<br/>[oturum-kaydet.md]"]
  node_weekly["Weekly research<br/>[research-weekly.md]"]
  node_ingest["Wiki ingest<br/>[wiki-ingest.md]"]
  node_query["Wiki query<br/>[wiki-query.md]"]
  node_lint["Wiki lint<br/>[wiki-lint.md]"]
  node_research_skill["Researcher skill<br/>[SKILL.md]"]
  node_maintainer_skill["Wiki maintainer skill<br/>[SKILL.md]"]
end

subgraph group_inputs["Research inputs"]
  node_session_raw["Session records"]
  node_research_raw["Research notes"]
  node_inbox["Inbox"]
end

subgraph group_knowledge["Knowledge vault"]
  node_wiki["Wiki notes"]
  node_overview["Wiki overview<br/>[overview.md]"]
  node_index["Vault index<br/>[index.md]"]
end

subgraph group_guidance["Vault guidance"]
  node_templates["Note templates"]
  node_guide["Usage guide<br/>[KILAVUZ.md]"]
end

node_user(("User"))

node_user -->|"runs"| node_capture
node_user -->|"runs"| node_weekly
node_user -->|"runs"| node_ingest
node_user -->|"runs"| node_query
node_user -->|"runs"| node_lint
node_capture -->|"captures"| node_session_raw
node_weekly -->|"creates"| node_research_raw
node_ingest -->|"reads"| node_inbox
node_ingest -->|"updates"| node_wiki
node_query -->|"searches"| node_wiki
node_lint -->|"checks"| node_wiki
node_research_skill -.->|"guides research"| node_research_raw
node_maintainer_skill -.->|"guides maintenance"| node_wiki
node_wiki -->|"includes"| node_overview
node_wiki -.->|"summarized by"| node_index
node_templates -.->|"structures notes"| node_wiki
node_guide -->|"explains use"| node_user

click node_capture "https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/oturum-kaydet.md"
click node_weekly "https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/research-weekly.md"
click node_ingest "https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/wiki-ingest.md"
click node_query "https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/wiki-query.md"
click node_lint "https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/wiki-lint.md"
click node_research_skill "https://github.com/mhsnnclk/leonidas/blob/master/.opencode/skills/researcher/SKILL.md"
click node_maintainer_skill "https://github.com/mhsnnclk/leonidas/blob/master/.opencode/skills/wiki-maintainer/SKILL.md"
click node_session_raw "https://github.com/mhsnnclk/leonidas/tree/master/raw/sessions"
click node_research_raw "https://github.com/mhsnnclk/leonidas/tree/master/raw/research"
click node_inbox "https://github.com/mhsnnclk/leonidas/tree/master/raw/inbox"
click node_wiki "https://github.com/mhsnnclk/leonidas/tree/master/wiki"
click node_overview "https://github.com/mhsnnclk/leonidas/blob/master/wiki/overview.md"
click node_index "https://github.com/mhsnnclk/leonidas/blob/master/index.md"
click node_templates "https://github.com/mhsnnclk/leonidas/tree/master/templates"
click node_guide "https://github.com/mhsnnclk/leonidas/blob/master/KILAVUZ.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_capture,node_weekly,node_ingest,node_query,node_lint,node_research_skill,node_maintainer_skill,node_user toneBlue
class node_session_raw,node_research_raw,node_inbox toneAmber
class node_wiki,node_overview,node_index toneMint
class node_templates,node_guide toneRose
```

## Components

### OpenCode workflows

- [Session capture](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/oturum-kaydet.md): `.opencode/commands/oturum-kaydet.md`
- [Weekly research](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/research-weekly.md): `.opencode/commands/research-weekly.md`
- [Wiki ingest](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/wiki-ingest.md): `.opencode/commands/wiki-ingest.md`
- [Wiki query](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/wiki-query.md): `.opencode/commands/wiki-query.md`
- [Wiki lint](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/commands/wiki-lint.md): `.opencode/commands/wiki-lint.md`
- [Researcher skill](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/skills/researcher/SKILL.md): `.opencode/skills/researcher/SKILL.md`
- [Wiki maintainer skill](https://github.com/mhsnnclk/leonidas/blob/master/.opencode/skills/wiki-maintainer/SKILL.md): `.opencode/skills/wiki-maintainer/SKILL.md`

### Research inputs

- [Session records](https://github.com/mhsnnclk/leonidas/tree/master/raw/sessions): `raw/sessions`
- [Research notes](https://github.com/mhsnnclk/leonidas/tree/master/raw/research): `raw/research`
- [Inbox](https://github.com/mhsnnclk/leonidas/tree/master/raw/inbox): `raw/inbox`

### Knowledge vault

- [Wiki notes](https://github.com/mhsnnclk/leonidas/tree/master/wiki): `wiki`
- [Wiki overview](https://github.com/mhsnnclk/leonidas/blob/master/wiki/overview.md): `wiki/overview.md`
- [Vault index](https://github.com/mhsnnclk/leonidas/blob/master/index.md): `index.md`

### Vault guidance

- [Note templates](https://github.com/mhsnnclk/leonidas/tree/master/templates): `templates`
- [Usage guide](https://github.com/mhsnnclk/leonidas/blob/master/KILAVUZ.md): `KILAVUZ.md`

### Other components

- **User**

## Connections

- User → Session capture: runs
- User → Weekly research: runs
- User → Wiki ingest: runs
- User → Wiki query: runs
- User → Wiki lint: runs
- Session capture → Session records: captures
- Weekly research → Research notes: creates
- Wiki ingest → Inbox: reads
- Wiki ingest → Wiki notes: updates
- Wiki query → Wiki notes: searches
- Wiki lint → Wiki notes: checks
- Researcher skill → Research notes: guides research
- Wiki maintainer skill → Wiki notes: guides maintenance
- Wiki notes → Wiki overview: includes
- Wiki notes → Vault index: summarized by
- Note templates → Wiki notes: structures notes
- Usage guide → User: explains use