Gyakori hibák

Gyakori hibák

Hiányos kontextus a promptban

Probléma: Az AI nem ismeri a projekt konvencióit, és nem a várt stílusban generál kódot.

Megoldás: Mindig legyen aktuális a tech.md és a structure.md. Ha valami nem stimmel a kimenetben, frissítsd a steering fájlt.

## Component Pattern Example

// Standard component structure:
import { type FC } from "react"
import { cn } from "@/lib/utils"

interface ButtonProps {
  variant?: "primary" | "secondary"
  className?: string
}

export const Button: FC<ButtonProps> = ({ variant = "primary", className }) => {
  return <button className={cn(baseStyles, variantStyles[variant], className)} />
}

Túl nagy, egyetlen lépéses promptok

Probléma: "Build me a complete e-commerce platform" – az eredmény generikus, nem illeszkedik a projekthez.

Megoldás: Bontsd fel kisebb, meghatározott részfeladatokra. Spec-driven módban ez automatikusan megtörténik.

Hook-ok gondatlan konfigurálása

Probléma: Egy hook minden fájlmentéskor lefut, és lassítja a munkát.

Megoldás:

{
  "when": {
    "type": "fileEdited",
    "patterns": ["src/components/features/**/*.tsx"]
  }
}

Spec fájlok nem kerülnek Gitbe

Probléma: A .kiro/ mappa a .gitignore-ban van, ezért a team többi tagja nem fér hozzá a specifikációkhoz.

Megoldás:

# .gitignore
.kiro/hooks/*.log      # logokat ignoráld
# NE add hozzá a .kiro mappát teljes egészében!

Steering fájlok elavulnak

Probléma: A projekt fejlődik, de a steering dokumentumok nem frissülnek. Az AI régi konvenciókat követ.

Megoldás: Vezess be egy hook-ot, amely figyelmeztet, ha a kulcsfájlok megváltoznak:

{
  "name": "Steering Review Reminder",
  "when": {
    "type": "fileEdited",
    "patterns": ["package.json", "tsconfig.json", "next.config.*"]
  },
  "instructions": "When core config files change, check if .kiro/steering/tech.md needs to be updated. If so, suggest specific updates in the chat."
}

Az AI által generált kód kritika nélküli elfogadása

Probléma: Az AI kimenet „jónak tűnik”, de tartalmazhat logikai hibákat, biztonsági problémákat, vagy teszteletlen edge case-eket.

Megoldás: Mindig futtasd a teszteket, végezz kód review-t, és kérdezd az AI-t a döntések indoklásáról:

Why did you choose this approach over using a database transaction?
What are the edge cases this implementation doesn't handle?

Rövid összefoglaló

• A legtöbb probléma hiányos kontextusból vagy elavult steering fájlokból ered.
• A hook-ok legyenek specifikus fájlmintákra célozva, ne generikusak.
• Az AI kimenetét mindig kritikusan ellenőrizd: tesztek, review, döntések megkérdőjelezése.