Skaro 2.0: artefakty pro AI vývoj

Skaro 2.0: prostředí pro společnou vývoj s AI prostřednictvím artefaktů projektu

Skaro 2.0 představuje prostředí, kde vývojář a AI spolupracují na projektu v oddělených rolích. Člověk určuje architekturu, požadavky a klíčová rozhodnutí. AI plní roli inženýra: diskutuje úkoly, píše kód a zaznamenává etapy. Centrálním prvkem jsou artefakty: strukturované soubory v repozitáři, které uchovávají architektonická rozhodnutí (ADR), plány, specifikace a milníky. Jedná se o vnější paměť projektu, která zabraňuje ztrátě kontextu.

Bez artefaktů společná práce vede k chaosu: rozhodnutí se zapomínají, AI generuje kód bez opory v předchozích dohodách. Skaro integruje chat přímo do artefaktů a uchovává diskuse na místě.

Struktura adresáře .skaro

Artefakty tvoří hierarchickou strukturu v složce .skaro. Zde jsou klíčové komponenty:

.skaro
│   config.yaml
│   constitution.md
│   devplan.md
│   secrets.yaml
│   state.yaml
│   token_usage.yaml
│   usage_log.jsonl
│
├───architecture
│   │   adr-001-použití-fastapi-jako-webového-frameworku.md
│   │   adr-002-zjednodušený-layered-monolith-jako-architektonický-pattern.md
│   │   architecture.md
│   │   chat-conversation.json
│   └───diagrams
├───milestones
│   └───01-foundation
│       └───config-module
│           │   clarifications.md
│           │   plan.md
│           │   spec.md
│           │   tasks.md
│           │   tests.json
│           └───stages
│               └───stage-01
│                   AI_NOTES.md
├───chat
│   tasks.json
└───templates
    adr-template.md
    plan-template.md

• architecture/: Soubory ADR s odůvodněními rozhodnutí, diagramy.
• milestones/: Milníky s podmoduly, plány, testy a poznámkami AI.
• chat/: Logy úkolů pro kontext.
• templates/: Šablony pro standardizaci artefaktů.

Tato struktura žije v Git repozitáři, což zajišťuje verzování a dostupnost.

Scénář typické práce

Práce začíná vytvořením architektonických dokumentů ve spolupráci s AI. Následně se vytváří devplan.md s rozdělením na milníky. Každý milník obsahuje spec.md, plan.md, tasks.md a etapy s AI_NOTES.md.

• Diskutovat architekturu v chatu architecture/, zaznamenat ADR.
• Vygenerovat milník s podúkoly.
• Pro úkol AI získává primární kontext z artefaktů, žádá o soubory.
• Po realizaci – auto-commit (volitelně).
• Aktualizovat nástěnku úkolů na úvodní stránce.

Chat je kontextový: vestavěný do artefaktů a úkolů, nevyžaduje přepínání.

Klíčové novinky ve verzi 2.0

Skaro 2.0 se zaměřuje na zjednodušení procesu:

• Kontextový chat: Dostupný v architecture, milestones, úkolech. Diskuse se ukládají jako chat-conversation.json.
• Předkontext pro LLM: Před úkolem model analyzuje spec.md, plan.md, ADR.
• Auto-commit: Nastavení v config.yaml pro fixaci změn po úkolech.
• Statistika: Samostatná stránka s token_usage.yaml, usage_log.jsonl.
• Kanban nástěnka: Na úvodní stránce – přehled milníků, etap, úkolů.
• Přizpůsobení UI: Témata, akcentní barvy pro každodenní použití.

Opraveny problémy se stabilitou a rozhraním.

Další rozvoj

Open Source jádro zůstává: artefakty, společný model. Plánuje se workspace pro týmy: práva přístupu, analýza tokenů, sdílené nástěnky, kontrola výdajů.

Co je důležité

• Artefakty jako vnější paměť: ADR, milníky zabraňují ztrátě kontextu ve vývoji s AI.
• Rozdělení rolí: člověk – architekt, AI – vykonavatel s oporou ve struktuře.
• Kontextový chat: diskuse v repozitáři, ne v izolovaných oknech.
• Automatizace: předkontext, auto-commit snižují tření.
• Škálování: od sólo vývojáře k týmovému workspace.

— Editorial Team