specagent-cc

Funkcionális specifikáció íróeszköz Claude Code-hoz.

BA + fejlesztői szemlélet, strukturált fázisok, branded DOCX export.

Mi ez?

A specagent egy slash command rendszer Claude Code-ban, ami végigvezet a funkcionális specifikáció írásának teljes folyamatán. Nem egyszerű szöveggenerálás — strukturált, iteratív workflow, ahol az AI egyszerre gondolkodik üzleti elemzőként és fejlesztőként.

Mit old meg:

• Az ügyfél skicc-szintű leírásából részletes, szerződésileg védhető specifikációt generál
• Minden modulnál feltárja az edge case-eket, jogosultságokat, scope határokat
• Explicit "nem tartozik bele" szekciókat generál scope creep ellen
• Kétszintű validáció: modul-szinten és globálisan is ellenőriz
• Branded DOCX exportot generál a cég sablonjaival

Telepítés

npm / npx (ha már fenn van npm-en)

# Globális telepítés (ajánlott — minden projektben elérhető)
npx specagent-cc

# Projekt-szintű telepítés
npx specagent-cc --local

# Branded DOCX template-tel (egyszeri beállítás)
npx specagent-cc --template=./ceg-sablon.docx

# Eltávolítás
npx specagent-cc --uninstall

Lokális telepítés (git clone / zip, npm nélkül)

Ha még nincs fenn npm-en, vagy helyi gépen teszteled:

# 1. Klónozd vagy csomagold ki a forrást
git clone <repo-url> specagent-cc
cd specagent-cc

# 2. Telepítsd a Node.js függőségeket
npm install

# 3. Futtasd a telepítőt közvetlenül
node bin/install.js

# Opcionálisan: branded template-tel
node bin/install.js --template=./ceg-sablon.docx

# Projekt-szintű telepítés (nem globális)
node bin/install.js --local

# Eltávolítás
node bin/install.js --uninstall

Megjegyzés: Ha a forrás egy .zip-ből jön (nem git), csomagold ki, lépj be a könyvtárba, majd futtasd npm install && node bin/install.js.

Rendszerkövetelmény: Node.js 18+, Claude Code 2.1.88+

Telepítési könyvtár (globális): ~/.claude/specagent/
Slash commandok: ~/.claude/skills/specagent-*/SKILL.md

Használat

Teljes flow — új projekt

/specagent-init          → Projekt metaadat + elvárási konfig
/specagent-input         → Input anyagok beadása, modulok azonosítása
/specagent-discuss 1     → 1. modul interaktív feltárása
/specagent-draft 1       → 1. modul spec szöveg + BA review
/specagent-image 1       → Mockup csatolás (ha kötelező)
/specagent-validate 1    → Modul validáció (javítási looppal)
                    ... (ismételd minden modulra)
/specagent-validate-all  → Globális cross-module validáció
/specagent-export        → DOCX + Markdown export

Meglévő spec átdolgozása

/specagent-rework        → Meglévő spec beadása, gap analysis, újraírás

Segédcommandok

/specagent-status        → Aktuális állapot áttekintése
/specagent-reopen 2      → Lezárt modul visszanyitása iterációra

Fázisok részletesen

/specagent-init

Bekéri a projekt metaadatait (projekt neve, ügyfél neve, projekt azonosító, rövid leírás, felelős BA) és az elvárási konfigurációt (mockup kötelező?, AC kötelező?, edge case mélység, API spec, részletesség szint). Létrehozza a spec-session.json fájlt.

/specagent-input

Fogadja az összes input anyagot (brief, workshop noték, emailek, bármilyen szöveg). Feldolgozza, azonosítja a modulokat és a felhasználói szerepköröket. A kezelő jóváhagyja vagy módosítja a modul listát.

/specagent-discuss [N]

Az N. modult tárja fel interaktívan. Kérdez mint egy tapasztalt BA (üzleti logika, felhasználói flow-k, jogosultságok) és mint fejlesztő (edge case-ek, konkurencia, limitek, integráció). Rögzíti a döntéseket. Minden modul explicit scope határral zárul.

/specagent-draft [N]

A discuss fázis döntései alapján megírja a modul spec szövegét. Tartalmazza: funkcionális leírás, jogosultsági tábla, állapotgép, acceptance criteria (ha kötelező), edge case tábla (ha kötelező), API endpointok (ha kötelező), scope kizárások. BA review loop — addig iterál amíg elfogadja.

/specagent-image [N]

Bekéri a modul mockupját. Elfogad: kép (feltöltés), Figma link, szöveges wireframe leírás, vagy dokumentált kihagyás. Ha képet kap, összeveti a spec szöveggel és jelzi az eltéréseket.

/specagent-validate [N]

Spec-linter futtatása a modulon. Ellenőrzi: forbidden phrases, kétértelműségek, hiányzó edge case-ek, AC meglét, scope creep kockázatok, konfig megfelelőség. Blokkoló / figyelmeztetés / megjegyzés szinteken jelöl. Javítási loop — addig iterál amíg zöld vagy manuális elfogadás.

/specagent-validate-all

Globális validáció. Ellenőrzi: input lefedettség (semmi sem veszett el az eredeti anyagokból), cross-module konzisztencia (role nevek, entitás nevek, integráció hivatkozások), konfig megfelelőség minden modulon, nyitott kérdések, dokumentum struktúra. Blokkoló problémáknál fix loop.

/specagent-export

Összeállítja a teljes dokumentumot (fedőlap, TOC, modulok, globális kizárások, nyitott kérdések, glosszárium, verziónapló). Generál: Markdown fájl és branded DOCX (ha template telepítve van).

/specagent-rework

Meglévő specifikáció átvételére. Gap analysis futtatása, majd célzott discuss → draft → validate cycle a problémás modulokon. Automatikus verziónapló diff generálás.

Branded DOCX template

Az export a ~/.claude/specagent/template/spec-template.docx fájlt használja alapként. Ez egy valódi Word fájl, amibe a cég brandingjét (logó, élőfej, élőláb, betűtípusok, színek) kell beállítani, de a tartalmat üresen kell hagyni.

Template beállítása:

# Első telepítéskor (npx)
npx specagent-cc --template=./ceg-sablon.docx

# Lokális forrásból
node bin/install.js --template=./ceg-sablon.docx

# Meglévő telepítéshez hozzáadva (template csere)
npx specagent-cc --template=./uj-sablon.docx

Ha nincs template telepítve, az export alap Word formátumban készül.

Session fájl

Minden projekt egy spec-session.json fájlban tárolja az állapotát a projekt könyvtárában. Ez tartalmazza az összes döntést, a modul állapotokat, a draft szövegeket és a validáció eredményeit.

Félbeszakított session folytatása:

/specagent-status        → megmutatja hol tartasz
/specagent-discuss 3     → folytatod ahol abbahagytad

Új verzió indítása (v2.0):

/specagent-init          → spec_version = v2.0 beállítása

A session.json mentve marad — a v2.0 mellé kerül.

Fájlstruktúra (npm csomagon belül)

specagent-cc/
  bin/
    install.js            ← telepítő script (node bin/install.js)
  specagent/
    workflows/            ← slash command definíciók
      spec-init.md
      spec-input.md
      spec-discuss.md
      spec-draft.md
      spec-image.md
      spec-validate.md
      spec-validate-all.md
      spec-export.md
      spec-rework.md
      spec-status.md
      spec-reopen.md
    references/           ← AI által olvasott szabványok
      spec-standards.md
      ba-probes.md
      validation-checklists.md
    session-format.md     ← session schema dokumentáció
    template/             ← branded sablon helye (opcionális)
  package.json
  README.md

Telepítés utáni könyvtárstruktúra (~/.claude/):

~/.claude/
  specagent/
    workflows/
    references/
    template/
      spec-template.docx  ← branded sablon (ha telepítve)
  skills/
    specagent-init/SKILL.md
    specagent-input/SKILL.md
    specagent-discuss/SKILL.md
    ... (minden commandhoz)

Kimenet

Minden export a projekt könyvtárába kerül:

./PROJ-2026-001_spec_v1.0.md      ← fejlesztőknek, repo-ba tölthető
./PROJ-2026-001_spec_v1.0.docx    ← ügyfélnek, branded formátumban
./spec-session.json               ← session state, v2.0-hoz visszatölthető