# hoavdc/codexkit architecture

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

- Interactive diagram: https://gitdiagram.com/hoavdc/codexkit
- Repository: https://github.com/hoavdc/codexkit

## Overview

CodexKit is an operating kit for using Codex and ChatGPT in repeatable engineering and knowledge-work workflows. Users find a suitable skill, install or discover it through Codex’s standard skills locations, then apply playbooks, automation recipes, templates, and workspace kits to carry work through execution and review. MCP guidance supports deliberate optional integrations. The Next.js site presents the kit and its documentation. Core pack directories are identified by the README but are not present in the supplied tree; their internal wiring is therefore not represented.

Main entry points: [`web/src/app`](https://github.com/hoavdc/codexkit/tree/main/web/src/app) (Docs site), [`skills`](https://github.com/hoavdc/codexkit/tree/main/skills) (Codex skills), [`web/src/components/layout/header/components/search-dialog.tsx`](https://github.com/hoavdc/codexkit/blob/main/web/src/components/layout/header/components/search-dialog.tsx) (Docs search), [`web/src/app/layout.tsx`](https://github.com/hoavdc/codexkit/blob/main/web/src/app/layout.tsx) (Site shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pack["Operating Kit"]
  node_skills["Codex skills"]
  node_playbooks["Prompt playbooks"]
  node_automations["Automation recipes"]
  node_templates["Reusable templates"]
  node_workspaces["Starter workspaces"]
end

subgraph group_guidance["Adoption Guidance"]
  node_finder["Skill finder<br/>[skill-finder.md]"]
  node_mcp["MCP guidance"]
end

subgraph group_site["Documentation Site"]
  node_docs["Docs site"]
  node_home["Kit overview<br/>[page.tsx]"]
  node_search["Docs search<br/>[search-dialog.tsx]"]
  node_site_layout["Site shell<br/>[layout.tsx]"]
  node_theme["Theme provider<br/>[theme-provider.tsx]"]
end

node_operator(("Operator or team"))
node_codex(("Codex"))

node_operator -->|"finds a skill"| node_finder
node_operator -->|"chooses and installs"| node_skills
node_skills -->|"discover and invoke"| node_codex
node_operator -->|"applies prompts"| node_playbooks
node_operator -->|"adapts recipes"| node_automations
node_operator -->|"reuses formats"| node_templates
node_operator -->|"starts from kit"| node_workspaces
node_operator -->|"consults guidance"| node_mcp
node_operator -->|"browses kit"| node_docs
node_docs -->|"renders overview"| node_home
node_docs -->|"uses shell"| node_site_layout
node_site_layout -->|"provides theme"| node_theme
node_operator -->|"searches docs"| node_search
node_search -->|"navigates to pages"| node_docs

click node_finder "https://github.com/hoavdc/codexkit/blob/main/skill-finder.md"
click node_skills "https://github.com/hoavdc/codexkit/tree/main/skills"
click node_playbooks "https://github.com/hoavdc/codexkit/tree/main/playbooks"
click node_automations "https://github.com/hoavdc/codexkit/tree/main/automations"
click node_templates "https://github.com/hoavdc/codexkit/tree/main/templates"
click node_workspaces "https://github.com/hoavdc/codexkit/tree/main/workspaces"
click node_mcp "https://github.com/hoavdc/codexkit/tree/main/mcp"
click node_docs "https://github.com/hoavdc/codexkit/tree/main/web/src/app"
click node_home "https://github.com/hoavdc/codexkit/blob/main/web/src/app/page.tsx"
click node_search "https://github.com/hoavdc/codexkit/blob/main/web/src/components/layout/header/components/search-dialog.tsx"
click node_site_layout "https://github.com/hoavdc/codexkit/blob/main/web/src/app/layout.tsx"
click node_theme "https://github.com/hoavdc/codexkit/blob/main/web/src/components/theme-provider.tsx"

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_skills,node_playbooks,node_automations,node_templates,node_workspaces toneBlue
class node_finder,node_mcp toneAmber
class node_docs,node_home,node_search,node_site_layout,node_theme toneMint
class node_operator,node_codex toneIndigo
```

## Components

### Operating Kit

- [Codex skills](https://github.com/hoavdc/codexkit/tree/main/skills): `skills`
- [Prompt playbooks](https://github.com/hoavdc/codexkit/tree/main/playbooks): `playbooks`
- [Automation recipes](https://github.com/hoavdc/codexkit/tree/main/automations): `automations`
- [Reusable templates](https://github.com/hoavdc/codexkit/tree/main/templates): `templates`
- [Starter workspaces](https://github.com/hoavdc/codexkit/tree/main/workspaces): `workspaces`

### Adoption Guidance

- [Skill finder](https://github.com/hoavdc/codexkit/blob/main/skill-finder.md): `skill-finder.md`
- [MCP guidance](https://github.com/hoavdc/codexkit/tree/main/mcp): `mcp`

### Documentation Site

- [Docs site](https://github.com/hoavdc/codexkit/tree/main/web/src/app): `web/src/app`
- [Kit overview](https://github.com/hoavdc/codexkit/blob/main/web/src/app/page.tsx): `web/src/app/page.tsx`
- [Docs search](https://github.com/hoavdc/codexkit/blob/main/web/src/components/layout/header/components/search-dialog.tsx): `web/src/components/layout/header/components/search-dialog.tsx`
- [Site shell](https://github.com/hoavdc/codexkit/blob/main/web/src/app/layout.tsx): `web/src/app/layout.tsx`
- [Theme provider](https://github.com/hoavdc/codexkit/blob/main/web/src/components/theme-provider.tsx): `web/src/components/theme-provider.tsx`

### Other components

- **Operator or team**
- **Codex**

## Connections

- Operator or team → Skill finder: finds a skill
- Operator or team → Codex skills: chooses and installs
- Codex skills → Codex: discover and invoke
- Operator or team → Prompt playbooks: applies prompts
- Operator or team → Automation recipes: adapts recipes
- Operator or team → Reusable templates: reuses formats
- Operator or team → Starter workspaces: starts from kit
- Operator or team → MCP guidance: consults guidance
- Operator or team → Docs site: browses kit
- Docs site → Kit overview: renders overview
- Docs site → Site shell: uses shell
- Site shell → Theme provider: provides theme
- Operator or team → Docs search: searches docs
- Docs search → Docs site: navigates to pages