# nykooi1/vibe-wise architecture

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

- Interactive diagram: https://gitdiagram.com/nykooi1/vibe-wise
- Repository: https://github.com/nykooi1/vibe-wise

## Overview

VibeWise is a Claude Code learning plugin: a developer invokes Learn, works through onboarding and guided build/design/implementation checkpoints, and keeps project learning notes that can be restored in later sessions. Reset previews and backs up those notes before restarting onboarding. The graph includes the documented coaching and preference capabilities, plus the sampled hook and reset runtime. The skill guides and hook configuration are represented from the repository tree and README; their internal behavior was not sampled.

Main entry points: [`skills/reset/reset.py`](https://github.com/nykooi1/vibe-wise/blob/main/skills/reset/reset.py) (Reset runtime), [`hooks/session_start.py`](https://github.com/nykooi1/vibe-wise/blob/main/hooks/session_start.py) (Session restore), [`skills/learn/SKILL.md`](https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/SKILL.md) (Learning guide), [`skills/reset/SKILL.md`](https://github.com/nykooi1/vibe-wise/blob/main/skills/reset/SKILL.md) (Reset command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Guided Learning"]
  node_onboarding["Onboarding<br/>[onboarding.md]"]
  node_learning_guide["Learning guide<br/>[SKILL.md]"]
  node_behavior["Coaching behavior<br/>[behavior.md]"]
end

subgraph group_state["Learning State"]
  node_state_templates["State templates<br/>[state-templates.md]"]
  node_learner_notes[("Project notes")]
end

subgraph group_lifecycle["Session Lifecycle"]
  node_session_hook["Session restore<br/>[session_start.py]"]
  node_reset_runtime["Reset runtime<br/>[reset.py]"]
end

subgraph group_plugin["Plugin Entry Points"]
  node_learn_command["Learn command<br/>[SKILL.md]"]
  node_hook_config["Hook configuration<br/>[hooks.json]"]
  node_reset_command["Reset command<br/>[SKILL.md]"]
end

node_developer(("Developer"))
node_claude["Claude Code"]

node_developer -->|"invokes Learn"| node_learn_command
node_learn_command -->|"guides setup"| node_onboarding
node_claude -->|"follows guide"| node_learning_guide
node_learning_guide -.->|"uses guidance"| node_behavior
node_learning_guide -.->|"uses templates"| node_state_templates
node_claude -->|"saves learning notes"| node_learner_notes
node_session_hook -->|"checks and locates"| node_learner_notes
node_session_hook -->|"restores context"| node_claude
node_hook_config -->|"triggers hook"| node_session_hook
node_developer -->|"invokes reset"| node_reset_command
node_reset_command -.->|"runs reset"| node_reset_runtime
node_reset_runtime -->|"previews and resets"| node_learner_notes
node_reset_runtime -->|"backs up notes"| node_learner_notes
node_reset_runtime -->|"reuses state lookup"| node_session_hook

click node_learn_command "https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/SKILL.md"
click node_onboarding "https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/onboarding.md"
click node_learning_guide "https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/SKILL.md"
click node_behavior "https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/behavior.md"
click node_state_templates "https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/state-templates.md"
click node_session_hook "https://github.com/nykooi1/vibe-wise/blob/main/hooks/session_start.py"
click node_hook_config "https://github.com/nykooi1/vibe-wise/blob/main/hooks/hooks.json"
click node_reset_command "https://github.com/nykooi1/vibe-wise/blob/main/skills/reset/SKILL.md"
click node_reset_runtime "https://github.com/nykooi1/vibe-wise/blob/main/skills/reset/reset.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_onboarding,node_learning_guide,node_behavior toneBlue
class node_state_templates,node_learner_notes toneAmber
class node_session_hook,node_reset_runtime toneMint
class node_learn_command,node_hook_config,node_reset_command toneRose
class node_developer,node_claude toneIndigo
```

## Components

### Guided Learning

- [Onboarding](https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/onboarding.md): `skills/learn/onboarding.md`
- [Learning guide](https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/SKILL.md): `skills/learn/SKILL.md`
- [Coaching behavior](https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/behavior.md): `skills/learn/behavior.md`

### Learning State

- [State templates](https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/state-templates.md): `skills/learn/state-templates.md`
- **Project notes**

### Session Lifecycle

- [Session restore](https://github.com/nykooi1/vibe-wise/blob/main/hooks/session_start.py): `hooks/session_start.py`
- [Reset runtime](https://github.com/nykooi1/vibe-wise/blob/main/skills/reset/reset.py): `skills/reset/reset.py`

### Plugin Entry Points

- [Learn command](https://github.com/nykooi1/vibe-wise/blob/main/skills/learn/SKILL.md): `skills/learn/SKILL.md`
- [Hook configuration](https://github.com/nykooi1/vibe-wise/blob/main/hooks/hooks.json): `hooks/hooks.json`
- [Reset command](https://github.com/nykooi1/vibe-wise/blob/main/skills/reset/SKILL.md): `skills/reset/SKILL.md`

### Other components

- **Developer**
- **Claude Code**

## Connections

- Developer → Learn command: invokes Learn (evidence: `README.md`)
- Learn command → Onboarding: guides setup (evidence: `README.md`)
- Claude Code → Learning guide: follows guide
- Learning guide → Coaching behavior: uses guidance
- Learning guide → State templates: uses templates
- Claude Code → Project notes: saves learning notes (evidence: `README.md`)
- Session restore → Project notes: checks and locates (evidence: `hooks/session_start.py`)
- Session restore → Claude Code: restores context (evidence: `hooks/session_start.py`)
- Hook configuration → Session restore: triggers hook (evidence: `hooks/session_start.py`)
- Developer → Reset command: invokes reset (evidence: `README.md`)
- Reset command → Reset runtime: runs reset
- Reset runtime → Project notes: previews and resets (evidence: `skills/reset/reset.py`)
- Reset runtime → Project notes: backs up notes (evidence: `skills/reset/reset.py`)
- Reset runtime → Session restore: reuses state lookup (evidence: `skills/reset/reset.py`)
