# gpjr1991/vibe-coding-toolkit architecture

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

- Interactive diagram: https://gitdiagram.com/gpjr1991/vibe-coding-toolkit
- Repository: https://github.com/gpjr1991/vibe-coding-toolkit

## Overview

Vibe Coding Toolkit is an agent-executed collection of guides, prompts, and templates—not an application that runs a setup pipeline itself. Its main workflow is to inspect a machine or project, choose and configure relevant foundations, then verify the changes. The README also documents orchestration and ongoing quality/context practices. Source excerpts show the reusable ESLint rules and templates; other capabilities are represented at their documented directory level because their implementation was not sampled.

Main entry points: [`docs/04-project-bootstrap.md`](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/04-project-bootstrap.md) (Project bootstrap), [`docs/02-playbook-onboarding.md`](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/02-playbook-onboarding.md) (Agent workflow), [`templates/eslint`](https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/eslint) (ESLint profiles), [`docs/prompts/12-existing-project-setup.md`](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/prompts/12-existing-project-setup.md) (Existing projects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Setup guidance"]
  node_machine["Machine setup"]
  node_project["Project bootstrap"]
  node_existing["Existing projects"]
  node_prompts["Task prompts"]
  node_orchestration["Agent workflow"]
end

subgraph group_templates["Project foundations"]
  node_docs["Generated project docs"]
  node_next["Next foundation"]
end

subgraph group_quality["Quality toolkit"]
  node_eslintconfigs["ESLint profiles"]
  node_rules["Quality rules<br/>[core-rules.cjs]"]
  node_ruleutils["Rule utilities<br/>[utils.cjs]"]
  node_ruleindex["Rule plugin<br/>[index.cjs]"]
  node_harness["Harness evaluation"]
end

subgraph group_agent["Agent context"]
  node_instructions["Agent instructions<br/>[AGENTS.md.template]"]
  node_skills["Tool guides"]
  node_rulesdocs["Agent rules"]
  node_taskdocs["Task handoff"]
end

node_user(("Engineer"))

node_user -->|"prepare machine"| node_machine
node_user -->|"start project"| node_project
node_user -->|"upgrade project"| node_existing
node_user -->|"select task"| node_prompts
node_user -->|"direct agent"| node_orchestration
node_project -->|"configure foundation"| node_next
node_project -->|"create documentation"| node_docs
node_project -->|"configure quality"| node_eslintconfigs
node_existing -->|"adopt components"| node_eslintconfigs
node_eslintconfigs -->|"loads plugin"| node_ruleindex
node_ruleindex -->|"exports rules"| node_rules
node_rules -->|"uses helpers"| node_ruleutils
node_project -->|"evaluate harness"| node_harness
node_orchestration -->|"apply guidance"| node_skills
node_orchestration -->|"follow instructions"| node_instructions
node_orchestration -->|"apply agreements"| node_rulesdocs
node_orchestration -.->|"handoff work"| node_taskdocs

click node_machine "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/03-environment-setup.md"
click node_project "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/04-project-bootstrap.md"
click node_existing "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/prompts/12-existing-project-setup.md"
click node_prompts "https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/docs/prompts"
click node_orchestration "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/02-playbook-onboarding.md"
click node_docs "https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/project-docs"
click node_next "https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/next"
click node_eslintconfigs "https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/eslint"
click node_rules "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/eslint/eslint-rules/core-rules.cjs"
click node_ruleutils "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/eslint/eslint-rules/utils.cjs"
click node_ruleindex "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/eslint/eslint-rules/index.cjs"
click node_harness "https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/harness-evaluation"
click node_instructions "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/AGENTS.md.template"
click node_skills "https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/docs/tools"
click node_rulesdocs "https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/rules"
click node_taskdocs "https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/task-handoff.md.template"

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_machine,node_project,node_existing,node_prompts,node_orchestration toneBlue
class node_docs,node_next toneAmber
class node_eslintconfigs,node_rules,node_ruleutils,node_ruleindex,node_harness toneMint
class node_instructions,node_skills,node_rulesdocs,node_taskdocs toneRose
class node_user toneIndigo
```

## Components

### Setup guidance

- [Machine setup](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/03-environment-setup.md): `docs/03-environment-setup.md`
- [Project bootstrap](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/04-project-bootstrap.md): `docs/04-project-bootstrap.md`
- [Existing projects](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/prompts/12-existing-project-setup.md): `docs/prompts/12-existing-project-setup.md`
- [Task prompts](https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/docs/prompts): `docs/prompts`
- [Agent workflow](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/docs/02-playbook-onboarding.md): `docs/02-playbook-onboarding.md`

### Project foundations

- [Generated project docs](https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/project-docs): `templates/project-docs`
- [Next foundation](https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/next): `templates/next`

### Quality toolkit

- [ESLint profiles](https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/eslint): `templates/eslint`
- [Quality rules](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/eslint/eslint-rules/core-rules.cjs): `templates/eslint/eslint-rules/core-rules.cjs`
- [Rule utilities](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/eslint/eslint-rules/utils.cjs): `templates/eslint/eslint-rules/utils.cjs`
- [Rule plugin](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/eslint/eslint-rules/index.cjs): `templates/eslint/eslint-rules/index.cjs`
- [Harness evaluation](https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/harness-evaluation): `templates/harness-evaluation`

### Agent context

- [Agent instructions](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/AGENTS.md.template): `templates/AGENTS.md.template`
- [Tool guides](https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/docs/tools): `docs/tools`
- [Agent rules](https://github.com/gpjr1991/vibe-coding-toolkit/tree/main/templates/rules): `templates/rules`
- [Task handoff](https://github.com/gpjr1991/vibe-coding-toolkit/blob/main/templates/task-handoff.md.template): `templates/task-handoff.md.template`

### Other components

- **Engineer**

## Connections

- Engineer → Machine setup: prepare machine (evidence: `README.md`)
- Engineer → Project bootstrap: start project (evidence: `README.md`)
- Engineer → Existing projects: upgrade project (evidence: `README.md`)
- Engineer → Task prompts: select task (evidence: `README.md`)
- Engineer → Agent workflow: direct agent (evidence: `README.md`)
- Project bootstrap → Next foundation: configure foundation (evidence: `README.md`)
- Project bootstrap → Generated project docs: create documentation (evidence: `README.md`)
- Project bootstrap → ESLint profiles: configure quality (evidence: `README.md`)
- Existing projects → ESLint profiles: adopt components (evidence: `README.md`)
- ESLint profiles → Rule plugin: loads plugin (evidence: `templates/eslint/eslint-rules/next-base.mjs`)
- Rule plugin → Quality rules: exports rules (evidence: `templates/eslint/eslint-rules/index.cjs`)
- Quality rules → Rule utilities: uses helpers (evidence: `templates/eslint/eslint-rules/core-rules.cjs`)
- Project bootstrap → Harness evaluation: evaluate harness (evidence: `README.md`)
- Agent workflow → Tool guides: apply guidance (evidence: `README.md`)
- Agent workflow → Agent instructions: follow instructions (evidence: `README.md`)
- Agent workflow → Agent rules: apply agreements (evidence: `README.md`)
- Agent workflow → Task handoff: handoff work
