Kontextus kezelés és projekt szintű működés

Steering fájlok, globális vs workspace kontextus, és spec-ek mint tudásbázis.

Kontextus kezelés és projekt szintű működés

A Kiro legfontosabb előnye a többi AI-eszközzel szemben, hogy nem felejtkezik el a projekt kontextusáról. Ezt a steering fájlrendszer teszi lehetővé.

Steering fájlok típusai

A steering fájlok Markdown dokumentumok, amelyek a .kiro/steering/ mappában találhatók.

Alap steering fájlok (mindig aktívak):

<!-- .kiro/steering/tech.md -->
---
inclusion: always
---

# Tech Stack

## Frontend
- Next.js 15 (App Router)
- TypeScript 5.x strict mode
- Tailwind CSS v4
- shadcn/ui komponensek
- Zustand (state management)
- TanStack Query v5

## Backend
- Supabase (PostgreSQL + Auth + Storage)

## Konvenciók
- Minden komponens TypeScript-ben, `.tsx` kiterjesztéssel
- Server Components az alapértelmezett, `"use client"` csak szükség esetén
- Zod schema-validáció minden API endpoint-hoz

<!-- .kiro/steering/structure.md -->
---
inclusion: always
---

# Projekt struktúra

src/
  app/           – Next.js App Router oldalak
  components/    – Újrafelhasználható UI komponensek
    ui/          – shadcn/ui alap komponensek
    features/    – Funkció-specifikus komponensek
  hooks/         – Custom React hook-ok
  lib/           – Utility függvények, API kliensek
  store/         – Zustand store-ok
  types/         – Globális TypeScript típusok

## Elnevezési konvenciók
- Komponensek: PascalCase (ProductCard.tsx)
- Hook-ok: camelCase, use-prefix (useProductList.ts)
- Store-ok: camelCase, Store-suffix (cartStore.ts)

Speciális steering fájlok (igény szerint aktiválhatók):

<!-- .kiro/steering/api-standards.md -->
---
inclusion: auto
description: REST API tervezési minták. Aktiváld API végpontok létrehozásakor.
---

# API tervezési elvek

- RESTful resource naming: /api/v1/resources/:id
- HTTP státuszkódok konzisztens használata
- Egységes hibaválasz-formátum: { error: string, code: string, details?: object }
- Minden endpoint Zod-validációval

Manuális steering fájlok (explicit hívásra):

# Chat-ben így hívható meg:
#troubleshooting-guide

# Vagy:
/api-migration-guide

Globális vs. workspace steering

~/.kiro/steering/          ← globális (minden projektben aktív)
  personal-preferences.md
  coding-style.md

./kiro/steering/           ← workspace szintű (felülírja a globálist)
  tech.md
  structure.md
  api-standards.md

Specifikációk kezelése

A spec fájlok a .kiro/specs/ mappában találhatók, és a Git-be kerülnek a kóddal együtt:

.kiro/specs/
  user-auth/
    requirements.md    – EARS-notációjú felhasználói sztorik
    design.md          – adatfolyam, interfészek, API tervezet
    tasks.md           – implementációs lépések checklistje
  shopping-cart/
    requirements.md
    design.md
    tasks.md

Ezek a dokumentumok hosszú távon értékes tudásbázist alkotnak: egy új fejlesztő vagy az AI maga is visszatérhet hozzájuk, ha egy funkció viselkedését kell megérteni.

Rövid összefoglaló

A steering fájlok adják a Kiro hosszú távú projekt-memóriáját.
Az inclusion: always fájlok minden interakcióban aktívak; az auto és manuális fájlok igény szerint töltődnek be.
A specifikációk Git-be kerülnek, és a projekt tudásbázisaként funkcionálnak.

Kontextus kezelés és projekt szintű működés