# cpjet64/vibecoding architecture

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

- Interactive diagram: https://gitdiagram.com/cpjet64/vibecoding
- Repository: https://github.com/cpjet64/vibecoding

## Overview

VibeCoding is a curated collection of practical guides about human-centered and AI-assisted software development, not a software runtime. Its principal user journey is a recommended reading path: learn AI collaboration, prompting, and review; move into translating ideas and planning systems; apply the guidance during implementation; then prepare to operate and recover production systems. README.md also presents the guides as an index and provides copy-paste prompts. Relationships shown are documented links and reading recommendations; no source excerpts were available to establish runtime behavior.

Main entry points: [`README.md`](https://github.com/cpjet64/vibecoding/blob/main/README.md) (Guide index), [`vibe-translation-guide.md`](https://github.com/cpjet64/vibecoding/blob/main/vibe-translation-guide.md) (Vibe translation), [`ai-orchestration-patterns.md`](https://github.com/cpjet64/vibecoding/blob/main/ai-orchestration-patterns.md) (AI orchestration), [`prd-guide.md`](https://github.com/cpjet64/vibecoding/blob/main/prd-guide.md) (PRD guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ai["AI-assisted coding"]
  node_collaboration["AI collaboration"]
  node_prompting["Prompt engineering"]
  node_qa["AI code QA"]
end

subgraph group_planning["Design and planning"]
  node_translation["Vibe translation"]
  node_orchestration["AI orchestration"]
  node_prd["PRD guidance<br/>[prd-guide.md]"]
end

subgraph group_implementation["Project implementation"]
  node_environments["Development environments"]
  node_security["Full-stack security"]
  node_architecture["System architecture"]
end

subgraph group_operations["Production operations"]
  node_infrastructure["Infrastructure maintenance"]
  node_runbooks["Runbooks<br/>[runbooks-guide.md]"]
  node_incidents["Incident response"]
  node_changelogs["Change logs"]
  node_recovery["Recovery procedures"]
  node_vendors["Vendor contacts"]
end

node_reader(("Reader"))
node_index["Guide index<br/>[README.md]"]

node_reader -->|"opens"| node_index
node_index -->|"recommends first"| node_collaboration
node_collaboration -->|"next recommends"| node_prompting
node_prompting -->|"next recommends"| node_qa
node_qa -->|"next recommends"| node_translation
node_translation -->|"next recommends"| node_orchestration
node_orchestration -->|"next recommends"| node_prd
node_prd -->|"next recommends"| node_environments
node_environments -->|"next recommends"| node_security
node_security -->|"next recommends"| node_architecture
node_architecture -->|"next recommends"| node_infrastructure
node_infrastructure -->|"next recommends"| node_runbooks
node_runbooks -->|"next recommends"| node_incidents
node_incidents -->|"next recommends"| node_changelogs
node_changelogs -->|"next recommends"| node_recovery
node_recovery -->|"next recommends"| node_vendors
node_index -->|"links guide"| node_translation
node_index -->|"links guide"| node_orchestration
node_index -->|"links guide"| node_prd
node_index -->|"links guide"| node_environments
node_index -->|"links guide"| node_security
node_index -->|"links guide"| node_architecture
node_index -->|"links guide"| node_infrastructure
node_index -->|"links guide"| node_runbooks
node_index -->|"links guide"| node_incidents
node_index -->|"links guide"| node_changelogs
node_index -->|"links guide"| node_recovery
node_index -->|"links guide"| node_vendors

click node_index "https://github.com/cpjet64/vibecoding/blob/main/README.md"
click node_collaboration "https://github.com/cpjet64/vibecoding/blob/main/ai-collaboration-workflow.md"
click node_prompting "https://github.com/cpjet64/vibecoding/blob/main/prompt-engineering-guide.md"
click node_qa "https://github.com/cpjet64/vibecoding/blob/main/quality-assurance-guide.md"
click node_translation "https://github.com/cpjet64/vibecoding/blob/main/vibe-translation-guide.md"
click node_orchestration "https://github.com/cpjet64/vibecoding/blob/main/ai-orchestration-patterns.md"
click node_prd "https://github.com/cpjet64/vibecoding/blob/main/prd-guide.md"
click node_environments "https://github.com/cpjet64/vibecoding/blob/main/development-environments.md"
click node_security "https://github.com/cpjet64/vibecoding/blob/main/full-stack-security-guide.md"
click node_architecture "https://github.com/cpjet64/vibecoding/blob/main/system-architecture-guide.md"
click node_infrastructure "https://github.com/cpjet64/vibecoding/blob/main/infrastructure-maintenance.md"
click node_runbooks "https://github.com/cpjet64/vibecoding/blob/main/runbooks-guide.md"
click node_incidents "https://github.com/cpjet64/vibecoding/blob/main/incident-response-guide.md"
click node_changelogs "https://github.com/cpjet64/vibecoding/blob/main/change-logs-guide.md"
click node_recovery "https://github.com/cpjet64/vibecoding/blob/main/recovery-procedures-guide.md"
click node_vendors "https://github.com/cpjet64/vibecoding/blob/main/vendor-contacts-guide.md"

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_collaboration,node_prompting,node_qa toneBlue
class node_translation,node_orchestration,node_prd toneAmber
class node_environments,node_security,node_architecture toneMint
class node_infrastructure,node_runbooks,node_incidents,node_changelogs,node_recovery,node_vendors toneRose
class node_reader toneIndigo
class node_index toneTeal
```

## Components

### AI-assisted coding

- [AI collaboration](https://github.com/cpjet64/vibecoding/blob/main/ai-collaboration-workflow.md): `ai-collaboration-workflow.md`
- [Prompt engineering](https://github.com/cpjet64/vibecoding/blob/main/prompt-engineering-guide.md): `prompt-engineering-guide.md`
- [AI code QA](https://github.com/cpjet64/vibecoding/blob/main/quality-assurance-guide.md): `quality-assurance-guide.md`

### Design and planning

- [Vibe translation](https://github.com/cpjet64/vibecoding/blob/main/vibe-translation-guide.md): `vibe-translation-guide.md`
- [AI orchestration](https://github.com/cpjet64/vibecoding/blob/main/ai-orchestration-patterns.md): `ai-orchestration-patterns.md`
- [PRD guidance](https://github.com/cpjet64/vibecoding/blob/main/prd-guide.md): `prd-guide.md`

### Project implementation

- [Development environments](https://github.com/cpjet64/vibecoding/blob/main/development-environments.md): `development-environments.md`
- [Full-stack security](https://github.com/cpjet64/vibecoding/blob/main/full-stack-security-guide.md): `full-stack-security-guide.md`
- [System architecture](https://github.com/cpjet64/vibecoding/blob/main/system-architecture-guide.md): `system-architecture-guide.md`

### Production operations

- [Infrastructure maintenance](https://github.com/cpjet64/vibecoding/blob/main/infrastructure-maintenance.md): `infrastructure-maintenance.md`
- [Runbooks](https://github.com/cpjet64/vibecoding/blob/main/runbooks-guide.md): `runbooks-guide.md`
- [Incident response](https://github.com/cpjet64/vibecoding/blob/main/incident-response-guide.md): `incident-response-guide.md`
- [Change logs](https://github.com/cpjet64/vibecoding/blob/main/change-logs-guide.md): `change-logs-guide.md`
- [Recovery procedures](https://github.com/cpjet64/vibecoding/blob/main/recovery-procedures-guide.md): `recovery-procedures-guide.md`
- [Vendor contacts](https://github.com/cpjet64/vibecoding/blob/main/vendor-contacts-guide.md): `vendor-contacts-guide.md`

### Other components

- **Reader**
- [Guide index](https://github.com/cpjet64/vibecoding/blob/main/README.md): `README.md`

## Connections

- Reader → Guide index: opens
- Guide index → AI collaboration: recommends first
- AI collaboration → Prompt engineering: next recommends
- Prompt engineering → AI code QA: next recommends
- AI code QA → Vibe translation: next recommends
- Vibe translation → AI orchestration: next recommends
- AI orchestration → PRD guidance: next recommends
- PRD guidance → Development environments: next recommends
- Development environments → Full-stack security: next recommends
- Full-stack security → System architecture: next recommends
- System architecture → Infrastructure maintenance: next recommends
- Infrastructure maintenance → Runbooks: next recommends
- Runbooks → Incident response: next recommends
- Incident response → Change logs: next recommends
- Change logs → Recovery procedures: next recommends
- Recovery procedures → Vendor contacts: next recommends
- Guide index → Vibe translation: links guide
- Guide index → AI orchestration: links guide
- Guide index → PRD guidance: links guide
- Guide index → Development environments: links guide
- Guide index → Full-stack security: links guide
- Guide index → System architecture: links guide
- Guide index → Infrastructure maintenance: links guide
- Guide index → Runbooks: links guide
- Guide index → Incident response: links guide
- Guide index → Change logs: links guide
- Guide index → Recovery procedures: links guide
- Guide index → Vendor contacts: links guide
