🎯 Vibecoding Learnings

Komplexný sprievodca AI-asistovaným vývojom založený na reálnych skúsenostiach z projektu HomeGrif — 8 dní, 99 releases, od nuly k produkcii.

8
Dní vývoja
99
Releases
4:1
Claude:Human
5.5M
Tokenov

Obsah dokumentu

Executive Summary

Tento dokument zachytáva všetky poznatky z budovania HomeGrif platformy pomocou Claude Code. Jeden človek + AI dosiahol 4-násobnú produktivitu a vybudoval plnohodnotnú fintech platformu za 8 dní.

  • Human time: ~950 minutes (~16 man-days)
  • Claude time: ~4,000 minutes (~67 man-days)
  • Total tokens: ~5.5 million
  • Est. cost: ~7,600-8,000 EUR (including human opportunity cost)

T-Shirt Size Distribution

Každý release je kategorizovaný podľa náročnosti:

Size Count Human Claude Tokens Scope
XS 12 0-2m 3-5m 5-10k Typo, config
S 20 3-5m 8-20m 15-25k Bug fix, small feature
M 31 5-10m 25-45m 40-80k Feature, integration
L 23 15-20m 25-40m 50-100k Major feature
XL 13 30-40m 60-120m 100-200k Platform feature

10 Kľúčových Ponaučení

1. Start with DB-Driven Config

Neukladajte business nastavenia do env premenných. Databáza umožňuje zmeny cez admin UI bez redeployu.

2. Implement Task System Early

Automatizácia sa vypláca okamžite — smoke testy, bezpečnostné skeny, denné reporty.

3. Use PostgreSQL Sessions from Day One

MemoryStore nescaluje a spôsobuje memory leaky. PostgreSQL sessions od začiatku.

4. Add Audit Trails from Start

Každá dôležitá akcia musí byť sledovateľná — email_logs, activity_logs, created_at/updated_at.

5. Build Admin Dashboard Alongside Features

Každá nová feature potrebuje admin view na vizualizáciu dát a správu.

6. Rate Limit Before Going Public

Bezpečnosť je základ — rate limiting, input validácia, CAPTCHA, honeypot.

7. Two-Branch Deployment Strategy

main → TEST, production → PROD. Nikdy nenechajte TEST driftovať od PROD.

8. Track Effort on Every Commit

Dáta o nákladoch umožňujú presné oceňovanie projektov a justifikáciu AI nástrojov.

9. Customer Quotes = Requirements

Reálny hlas zákazníkov formuje lepšie produkty. Zbierajte a používajte citáty.

10. Transparency Builds Trust

"Publikujte čo najviac." Roadmap, backlog, architektúra — všetko verejne okrem bezpečnostných detailov.

Claude Code Setup

HomeGrif používa Claude Code s vlastnými slash príkazmi pre efektívny vývoj. Tu sú dostupné príkazy:

Príkaz Účel
/init Inicializácia session — zobrazí stav projektu, verziu, zdravie prostredí
/status Komplexný prehľad projektu bez inicializácie
/deploy Deployment workflow: main → TEST → verify → PROD
/bug [ID] Systematický workflow pre opravu bugov z backlogu
/feature [ID] Implementácia features z backlogu s plným trackingom
/db [cmd] Databázové operácie: stats, tables, queries
/backlog Správa backlogu: list, add, next task

6 Povinných Pravidiel

  1. Čítaj súbory pred editáciou — NIKDY neupravuj kód, ktorý si nevidel
  2. Odstraňuj obsolete kód — bez nepoužívaných funkcií a importov
  3. Aktualizuj tracking — backlog.md + changelog.json + verzia
  4. Verifikuj po zmenách — over že feature funguje
  5. Malé commity — jeden feature/fix per commit
  6. Dodržuj patterny — matchuj existujúci code style

Kompletná dokumentácia vrátane MCP serverov a databázových spojení je v specs/claude-code-guide.md

Vibecoding Filozofia

"The human provides direction and judgment; the AI provides execution and knowledge." — Základný princíp vibecoding

Zodpovednosť človeka:

  • Definovať požiadavky a akceptačné kritériá
  • Revízia a schválenie zmien
  • Architektonické rozhodnutia
  • Testovanie kritických ciest

Zodpovednosť AI:

  • Písať kód podľa požiadaviek
  • Dodržiavať zavedené patterny
  • Aktualizovať dokumentáciu
  • Sledovať effort a zmeny

Kompletný dokument (~1100 riadkov)

Plná verzia obsahuje code snippety, prompting patterny, security implementácie, databázové schémy a ďalšie.

Pozrieť na GitHub → Product Manifesto

Živý dokument • Posledná aktualizácia: December 2024 • v2.3.0