# sterlingchin/marvin-template architecture

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

- Interactive diagram: https://gitdiagram.com/sterlingchin/marvin-template
- Repository: https://github.com/sterlingchin/marvin-template

## Overview

MARVIN is a Claude Code-based personal assistant, configured primarily through Markdown commands, agents, and skills, with separate workspace data and optional integrations. The documented daily workflow starts with a briefing, continues across sessions, and saves context at session end; checkpointing and weekly reporting are additional workflows. The graph reflects README-documented capabilities and relationships only: no source excerpts were provided, so implementation-level calls and data flow cannot be verified.

Main entry points: [`.marvin/integrations`](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations) (Integration setup), [`.claude/commands`](https://github.com/sterlingchin/marvin-template/tree/main/.claude/commands) (Slash commands), [`.claude/commands/start.md`](https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/start.md) (Start briefing), [`.claude/commands/end.md`](https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/end.md) (End session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Daily workflow"]
  node_start["Start briefing<br/>[start.md]"]
  node_end["End session<br/>[end.md]"]
  node_update["Checkpoint<br/>[update.md]"]
  node_report["Weekly report<br/>[report.md]"]
  node_sync["Template sync<br/>[sync.md]"]
end

subgraph group_workspace["Personal workspace"]
  node_sessions["Session logs"]
  node_state["Goals and priorities"]
  node_workspace["Personal workspace"]
end

subgraph group_extension["Assistant extensions"]
  node_commands["Slash commands<br/>[commands]"]
  node_agents["Specialist agents<br/>[agents]"]
  node_skills["Reusable skills<br/>[skills]"]
end

subgraph group_integrations["Tool integrations"]
  node_integrations["Integration setup<br/>[integrations]"]
  node_google["Google Workspace<br/>[google-workspace]"]
  node_ms365["Microsoft 365<br/>[ms365]"]
  node_atlassian["Atlassian<br/>[atlassian]"]
  node_slack["Slack<br/>[slack]"]
  node_linear["Linear<br/>[linear]"]
  node_notion["Notion<br/>[notion]"]
  node_telegram["Telegram<br/>[telegram]"]
  node_parallel["Parallel Search<br/>[parallel-search]"]
end

node_user(("User"))
node_connected_tools(("Connected services"))

node_user -->|"invokes"| node_start
node_user -->|"invokes"| node_end
node_user -->|"invokes"| node_update
node_user -->|"invokes"| node_report
node_end -->|"saves context"| node_sessions
node_update -->|"saves progress"| node_workspace
node_sync -->|"updates features"| node_workspace
node_user -->|"invokes"| node_sync
node_start -->|"briefs goals"| node_state
node_integrations -->|"configures"| node_google
node_integrations -->|"configures"| node_ms365
node_integrations -->|"configures"| node_atlassian
node_integrations -->|"configures"| node_slack
node_integrations -->|"configures"| node_linear
node_integrations -->|"configures"| node_notion
node_integrations -->|"configures"| node_telegram
node_integrations -->|"configures"| node_parallel
node_google -.->|"connects"| node_connected_tools
node_ms365 -.->|"connects"| node_connected_tools
node_atlassian -.->|"connects"| node_connected_tools
node_slack -.->|"connects"| node_connected_tools
node_linear -.->|"connects"| node_connected_tools
node_notion -.->|"connects"| node_connected_tools
node_telegram -.->|"connects"| node_connected_tools
node_parallel -.->|"connects"| node_connected_tools
node_commands -->|"offers workflows"| node_user
node_agents -.->|"supports delegated work"| node_commands
node_skills -.->|"extends capabilities"| node_commands

click node_start "https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/start.md"
click node_end "https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/end.md"
click node_update "https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/update.md"
click node_report "https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/report.md"
click node_sessions "https://github.com/sterlingchin/marvin-template/tree/main/sessions"
click node_state "https://github.com/sterlingchin/marvin-template/tree/main/state"
click node_sync "https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/sync.md"
click node_workspace "https://github.com/sterlingchin/marvin-template/tree/main/state"
click node_commands "https://github.com/sterlingchin/marvin-template/tree/main/.claude/commands"
click node_agents "https://github.com/sterlingchin/marvin-template/tree/main/.claude/agents"
click node_skills "https://github.com/sterlingchin/marvin-template/tree/main/.claude/skills"
click node_integrations "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations"
click node_google "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/google-workspace"
click node_ms365 "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/ms365"
click node_atlassian "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/atlassian"
click node_slack "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/slack"
click node_linear "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/linear"
click node_notion "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/notion"
click node_telegram "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/telegram"
click node_parallel "https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/parallel-search"

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_start,node_end,node_update,node_report,node_sync,node_user toneBlue
class node_sessions,node_state,node_workspace toneAmber
class node_commands,node_agents,node_skills toneMint
class node_integrations,node_google,node_ms365,node_atlassian,node_slack,node_linear,node_notion,node_telegram,node_parallel toneRose
class node_connected_tools toneIndigo
```

## Components

### Daily workflow

- [Start briefing](https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/start.md): `.claude/commands/start.md`
- [End session](https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/end.md): `.claude/commands/end.md`
- [Checkpoint](https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/update.md): `.claude/commands/update.md`
- [Weekly report](https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/report.md): `.claude/commands/report.md`
- [Template sync](https://github.com/sterlingchin/marvin-template/blob/main/.claude/commands/sync.md): `.claude/commands/sync.md`

### Personal workspace

- [Session logs](https://github.com/sterlingchin/marvin-template/tree/main/sessions): `sessions`
- [Goals and priorities](https://github.com/sterlingchin/marvin-template/tree/main/state): `state`
- [Personal workspace](https://github.com/sterlingchin/marvin-template/tree/main/state): `state`

### Assistant extensions

- [Slash commands](https://github.com/sterlingchin/marvin-template/tree/main/.claude/commands): `.claude/commands`
- [Specialist agents](https://github.com/sterlingchin/marvin-template/tree/main/.claude/agents): `.claude/agents`
- [Reusable skills](https://github.com/sterlingchin/marvin-template/tree/main/.claude/skills): `.claude/skills`

### Tool integrations

- [Integration setup](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations): `.marvin/integrations`
- [Google Workspace](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/google-workspace): `.marvin/integrations/google-workspace`
- [Microsoft 365](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/ms365): `.marvin/integrations/ms365`
- [Atlassian](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/atlassian): `.marvin/integrations/atlassian`
- [Slack](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/slack): `.marvin/integrations/slack`
- [Linear](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/linear): `.marvin/integrations/linear`
- [Notion](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/notion): `.marvin/integrations/notion`
- [Telegram](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/telegram): `.marvin/integrations/telegram`
- [Parallel Search](https://github.com/sterlingchin/marvin-template/tree/main/.marvin/integrations/parallel-search): `.marvin/integrations/parallel-search`

### Other components

- **User**
- **Connected services**

## Connections

- User → Start briefing: invokes (evidence: `README.md`)
- User → End session: invokes (evidence: `README.md`)
- User → Checkpoint: invokes (evidence: `README.md`)
- User → Weekly report: invokes (evidence: `README.md`)
- End session → Session logs: saves context (evidence: `README.md`)
- Checkpoint → Personal workspace: saves progress (evidence: `README.md`)
- Template sync → Personal workspace: updates features (evidence: `README.md`)
- User → Template sync: invokes (evidence: `README.md`)
- Start briefing → Goals and priorities: briefs goals (evidence: `README.md`)
- Integration setup → Google Workspace: configures (evidence: `README.md`)
- Integration setup → Microsoft 365: configures (evidence: `README.md`)
- Integration setup → Atlassian: configures (evidence: `README.md`)
- Integration setup → Slack: configures (evidence: `README.md`)
- Integration setup → Linear: configures (evidence: `README.md`)
- Integration setup → Notion: configures (evidence: `README.md`)
- Integration setup → Telegram: configures (evidence: `README.md`)
- Integration setup → Parallel Search: configures (evidence: `README.md`)
- Google Workspace → Connected services: connects (evidence: `README.md`)
- Microsoft 365 → Connected services: connects (evidence: `README.md`)
- Atlassian → Connected services: connects (evidence: `README.md`)
- Slack → Connected services: connects (evidence: `README.md`)
- Linear → Connected services: connects (evidence: `README.md`)
- Notion → Connected services: connects (evidence: `README.md`)
- Telegram → Connected services: connects (evidence: `README.md`)
- Parallel Search → Connected services: connects (evidence: `README.md`)
- Slash commands → User: offers workflows (evidence: `README.md`)
- Specialist agents → Slash commands: supports delegated work (evidence: `README.md`)
- Reusable skills → Slash commands: extends capabilities (evidence: `README.md`)
