Claude Code Thực Chiến: Hướng Dẫn Vibe Coding Từ A-Z Cho Người Không Biết Lập Trình

C:\Users\[you]\Desktop\SoloOS\
├── 00-active\          ← Project đang build (≤ 3 cái)
│   ├── aivid\
│   ├── funnel-v2\
│   └── content-engine\
├── 01-experiments\     ← Prototype 1-2 tuần
├── 02-tools\           ← Tool nội bộ (script, automation)
├── 03-archive\         ← Đã ship hoặc đã bỏ
├── 04-skills\          ← Skill files dùng chung
├── 05-templates\       ← Boilerplate (landing, email, etc.)
└── 99-backup\          ← Snapshot trước milestone lớn

# CLAUDE.md — [Tên project]

## CONTEXT
- **Owner:** [Tên bạn, solo]
- **Mục tiêu sản phẩm:** [1 câu — outcome cho người dùng]
- **Audience:** [persona ngắn]
- **Giai đoạn:** [prototype / MVP / live]
- **Stack:** [VD: HTML + Tailwind + Alpine.js / Node + Express / Python + FastAPI]
- **Deployment:** [Vercel / VPS / local-only]

## QUY TẮC CỨNG
1. **Không tạo file mới** ngoài structure đã định, trừ khi tao confirm.
2. **Plan trước, code sau.** Với task > 30 phút, viết plan ra `.plan.md` trước, đợi tao OK.
3. **Commit nhỏ, message rõ.** Mỗi feature 1 commit. Format: `feat:` / `fix:` / `chore:` / `docs:`.
4. **Test thủ công** mỗi feature trước khi báo "xong".
5. **Không refactor** trừ khi tao yêu cầu.
6. **Không add dependency** mới mà không hỏi.
7. **Không xoá file** mà không xác nhận.

## FILE STRUCTURE (đừng phá)
[Cây thư mục hiện tại]

## DECISION LOG
- [Ngày] Quyết định X vì Y
- [Ngày] Bỏ Z vì W

## WIP / BACKLOG
- [ ] Task đang làm
- [ ] Task tiếp theo

Bước 1: PRD ngắn (1 trang) — Problem, User, Outcome, Scope
Bước 2: Architecture pass — Stack, file structure, data model
Bước 3: Vertical slice #1 — Chạy được end-to-end với 1 feature duy nhất
Bước 4: Iterate slice 2, 3, 4 — thêm từng feature
Bước 5: Polish + deploy

# VAI TRÒ
Mày là product manager đã ship 50 micro-SaaS. Mày brutal về scope.

# TASK
Viết PRD 1 trang cho ý tưởng của tao dưới đây.
Mục tiêu: validate idea trước khi tao tốn 1 giờ code.

# Ý TƯỞNG
[Mô tả 3-5 câu]

# PRD FORMAT (đúng các mục, không thêm)

## 1. Problem (1 câu)
## 2. Target user (1 persona — ai, đau gì, đã thử gì)
## 3. Outcome metric (1 metric đo thành công — KHÔNG vanity)
## 4. Core user story (3-5 stories, format "As X, I want Y so Z")
## 5. Out of scope (5 thứ KHÔNG làm trong v1)
## 6. Build complexity (đoán: trivial / 1-day / 1-week / 1-month)
## 7. Top 3 risks (technical + product + business)
## 8. Cheaper alternatives (3 cách validate không cần build)

# SAU KHI XONG
Chấm idea này theo 4 tiêu chí 1-10:
- Problem severity
- Solution fit
- Build feasibility cho solo
- Time-to-validate < 7 ngày?

Nếu tổng < 24/40 → khuyên tao DỪNG. Giải thích vì sao.

# VAI TRÒ
Mày là senior engineer brutal về over-engineering.
Mày yêu "boring tech" và ghét premature abstraction.

# CONTEXT
[Paste PRD đã chốt ở bước 1]

# CONSTRAINT — RẤT QUAN TRỌNG
- Tao là solo, không phải team. Tao maintain 1 mình.
- Tao biết HTML/CSS cơ bản, JavaScript thường thường. KHÔNG biết TypeScript advanced, không biết Docker.
- Tao deploy được Vercel + Netlify. Không có DevOps skill.
- Budget: $0-50/tháng infra.
- Timeline ship v1: [ngày]

# TASK — KHÔNG VIẾT CODE
Đề xuất:

## 1. Stack tối thiểu khả thi
Chọn stack ĐƠN GIẢN NHẤT vẫn ship được. Boring tech ưu tiên.
Mỗi lựa chọn: lý do + 1 alternative bị reject + vì sao reject.

## 2. File structure (cây thư mục)
## 3. Data model (entity + relation, dạng table)
## 4. Core flows (3-5 flow chính, mô tả từng bước)
## 5. Build order (vertical slice — slice nào trước, vì sao)
## 6. Anti-overengineering check
- Có thứ gì tao thêm vào mà v1 KHÔNG cần?
- Có pattern (Redux/microservices/CQRS) nào tao đang nghĩ tới mà không cần?

# CẤM
- Không đề xuất TypeScript nếu vanilla JS đủ.
- Không đề xuất framework mới nếu HTML+Alpine đủ.
- Không đề xuất database nếu localStorage/JSON file đủ cho v1.
- Không tạo bất kỳ file nào trong session này.

# CONTEXT
[Paste PRD + Architecture đã chốt]

# TASK
Build **vertical slice #1**: [feature đơn giản nhất nhưng chạy end-to-end]

Mục tiêu: sau slice này, tao có thể demo cho 1 người dùng thật.

# WORKFLOW BẮT BUỘC
1. **READ** file structure hiện tại (`ls -la`)
2. **WRITE** kế hoạch ra `.plan-slice-1.md`:
   - Files sẽ tạo/sửa
   - Mỗi file: mô đích + outline pseudo-code
   - Order build
   - Test plan (manual, 3-5 case)
3. **STOP** — đợi tao confirm plan
4. Sau confirm: code theo plan, mỗi file xong commit ngay
5. **TEST** thủ công 3 case tao đưa
6. **REPORT** — tóm tắt diff, file tạo, cách chạy local

# CẤM
- Không tạo file ngoài plan đã duyệt
- Không add npm package nào không có trong plan
- Không refactor code có sẵn

/offer-audit       — Audit offer theo framework 6 góc
/launch-postmortem — Postmortem sau mỗi launch, gen lesson learned
/competitor-teardown — Pull website + analyze positioning
/weekly-review     — Tổng hợp tuần: doanh thu + KPI + lesson

/content-calendar  — Sinh content calendar 30 ngày từ pillar topics
/hook-batch        — Sinh 20 hook theo Brand Voice Card
/ad-creative-brief — Sinh brief cho thiết kế creative
/email-sequence    — Sinh 5-email sequence cho funnel
/landing-skeleton  — Sinh HTML landing page boilerplate
/repurpose-8       — Repurpose 1 content thành 8 format

/course-outline    — Sinh outline khoá theo backward design
/lesson-plan-4p    — Sinh lesson plan theo Prime/Present/Practice/Perform
/rubric-gen        — Sinh rubric 4 tiêu chí × 3 mức
/slide-deck        — Sinh PPTX outline từ lesson plan
/quiz-batch        — Sinh quiz đa dạng tầng nhận thức (Bloom)
/cohort-update     — Sinh email cập nhật weekly cho cohort

# Yêu cầu cho /skill-creator

Tạo skill `/landing-skeleton` với mô tả:

**Input:**
- Offer name
- Target persona (1-2 dòng)
- Big promise (1 câu)
- Price
- 3 testimonials (có thể empty)

**Output:**
- File `index.html` với Tailwind CDN, mobile-first
- Sections: Hero, Problem, Solution, Stack, Testimonials, FAQ, CTA, Footer
- Form CTA submit về Formspree (đặt placeholder action)
- Sticky CTA bar mobile
- Comment block đầu file: hướng dẫn customize 5 phần dễ nhất

**Constraint:**
- Không dùng JS framework
- Inline Tailwind, không build step
- File < 500 dòng
- Tone copy match Brand Voice Card (đọc từ ~/05-templates/BRAND_VOICE.md nếu có)

**Workflow:**
1. Đọc BRAND_VOICE.md
2. Confirm input đủ
3. Generate file
4. Đề xuất 3 A/B test variants cho headline

┌──────────────────────────────────────────────┐
│ TẦNG 1 — Profile Memory (claude.ai Settings) │
│ Toàn cục — "tao là ai" 200-300 từ            │
├──────────────────────────────────────────────┤
│ TẦNG 2 — CLAUDE.md (per project, gốc repo)   │
│ Vai trò Claude trong project + rule cứng     │
├──────────────────────────────────────────────┤
│ TẦNG 3 — Knowledge files (.md riêng)         │
│ BRAND_VOICE.md, PRD.md, DECISIONS.md, ADRs   │
├──────────────────────────────────────────────┤
│ TẦNG 4 — Session Memory (~/.claude/memory)   │
│ Bài học từ thực chiến, feedback, preference  │
└──────────────────────────────────────────────┘

# TAO LÀ AI
[Tên], solopreneur làm về [niche]. Brand: [tên brand].

# CÁCH TAO LÀM VIỆC
- Thẳng. Tao thích bị thách thức, không thích bị khen.
- Output đầu = bản nháp. Luôn challenge tao quay lại sửa.
- Mặc định plan trước, code sau với task >30 phút.
- Boring tech > shiny tech.

# CONTEXT NGHỀ
- Sản phẩm chính: [tên + 1 câu]
- Audience: [1 câu persona]
- Channel chính: [TikTok / YouTube / email...]

# RULE CỨNG TOÀN CỤC
1. Không bao giờ ship code chưa test thủ công.
2. Không bao giờ rm -rf, drop table, force push mà không hỏi.
3. Không thêm dependency mới mà không nêu trade-off.
4. Mọi đề xuất phải có "cheaper alternative".
5. Khi tao mơ hồ, hỏi lại — đừng đoán.

Stack: HTML + Tailwind CDN + Alpine.js + Formspree
File: index.html + thank-you.html
Deploy: Vercel (drag & drop)
Claude prompt: /landing-skeleton + custom input
Guardrail: < 500 dòng HTML, không build step

Stack: Node.js + Puppeteer + Claude API
Flow: URL input → scrape main content → call Claude API
      → output 8 format theo /repurpose-8 logic
Deploy: chạy local hoặc Railway
Guardrail: respect robots.txt, rate-limit

Stack: Next.js + Supabase + Vercel
Features v1: Student login, progress, submit assignment, feedback
Kill features v1: AI grading, gamification, certificate
Guardrail: < 10 page, 1 user role, no payment yet

Stack: Python + cron + Telegram Bot API
Flow: Pull data từ Stripe/Shopee API → format → push Telegram
Deploy: VPS hoặc GitHub Actions cron
Guardrail: secrets trong .env, không commit

Stack: HTML + LocalStorage + Claude API
Flow: Trainer paste lesson content → API gen quiz đa dạng tầng Bloom
      → student tự làm → auto-score → export PDF certificate
Guardrail: không lưu PII, không cần backend

╔════════════════════════════════════════════════════════╗
║ B1 — PRD MICRO (5 phút)                               ║
║   Problem · User · Outcome · Out-of-scope             ║
╠════════════════════════════════════════════════════════╣
║ B2 — CHEAPER ALTERNATIVE CHECK                        ║
║   3 cách validate KHÔNG cần build. Vẫn quyết build?   ║
╠════════════════════════════════════════════════════════╣
║ B3 — ARCHITECTURE PASS (KHÔNG CODE)                   ║
║   Stack tối thiểu · File structure · Build order      ║
╠════════════════════════════════════════════════════════╣
║ B4 — PLAN PER SLICE                                   ║
║   .plan-*.md cho mỗi vertical slice                   ║
║   Đợi confirm trước khi code                          ║
╠════════════════════════════════════════════════════════╣
║ B5 — CODE + COMMIT NHỎ + TEST THỦ CÔNG                ║
║   Mỗi feature 1 commit · Manual test trước khi báo xong║
╠════════════════════════════════════════════════════════╣
║ B6 — POST-SLICE REVIEW                                ║
║   /code-review · Update CLAUDE.md DECISION LOG        ║
║   Capture bài học vào memory                          ║
╚════════════════════════════════════════════════════════╝

╔══════════════════════════════════════════════════════╗
║      TRƯỚC KHI MỞ CLAUDE CODE HÔM NAY                ║
╠══════════════════════════════════════════════════════╣
║  □ Tao biết outcome cụ thể của session này?          ║
║  □ Task này thuộc project trong 00-active?           ║
║  □ CLAUDE.md của project này còn fresh?              ║
║  □ Có .plan-*.md cho task hôm nay chưa?              ║
║  □ Permission mode: Default? (mặc định nên là Default)║
║  □ Đã git status — không có uncommitted lạ?          ║
╠══════════════════════════════════════════════════════╣
║      TRONG KHI CLAUDE ĐANG LÀM                       ║
╠══════════════════════════════════════════════════════╣
║  □ Đọc mỗi tool call trước Approve?                  ║
║  □ Không đang multi-task — chỉ 1 project lúc này?    ║
║  □ Idea mới nảy ra → ghi BACKLOG.md, KHÔNG giao ngay║
║  □ Mỗi 30 phút commit 1 lần?                         ║
╠══════════════════════════════════════════════════════╣
║      SAU MỖI SLICE                                   ║
╠══════════════════════════════════════════════════════╣
║  □ Mở app/file, test thủ công 3 case?                ║
║  □ /code-review chạy chưa?                           ║
║  □ Update DECISION LOG trong CLAUDE.md?              ║
║  □ Push branch, deploy preview chạy chưa?            ║
╠══════════════════════════════════════════════════════╣
║      DẤU HIỆU ĐANG ĐI SAI                            ║
╠══════════════════════════════════════════════════════╣
║  □ Đang có >2 project chạy song song hôm nay         ║
║  □ Đã 2 giờ chưa commit                              ║
║  □ Claude vừa add 3 dependency mới — bạn không nhớ vì sao║
║  □ Folder có >5 file mới chưa được dùng              ║
║  □ Bạn không nhớ outcome ban đầu                     ║
║  → DỪNG. /code-review. Update CLAUDE.md. Đi bộ 10 phút.║
╚══════════════════════════════════════════════════════╝