# dzungtri/vibe2specdriven architecture

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

- Interactive diagram: https://gitdiagram.com/dzungtri/vibe2specdriven
- Repository: https://github.com/dzungtri/vibe2specdriven

## Overview

This repository is a Vietnamese workshop resource about moving from vibe coding to Spec-Driven Development. Its central learner workflow is to study the slides, then use the starter with a coding agent to take a feature through the documented Spec Kit stages and implementation. Separate booking and stock-pledge examples illustrate rapid AI-generated applications. The booking spike’s sampled server shows HTTP API handling and static-file serving; other demo internals were not sampled, so their runtime links are not inferred.

Main entry points: [`spec-driven-starter/README.md`](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/README.md) (Starter guide), [`spec-driven-starter/.claude/skills/speckit-constitution/SKILL.md`](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-constitution/SKILL.md) (Constitution), [`spec-driven-starter/.claude/skills/speckit-specify/SKILL.md`](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-specify/SKILL.md) (Specify), [`spec-driven-starter/.claude/skills/speckit-clarify/SKILL.md`](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-clarify/SKILL.md) (Clarify)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Workshop materials"]
  node_slides["Workshop slides<br/>[index.html]"]
end

subgraph group_starter["Spec-driven starter"]
  node_starter_readme["Starter guide<br/>[README.md]"]
  node_agent_guide["Agent guidance<br/>[AGENTS.md]"]
  node_constitution["Constitution<br/>[SKILL.md]"]
  node_specify["Specify<br/>[SKILL.md]"]
  node_clarify["Clarify<br/>[SKILL.md]"]
  node_plan["Plan<br/>[SKILL.md]"]
  node_checklist["Checklist<br/>[SKILL.md]"]
  node_tasks["Tasks<br/>[SKILL.md]"]
  node_analyze["Analyze<br/>[SKILL.md]"]
  node_implement["Implement<br/>[SKILL.md]"]
  node_converge["Converge<br/>[SKILL.md]"]
  node_workflow_assets["Workflow assets<br/>[.specify]"]
end

subgraph group_booking["Booking example"]
  node_booking_app["Booking demo<br/>[server.js]"]
  node_booking_spike["Booking spike server<br/>[server.js]"]
  node_booking_page["Booking page<br/>[index.html]"]
  node_spike_page["Spike booking page<br/>[index.html]"]
end

subgraph group_pledge["Stock-pledge example"]
  node_camco["Stock-pledge demo<br/>[app.js]"]
end

node_learner(("Learner"))
node_agent(("Coding agent"))
node_user_browser(("Browser user"))

node_learner -->|"studies"| node_slides
node_learner -->|"copies starter"| node_starter_readme
node_agent -->|"starts with"| node_constitution
node_constitution -->|"then specify"| node_specify
node_specify -->|"then clarify"| node_clarify
node_clarify -->|"then plan"| node_plan
node_plan -->|"then checklist"| node_checklist
node_checklist -->|"then tasks"| node_tasks
node_tasks -->|"then analyze"| node_analyze
node_analyze -->|"then implement"| node_implement
node_implement -->|"then converge"| node_converge
node_agent_guide -->|"guides"| node_agent
node_starter_readme -.->|"uses Spec Kit"| node_workflow_assets
node_user_browser -->|"requests pages"| node_booking_spike
node_booking_spike -->|"serves static"| node_spike_page
node_user_browser -.->|"uses demo"| node_booking_app
node_booking_app -.->|"serves app"| node_booking_page
node_user_browser -.->|"opens demo"| node_camco

click node_slides "https://github.com/dzungtri/vibe2specdriven/blob/main/slides/index.html"
click node_starter_readme "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/README.md"
click node_agent_guide "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/AGENTS.md"
click node_constitution "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-constitution/SKILL.md"
click node_specify "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-specify/SKILL.md"
click node_clarify "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-clarify/SKILL.md"
click node_plan "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-plan/SKILL.md"
click node_checklist "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-checklist/SKILL.md"
click node_tasks "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-tasks/SKILL.md"
click node_analyze "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-analyze/SKILL.md"
click node_implement "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-implement/SKILL.md"
click node_converge "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-converge/SKILL.md"
click node_workflow_assets "https://github.com/dzungtri/vibe2specdriven/tree/main/spec-driven-starter/.specify"
click node_booking_app "https://github.com/dzungtri/vibe2specdriven/blob/main/demo/library-booking/server.js"
click node_booking_spike "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/spikes/library-booking/server.js"
click node_booking_page "https://github.com/dzungtri/vibe2specdriven/blob/main/demo/library-booking/public/index.html"
click node_spike_page "https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/spikes/library-booking/public/index.html"
click node_camco "https://github.com/dzungtri/vibe2specdriven/blob/main/demo/vibe-camco/app.js"

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_slides,node_user_browser toneBlue
class node_starter_readme,node_agent_guide,node_constitution,node_specify,node_clarify,node_plan,node_checklist,node_tasks,node_analyze,node_implement,node_converge,node_workflow_assets toneAmber
class node_booking_app,node_booking_spike,node_booking_page,node_spike_page toneMint
class node_camco toneRose
class node_learner,node_agent toneIndigo
```

## Components

### Workshop materials

- [Workshop slides](https://github.com/dzungtri/vibe2specdriven/blob/main/slides/index.html): `slides/index.html`

### Spec-driven starter

- [Starter guide](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/README.md): `spec-driven-starter/README.md`
- [Agent guidance](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/AGENTS.md): `spec-driven-starter/AGENTS.md`
- [Constitution](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-constitution/SKILL.md): `spec-driven-starter/.claude/skills/speckit-constitution/SKILL.md`
- [Specify](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-specify/SKILL.md): `spec-driven-starter/.claude/skills/speckit-specify/SKILL.md`
- [Clarify](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-clarify/SKILL.md): `spec-driven-starter/.claude/skills/speckit-clarify/SKILL.md`
- [Plan](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-plan/SKILL.md): `spec-driven-starter/.claude/skills/speckit-plan/SKILL.md`
- [Checklist](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-checklist/SKILL.md): `spec-driven-starter/.claude/skills/speckit-checklist/SKILL.md`
- [Tasks](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-tasks/SKILL.md): `spec-driven-starter/.claude/skills/speckit-tasks/SKILL.md`
- [Analyze](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-analyze/SKILL.md): `spec-driven-starter/.claude/skills/speckit-analyze/SKILL.md`
- [Implement](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-implement/SKILL.md): `spec-driven-starter/.claude/skills/speckit-implement/SKILL.md`
- [Converge](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/.claude/skills/speckit-converge/SKILL.md): `spec-driven-starter/.claude/skills/speckit-converge/SKILL.md`
- [Workflow assets](https://github.com/dzungtri/vibe2specdriven/tree/main/spec-driven-starter/.specify): `spec-driven-starter/.specify`

### Booking example

- [Booking demo](https://github.com/dzungtri/vibe2specdriven/blob/main/demo/library-booking/server.js): `demo/library-booking/server.js`
- [Booking spike server](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/spikes/library-booking/server.js): `spec-driven-starter/spikes/library-booking/server.js`
- [Booking page](https://github.com/dzungtri/vibe2specdriven/blob/main/demo/library-booking/public/index.html): `demo/library-booking/public/index.html`
- [Spike booking page](https://github.com/dzungtri/vibe2specdriven/blob/main/spec-driven-starter/spikes/library-booking/public/index.html): `spec-driven-starter/spikes/library-booking/public/index.html`

### Stock-pledge example

- [Stock-pledge demo](https://github.com/dzungtri/vibe2specdriven/blob/main/demo/vibe-camco/app.js): `demo/vibe-camco/app.js`

### Other components

- **Learner**
- **Coding agent**
- **Browser user**

## Connections

- Learner → Workshop slides: studies (evidence: `README.md`)
- Learner → Starter guide: copies starter (evidence: `README.md`)
- Coding agent → Constitution: starts with (evidence: `README.md`)
- Constitution → Specify: then specify (evidence: `README.md`)
- Specify → Clarify: then clarify (evidence: `README.md`)
- Clarify → Plan: then plan (evidence: `README.md`)
- Plan → Checklist: then checklist (evidence: `README.md`)
- Checklist → Tasks: then tasks (evidence: `README.md`)
- Tasks → Analyze: then analyze (evidence: `README.md`)
- Analyze → Implement: then implement (evidence: `README.md`)
- Implement → Converge: then converge (evidence: `README.md`)
- Agent guidance → Coding agent: guides (evidence: `README.md`)
- Starter guide → Workflow assets: uses Spec Kit
- Browser user → Booking spike server: requests pages (evidence: `spec-driven-starter/spikes/library-booking/server.js`)
- Booking spike server → Spike booking page: serves static (evidence: `spec-driven-starter/spikes/library-booking/server.js`)
- Browser user → Booking demo: uses demo (evidence: `README.md`)
- Booking demo → Booking page: serves app (evidence: `README.md`)
- Browser user → Stock-pledge demo: opens demo (evidence: `README.md`)
