agentic dev config - nuxtjs

backlog.md

Product Backlog

⚠️ Fontos: egy iterációban PONTOSAN 1 backlog item dolgozható fel.

---

Auth – alapok

• AUTH-01: Supabase kliens inicializálása Nuxt pluginben
• AUTH-02: Pinia auth store létrehozása
• AUTH-03: Login oldal UI
• AUTH-04: Register oldal UI
• AUTH-05: Route guard vendég / belépett állapotra

Layout

• LAYOUT-01: Alap layout (header + nav)
• LAYOUT-02: Navigáció auth állapot alapján

Recipe CRUD

• RECIPE-01: DB schema dokumentálása (README vagy comment)
• RECIPE-02: Recipe lista oldal
• RECIPE-03: Recipe detail oldal
• RECIPE-04: Recipe create form
• RECIPE-05: Recipe edit form
• RECIPE-06: Recipe delete

Storage

• STORAGE-01: Supabase Storage bucket létrehozás (dokumentálva)
• STORAGE-02: Kép feltöltés komponens
• STORAGE-03: Kép megjelenítés recept oldalon

constraints.md

Technikai és működési korlátok (CONSTRAINTS)

Kötelező szabályok

• Nuxt 3 Composition API
• <script setup> használata
• Pinia store-ok külön fájlban
• Server routes csak indokolt esetben
• Supabase JS SDK használata

Tiltások

• NEM használunk:
  • Vuex
  • REST wrapper könyvtárakat Supabase fölé
  • Saját auth rendszert
• NEM vezetünk be új technológiát backlog nélkül

Kódminőség

• Olvasható, egyszerű megoldások
• Kicsi komponensek
• Egy iteráció = kis változás

Agent korlátok

• Az agent NEM találhat ki új feature-t
• Az agent NEM bővítheti a scope-ot
• Az agent csak BACKLOG itemen dolgozhat

definition_of_done.md

Definition of Done (DoD)

Egy backlog item akkor tekinthető késznek, ha:

Kötelező

• A funkció működik
• A kód buildelhető
• Nincs lint vagy type hiba
• Az érintett UI kézzel tesztelhető

Dokumentáció

• STATE.md frissítve:
  • mi készült el
  • milyen döntések születtek
  • mi a következő lépés

Git

• Készült legalább 1 commit
• A commit:
  • kis méretű
  • egy backlog itemhez kapcsolódik
  • értelmes commit message-et tartalmaz

Iteráció vége

• Az agent MEGÁLL
• Nem kezd új backlog itembe

goal.md

Projekt cél (GOAL)

Kontextus

Ez egy Nuxt 3 alapú webalkalmazás. A fejlesztést Claude Code végzi iteratív módon, long-running agent jelleggel. Az agent NEM egyetlen sessionben dolgozik, hanem több, egymást követő iterációban.

Az állapot NEM a beszélgetésben, hanem a repository-ban van eltárolva.

Technikai stack

• Nuxt 3
• Supabase
  • Auth (email + password)
  • Database (Postgres)
  • Storage (képfeltöltés)
• Pinia
• LocalStorage (kliens oldali cache / preferenciák)

Fő cél

Egy működő MVP elkészítése 3 fő feature-rel, stabil architektúrával.

Scope – Feature-ök

1. Auth + App Shell

• Supabase Auth integráció
• Bejelentkezés / regisztráció
• Route guard (vendég vs belépett)
• Alap layout + navigáció

2. Recipe CRUD (MVP)

• Recept lista
• Recept részletező
• Recept létrehozás / szerkesztés / törlés
• Recept adatmodell:
  • title (string, kötelező)
  • ingredients: [{ name, amount, unit }]
  • steps: [{ order, text }]

3. Kép feltöltés (Storage)

• Recepthez tartozó fő kép
• Supabase Storage használata

Out of scope

• Fizetés
• Jogosultsági szintek
• Admin felület
• Mobile app

how-to-use.md

0. hozz létre egy docs/agents mappát a projekt gyökerében és a fenti fájlokat tedd bele
1. create a new nuxtjs project (+ git init)
2. open claude
3. "Indítsd el az első iterációt a @docs/agent/prompt_master.md szerint"
4. amikor készen van, jöhet a következő iteráció
5. "Következő iteráció. Tartsd be a RUNBOOK-ot és a DoD-t. Válassz pontosan 1 backlog itemet a BACKLOG.md-ből, implementáld, frissítsd a │ │ STATE.md-t, commit, majd stop"
6. további iterációk hasonlóan...

prompt_master.md

Claude Code – Master Prompt (BOOT)

Te egy long-running fejlesztő agent vagy.

A memóriád NEM a beszélgetés, hanem a repository:

• docs/agent/GOAL.md
• docs/agent/CONSTRAINTS.md
• docs/agent/DEFINITION_OF_DONE.md
• docs/agent/BACKLOG.md
• docs/agent/STATE.md
• docs/agent/RUNBOOK.md

Feladatod

• Olvasd el a fenti fájlokat
• Tartsd be SZIGORÚAN a RUNBOOK-ot
• Egy iterációban PONTOSAN 1 backlog itemen dolgozz
• A Definition of Done kötelező

Iteráció vége

• Frissítsd a STATE.md-t
• Készíts commitot
• ÁLLJ MEG és várj

Tiltások

• Nem beszélgetsz
• Nem magyarázkodsz
• Nem kérdezel vissza
• Nem kezdesz új backlog itembe

Indítsd el az első iterációt.

runbook.md

Agent RUNBOOK

Ez a fájl írja le, hogyan KELL az agentnek dolgoznia.

Iteráció menete

1. Olvasd el:

   • GOAL.md
   • CONSTRAINTS.md
   • DEFINITION_OF_DONE.md
   • BACKLOG.md
   • STATE.md

2. Válassz KI PONTOSAN 1 backlog itemet

3. Írd le röviden, mit fogsz csinálni

4. Implementálj

5. Futtasd:

   • lint
   • typecheck

6. Javíts, ha kell

7. Frissítsd a STATE.md-t

8. Commitolj

9. ÁLLJ MEG

Tiltott viselkedés

• Új feature kitalálása
• Több backlog item kezelése egyszerre
• STATE.md frissítés kihagyása

state.md

.