# dotkernel/dotboost architecture

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

- Interactive diagram: https://gitdiagram.com/dotkernel/dotboost
- Repository: https://github.com/dotkernel/dotboost

## Overview

dotboost is a drop-in Claude Code configuration for Dotkernel projects, not an application runtime. An engineer installs `.claude/` in a project; Claude Code then uses its settings, `/dk-*` commands, skills, and review agent to guide project work. Settings register hooks and the status line. The README documents these roles and some configuration behavior, but no source excerpts were supplied, so internal hook and skill call relationships are omitted.

Main entry points: [`.claude/skills`](https://github.com/dotkernel/dotboost/tree/main/.claude/skills) (Dotkernel Skills), [`.claude/settings.json`](https://github.com/dotkernel/dotboost/blob/main/.claude/settings.json) (Settings), [`.claude/hooks`](https://github.com/dotkernel/dotboost/tree/main/.claude/hooks) (Shell Hooks), [`.claude/settings.local.json.example`](https://github.com/dotkernel/dotboost/blob/main/.claude/settings.local.json.example) (Local Overrides)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_config["Configuration"]
  node_settings["Settings<br/>[settings.json]"]
  node_local["Local Overrides"]
  node_statusline["Usage Status Line<br/>[statusline.sh]"]
end

subgraph group_interaction["Claude Interaction"]
  node_commands["DK Commands<br/>[commands]"]
  node_reviewer["Review Agent"]
end

subgraph group_guidance["Project Guidance"]
  node_skills["Dotkernel Skills<br/>[skills]"]
  node_dependency["Dependency Policy<br/>[dependency-policy]"]
  node_variants["Variant Guidance"]
  node_architecture["Module Architecture"]
  node_validation["Input Validation"]
  node_responses["Response Guidance"]
  node_openapi["OpenAPI Guidance<br/>[dotkernel-openapi]"]
  node_doctrine["Doctrine Entities"]
  node_security["Security Guidance<br/>[dotkernel-security]"]
end

subgraph group_safeguards["Guardrails"]
  node_hooks["Shell Hooks<br/>[hooks]"]
  node_lintconfig["Markdown Rules<br/>[markdownlint.jsonc]"]
end

node_engineer(("Engineer"))
node_claude["Claude Code"]
node_dotkernel["Dotkernel Project"]

node_engineer -->|"works in"| node_dotkernel
node_engineer -->|"consults"| node_claude
node_claude -->|"loads"| node_settings
node_claude -->|"uses"| node_commands
node_claude -->|"delegates review"| node_reviewer
node_claude -->|"consults"| node_skills
node_settings -->|"registers"| node_hooks
node_settings -->|"configures"| node_statusline
node_local -.->|"overrides"| node_settings
node_hooks -.->|"uses rules"| node_lintconfig
node_skills -->|"includes"| node_dependency
node_skills -->|"includes"| node_variants
node_skills -->|"includes"| node_architecture
node_skills -->|"includes"| node_validation
node_skills -->|"includes"| node_responses
node_skills -->|"includes"| node_openapi
node_skills -->|"includes"| node_doctrine
node_skills -->|"includes"| node_security

click node_settings "https://github.com/dotkernel/dotboost/blob/main/.claude/settings.json"
click node_local "https://github.com/dotkernel/dotboost/blob/main/.claude/settings.local.json.example"
click node_statusline "https://github.com/dotkernel/dotboost/blob/main/.claude/statusline.sh"
click node_commands "https://github.com/dotkernel/dotboost/tree/main/.claude/commands"
click node_reviewer "https://github.com/dotkernel/dotboost/blob/main/.claude/agents/dotkernel-reviewer.md"
click node_skills "https://github.com/dotkernel/dotboost/tree/main/.claude/skills"
click node_dependency "https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dependency-policy"
click node_variants "https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-application-variants"
click node_architecture "https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-module-structure"
click node_validation "https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-input-validation"
click node_responses "https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-responses"
click node_openapi "https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-openapi"
click node_doctrine "https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-doctrine-entities"
click node_security "https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-security"
click node_hooks "https://github.com/dotkernel/dotboost/tree/main/.claude/hooks"
click node_lintconfig "https://github.com/dotkernel/dotboost/blob/main/.claude/markdownlint.jsonc"

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_settings,node_local,node_statusline toneBlue
class node_commands,node_reviewer toneAmber
class node_skills,node_dependency,node_variants,node_architecture,node_validation,node_responses,node_openapi,node_doctrine,node_security toneMint
class node_hooks,node_lintconfig toneRose
class node_engineer,node_claude,node_dotkernel toneIndigo
```

## Components

### Configuration

- [Settings](https://github.com/dotkernel/dotboost/blob/main/.claude/settings.json): `.claude/settings.json`
- [Local Overrides](https://github.com/dotkernel/dotboost/blob/main/.claude/settings.local.json.example): `.claude/settings.local.json.example`
- [Usage Status Line](https://github.com/dotkernel/dotboost/blob/main/.claude/statusline.sh): `.claude/statusline.sh`

### Claude Interaction

- [DK Commands](https://github.com/dotkernel/dotboost/tree/main/.claude/commands): `.claude/commands`
- [Review Agent](https://github.com/dotkernel/dotboost/blob/main/.claude/agents/dotkernel-reviewer.md): `.claude/agents/dotkernel-reviewer.md`

### Project Guidance

- [Dotkernel Skills](https://github.com/dotkernel/dotboost/tree/main/.claude/skills): `.claude/skills`
- [Dependency Policy](https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dependency-policy): `.claude/skills/dependency-policy`
- [Variant Guidance](https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-application-variants): `.claude/skills/dotkernel-application-variants`
- [Module Architecture](https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-module-structure): `.claude/skills/dotkernel-module-structure`
- [Input Validation](https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-input-validation): `.claude/skills/dotkernel-input-validation`
- [Response Guidance](https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-responses): `.claude/skills/dotkernel-responses`
- [OpenAPI Guidance](https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-openapi): `.claude/skills/dotkernel-openapi`
- [Doctrine Entities](https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-doctrine-entities): `.claude/skills/dotkernel-doctrine-entities`
- [Security Guidance](https://github.com/dotkernel/dotboost/tree/main/.claude/skills/dotkernel-security): `.claude/skills/dotkernel-security`

### Guardrails

- [Shell Hooks](https://github.com/dotkernel/dotboost/tree/main/.claude/hooks): `.claude/hooks`
- [Markdown Rules](https://github.com/dotkernel/dotboost/blob/main/.claude/markdownlint.jsonc): `.claude/markdownlint.jsonc`

### Other components

- **Engineer**
- **Claude Code**
- **Dotkernel Project**

## Connections

- Engineer → Dotkernel Project: works in
- Engineer → Claude Code: consults
- Claude Code → Settings: loads
- Claude Code → DK Commands: uses
- Claude Code → Review Agent: delegates review
- Claude Code → Dotkernel Skills: consults
- Settings → Shell Hooks: registers
- Settings → Usage Status Line: configures
- Local Overrides → Settings: overrides
- Shell Hooks → Markdown Rules: uses rules
- Dotkernel Skills → Dependency Policy: includes
- Dotkernel Skills → Variant Guidance: includes
- Dotkernel Skills → Module Architecture: includes
- Dotkernel Skills → Input Validation: includes
- Dotkernel Skills → Response Guidance: includes
- Dotkernel Skills → OpenAPI Guidance: includes
- Dotkernel Skills → Doctrine Entities: includes
- Dotkernel Skills → Security Guidance: includes