FullSpec framework pro AI-vývoj s Claude Code a specifikacemi

FullSpec: framework pro vývoj řízený AI s Claude Code

Vývoj s využitím AI asistentů často vede k chaosu kvůli absenci jednotné architektonické dokumentace. FullSpec řeší tento problém formalizací celého cyklu od nápadu po release prostřednictvím řetězce specifikací, které generují a udržují AI agenti.

Problém: AI bez architektonické paměti

Klíčová složitost při práci s LLM jako Claude Code je absence kontextu architektonických rozhodnutí. AI píše kód rychle, ale nepamatuje si, proč je systém uspořádán právě tak. V projektu s 25 mikroslužbami to vede ke kritickým konfliktům:

• Různé algoritmy šifrování v sousedních službách
• Nesjednocené API kontrakty
• Protichůdná řešení v paralelních sezeních

Tradiční přístupy k dokumentaci nefungují: buď zaostává za kódem, nebo vyžaduje nepřekonatelnou byrokracii. AI potřebuje aktuální, úplné a konzistentní specifikace – a FullSpec vytváří právě takové prostředí.

Architektura FullSpec: 23 agentů a 8 fází

Framework organizuje vývoj prostřednictvím formálních dokumentů, které generují a validují AI agenti. Uživatel zavolá /chain s popisem úkolu, například "udělat OAuth2 autorizaci", a systém spustí sekvenci 8 fází.

Úrovně specifikací

Řetězec vytváří čtyři úrovně dokumentů s povinným review na každém stupni:

• Discussion – požadavky, kritéria úspěchu, rozsah a rizika
• Design – změny systému: služby, API kontrakty, datové modely
• Plan Tests – scénáře testování, napsané před kódem
• Plan Dev – úkoly, závislosti a bloky provádění

Po schválení specifikací systém automaticky generuje dokumentaci, vytváří GitHub Issues, píše kód a testy, provádí code review a formuje PR.

Klíčové mechanismy frameworku

Paralelní práce agentů

Místo jednoho Claude, který plní úkoly postupně, FullSpec využívá 23 specializovaných AI agentů:

• Generátor Designu
• Plánovač testů
• Koder pro různé jazyky
• Reviewři na každé úrovni
• Agenti synchronizace dokumentace

Při synchronizaci se spustí N agentů paralelně – jeden pro každou službu.

Automatická validace a pravidla

Systém zahrnuje 80+ skriptů validace a 30 pre-commit hooků, které kontrolují:

• Formát dokumentů
• Konzistenci struktury
• Absenci tajemství v kódu
• Soulad commit message se standardy

16 kontextových pravidel se automaticky načítá při práci se soubory: .ts → standard TypeScript, .py → standard FastAPI. Pravidla jsou uložena v .claude/rules/ a aplikují se bez dalších promptů.

Živé specifikace a kontrola konfliktů

Hlavní rozdíl od analogů – systém detekuje a řeší nesrovnalosti mezi kódem a specifikacemi. Po každém commitu se spustí CONFLICT-CHECK:

• Při odhalení protimluvu se proces pozastaví
• Systém určí úroveň konfliktu (Design, Plan Dev atd.)
• Specifikace se kaskádovitě aktualizují shora dolů
• Dokumentace zůstává aktuální ve všech fázích vývoje

Srovnání s alternativními řešeními

| Kritérium | FullSpec | Spec Kit (GitHub) | Kiro (AWS) | OpenSpec (Fission AI) |

|----------|----------|-------------------|------------|-----------------------|

| Typ | Framework procesu | CLI nástroj | IDE (fork VS Code) | CLI framework |

| Formalizace požadavků | Discussion s kritérii | Constitution + Spec | Requirements (EARS) | Proposal |

| Architektonické navrhování | Design s API kontrakty | Plan | Design (markdown) | Design |

| Plánování testů před kódem | Plan Tests s číslováním TC-N | Ne | Ne | Ne |

| Detekce konfliktů | Automatická + kaskádová aktualizace | Ne | Ne | Ne |

| Živá dokumentace | Autosynchronizace ze spec | Ne | Ne | Ne |

| GitHub automatizace | Issues, PR, Review, Release | Ne | Ne | Ne |

| AI agenti | 23 paralelních | 0 | 1 (vestavěný) | 0 |

| Validace | 80+ skriptů, 30 pre-commit hooků | 0 | 0 | ~5 |

| Podpora brownfield | Zatím ne | Ano | Ano | Ano (zaměření) |

FullSpec uzavírá plný cyklus vývoje, ale vyžaduje vazbu na Claude Code a zatím nepodporuje integraci do existujících projektů.

Technické charakteristiky

• 71 skillů – slash příkazy pro každý krok procesu
• 23 AI agentů – paralelní pracovníci se specializací
• 80+ skriptů validace – kontrola ve všech fázích
• 30 pre-commit hooků – automatická kontrola kvality
• 16 kontextových pravidel – rozšiřuje se s přidáním technologií
• 8 fází procesu – od nápadu po production release
• Rekurzivní standardizace – systém vytváří sám sebe podle jednotných pravidel

Co je důležité

• Nízký práh vstupu – navzdory složité architektuře, uživatel interaguje pouze přes /chain a dialogová potvrzení
• Pouze Claude Code – framework je vyvinut pro konkrétního AI asistenta, podpora jiných prostředí netestována
• Česká dokumentace – všechny instrukce a specifikace v češtině, což Claude nebrání v jejich zpracování
• Pouze greenfield – aktuální verze funguje jako šablona pro nové projekty, brownfield podpora ve vývoji
• Otevřený zdrojový kód – projekt dostupný pod licencí MIT na GitHub

Projekt představuje praktickou implementaci přístupu, kde AI nejen generuje kód, ale pracuje v rámci formalizovaného procesu s živou dokumentací. To snižuje rizika architektonických konfliktů a zvyšuje předvídatelnost vývoje v týmech využívajících AI asistenty.

— Editorial Team