vitrinka.docs
VývojářSkilly

Psaní

Dokumentace, architektura, stránky a rozhodnutí o návrhu — skilly, které píšou, místo aby opravovaly.

/vitrinka:artifact

Jeden skill, čtyři psané povrchy — jediný vstup pro všechno, co na vitrince píšete, místo abyste to zaznamenávali:

  • Samostatný dokument — report, analýza, srovnání nebo dashboard napsaný jako doc.json z elementů (stránky v pages/), ověřený a odeslaný přes vitrinka board push, vydaný jako karta dokumentu s vlastním pohledem /a/<id> — exportovatelný do PDF, HTML, e-mailu i Wordu a filtrovatelný podle publika.
  • Stránka na úrovni Confluence — markdown stránky, volitelně navázané na soubor v repozitáři se zdrojem a revizí, obnovené po úpravách a zapsatelné zpátky do souboru.
  • Architektonický diagram — složený z pravdy v repozitáři, nebo ze systému, který popíšete. Posíláte význam — dráhy, skupiny, typované uzly, porty, hrany — a rozvrhne to server.
  • Celá živá dokumentační nástěnka — repozitář prohledaný na zdroje pravdy (docker-compose, OpenAPI, SQL DDL, migrace), každý diagram ve své sekci, napsané stránky a odkazy propojené oběma směry.

Souřadnice diagramu neposíláte nikdy. Rozvržení se počítá, takže přidání uzlu obrázek nerozbije. A zaznamenávání práce na UI — snímky, cesty, provázení — je skill publish, ne tenhle.

/vitrinka:brainstorming

Návrh vedený rozhodnutími. Zmapuje rozhodnutí, na kterých opravdu záleží, předloží je jako dávku voleb s doporučením u každé a skončí zapsaným rozhodovacím logem a briefem funkce — a pak z nich staví. Když rozhodnutí jdou na nástěnku, odpovídáte na ně v brainstormovém studiu, jedna kapitola na rozhodnutí, varianty vedle sebe — brainstorming. Brief je zároveň místo, kde /vitrinka-experimental:make-idea předává práci své stavbě.

Paměť před stavbou (vestavěná)

Paměťový průchod před stavbou už nepotřebuje skill — nese ho samotný MCP server. Než se začne navrhovat nebo předělávat obrazovka, session vytáhne, co už vitrinka ví: paměť projektu, starší snímky té obrazovky a indexovaný slovník komponent.

Paměť projektu drží jen trvalá fakta — konvence, rozhodnutí, pasti, které musí nová session respektovat — nikdy poznámky ze session. Agenti ji čtou přes get {kind: "project_memory"}: omezený, seřazený index řádků, které publikují paměťové ostrovy repozitáře projektu (nejdřív připnuté, pak podle druhu, čerstvosti a použití), stránkovaný přes next a označený complete / omitted; note přečte poznámku, na kterou řádek odkazuje. Ty řádky se píšou v repozitáři — memo add <kind>/<topic> "<sentence>." ve worktree, doručené jeho PR — nikdy přes vitrinku. Dokud ho ostrov nepohltí, nese index i starší paměťový dokument projektu (legacy.body, jedna markdown stránka do 64 KiB, čtená a upravovaná v Knihovně → Paměť), který save_project_memory nahradí celý: načtěte ho, změňte jen to, co se změnilo, a zapište zpátky. Po pohlcení ten zápis odpoví 409 legacy_put a váš text si ponechá jako návrh pro repozitář. Když je paměť v rozporu s tím, o co jste požádali, agent vám rozpor předloží, místo aby ho potichu vyřešil.

Existuje proto, aby se nestavělo znovu od nuly.

Na této stránce