Preskočiť na obsah

Stránky buildera

Táto referencia pokrýva hlavné builder pracovné priestory od implementačného plánovania po monitoring buildu. Otvorte ju vtedy, keď už pracujete v builder časti a potrebujete si rýchlo pripomenúť, na čo slúži konkrétna stránka. Je to užitočné najmä preto, že builder-side UI obsahuje viacero podobne znejúcich artefaktov a táto referencia pomáha vybrať správny pracovný priestor skôr, než niečo vytvoríte alebo spustíte. Potrebujete len bežný prístup do aplikácie a väčšina sekcií sa dá prečítať za jednu až dve minúty.

Stránka Implementation workspace

Účel

Implementation workspace používajte ako zjednodušený cockpit pre jednu implementation. Zhrnie pripravenosť Architecture, pripravenosť Feature flow, položky vyžadujúce pozornosť, delivery setup, posledné výsledky a jeden odporúčaný ďalší krok.

Sekcia Start here používa rovnaký vizuálny model ako AI, Specification a Feature workspace: kompaktné KPI, očíslovaný postup a úzky pás odporúčanej akcie zarovnaný so zvýrazneným krokom. Postup zostáva špecifický pre implementáciu: Architecture → Pripravenosť funkcií → Delivery → Výsledky. Tenká jantárová čiara na ľavom okraji príslušnej sekcie nižšie opakuje, ktorej oblasti sa treba venovať ako ďalšej.

Súvisiaci "Flow"

Hlavné akcie

  • skontrolovať Start here a nasledovať odporúčaný ďalší krok
  • skontrolovať pripravenosť Architecture a Feature flow
  • pozrieť chýbajúce flowy, zastarané zosúladenie, chýbajúce guardrails a zlyhané výsledky
  • skontrolovať delivery targety a pripravené delivery
  • otvoriť najnovšie výstupy buildu a delivery
  • použiť AI can help with na otvorenie Architecture akcií, Feature flow akcií a Implementation gap analysis v existujúcich pokročilých stránkach
  • použiť Advanced details na prechod do stránok Implementation, Feature, Architecture, Feature flow, Guardrails, Delivery package, Instruction Set a Build

Poznámky

Workspace je zámerne orientovaný na úlohy. Koncepty ako Delivery package a Instruction Set ostávajú dostupné cez pokročilé odkazy, ale nie sú primárnym slovníkom bežného workflowu.

Stránka Feature workspace

Účel

Feature workspace používajte ako predvolenú riadenú cestu pre jednu Feature. Bohatší model artefaktov zostáva dostupný cez Detailed tools, kým hlavná stránka postupuje cez Scope → Architecture and flow → Guardrails → Delivery → Results a zobrazuje jeden odporúčaný ďalší krok.

Sekcia Start here používa rovnaké kompaktné KPI, očíslovaný postup, zvýraznený krok a zarovnaný pás odporúčanej akcie ako ostatné AIKOZO workspaces. Kroky odkazujú priamo na päť Feature sekcií nižšie, takže spoločná prezentácia nenahrádza akcie špecifické pre Feature. Ovládacie prvky v páse odporúčanej akcie slúžia iba na navigáciu; akcie sa spúšťajú v cieľovej sekcii alebo cez Detailed tools. Sekcia odporúčaného kroku je nižšie označená tenkou jantárovou čiarou na ľavom okraji.

Stránka pred povolením akcií, ktoré od nich závisia, overí referencie Feature na Implementation, Project, Epic a prepojené Use Cases. Ak sa požadovanú referenciu nepodarí načítať, tieto akcie zostanú nedostupné a stránka vyzve na obnovenie namiesto otvorenia odkazu s chýbajúcim identifikátorom. Delivery routing sa načíta až po zobrazení hlavného obsahu workspace; Prepare delivery sa sprístupní až po dokončení tohto náhľadu routingu.

Hlavné akcie

  • potvrdiť Feature, Epic, prepojené Use Cases a zrozumiteľný kontext; každý prepojený Use Case sa zobrazuje so svojím človekom čitateľným kľúčom a názvom. Manuálne vytvorená alebo upravená Feature vyžaduje aspoň jeden prepojený Use Case, aby Feature flowy a generované pracovné položky zachovali sledovateľnosť špecifikácie
  • vygenerovať Feature flow z odporúčaného rozsahu Architecture a všetkých prepojených Use Cases; preferovaný alebo jediný povolený Pattern sa vyberie automaticky
  • postupovať podľa odporúčaných akcií: skontrolovať vygenerovaný Feature flow, vybrať Apply na jeho prijatie, potom otvoriť prijatý draft a nastaviť ho ako final
  • použiť Realign v hornej časti workspace na opätovnú kontrolu aktuálneho Feature flowu voči jeho Architecture a Pattern závislostiam; problémy, ktoré stále vyžadujú zmenu obsahu, sa riešia v Detailed tools
  • skontrolovať automaticky dodané predvolené Guardrails alebo použiť Customize guardrails na priame otvorenie daného Guardrails záznamu pre pokročilé zmeny
  • použiť Prepare delivery na vytvorenie, obnovenie alebo opätovné použitie zhodného Delivery package a zaradenie generovania bez duplikátov
  • vyberať routing iba vtedy, keď je flow alebo work-item target nevyriešený či nejednoznačný
  • po vygenerovaní Delivery package otvoriť balík, schváliť nasledujúci repozitárový Instruction Set a spustiť ho ako build
  • kontrolovať child Instruction Sets ako Generated work items a výsledky buildov aj downstream delivery v sekcii Results

Riadená stránka mapuje detailné lifecycle hodnoty na Draft, Ready, Needs attention, Queued, Running, Done alebo Failed. Generovanie Delivery package zostáva v stave Queued, kým sa nespustí jeho Celery worker, a potom sa zmení na Running. Tlačidlá dlhotrvajúcich akcií zmenia popis a deaktivujú sa ihneď po aktivovaní a generovanie Feature flowu sa polluje až do terminálneho stavu. Archivované artefakty sú skryté. ID artefaktov, raw lifecycle hodnoty, fragmentové ovládanie a interné detaily balíkov zostávajú v Detailed tools.

Migrácia predvolených Guardrails

Nové Features dostanú draft predvolené Guardrails z konfigurácie tenanta. Pred zapnutím riadenej cesty pre existujúce dáta najprv zobrazte náhľad a potom aplikujte tenant-scoped backfill:

spec_kiln migrate default-guardrails --dry-run --tenant-id TEN:example
spec_kiln migrate default-guardrails --tenant-id TEN:example

--all-tenants použite namiesto --tenant-id iba pri zámernom spustení pre celú databázu. Príkaz je idempotentný, hlási blokery a zlyhania jednotlivých Features a vypíše presné per-project príkazy spec_kiln backfill vectors na indexovanie nových Guardrails. Chýbajúci predvolený obsah tenanta blokuje vytvorenie; migrácia nikdy nevytvorí prázdne Guardrails.

Migrácia vlastníctva Feature flow

Pred nasadením modelu, v ktorom flow vlastní Feature, nad existujúcimi dátami najprv zobrazte náhľad a potom aplikujte migráciu vlastníctva:

spec_kiln migrate flow-design-feature-ownership --dry-run
spec_kiln migrate flow-design-feature-ownership

Príkaz priradí Flow Design alebo generation run iba vtedy, keď je možné jednoznačne preukázať jednu zodpovedajúcu Feature, vrátane unikátneho odkazu z Action Packu. Nejednoznačné Epic-scoped záznamy vypíše ako blokery a nebude ich odhadovať. Po úspešnom behu spustite vypísané vector-backfill príkazy pred štartom novej aplikácie.

Stránka Implementation

Účel

Stránku Implementation používajte ako hlavný koordinačný workspace pre jednu implementation. Prepája features, implementačnú Architecture, delivery targety a buildy.

Súvisiaci "Flow"

Pozrite tiež

Hlavné akcie

  • kontrolovať implementation context tree
  • spúšťať sémantické vyhľadávanie nad súvisiacimi implementačnými artefaktmi
  • prepínať medzi Features, Architecture, Delivery targets a Builds
  • spúšťať Gap analysis na odvodenie chýbajúcich runtime fragmentov pre implementačný Architecture z finálnych Feature flowov
  • filtrovať, radiť, vytvárať a otvárať features; kompaktný ovládač na tabe Features prepína najstaršie, najnovšie a poradie podľa key a zachová výber v URL
  • odstrániť Feature spolu s jej balíkmi, generovanými pracovnými položkami, Guardrails, jej Feature flowom a generation runs; súrodenecké Features pod rovnakým Epicom ani ich artefakty to neovplyvní
  • otvárať aktuálny implementačný Architecture
  • vytvoriť prvý Architecture alebo vytvoriť/generovať novú draft verziu Architecture-u po tom, čo už existuje aktuálny Architecture
  • kontrolovať staršie Architecture záznamy v Version history
  • ako Builder alebo Manager vytvárať a spravovať delivery targety vrátane pridania alebo nahradenia uloženého secretu
  • ponechať Delivery target predvolene dostupný iba v aktuálnom projekte alebo ho zámerne sprístupniť všetkým projektom v tenante
  • pred aktiváciou validovať konektivitu Delivery targetu; ak nie je dostupné bezpečné uloženie prihlasovacích údajov, validácia oznámi chýbajúcu konfiguráciu EXECUTION_TARGET_ENCRYPTION_KEY namiesto pokusu o pripojenie k providerovi
  • vytvárať a otvárať buildy

Gap analysis

Na záložke Gap analysis na stránke Implementation porovnávate aktuálny finálny implementačný Architecture so všetkými použiteľnými finálnymi Flow flowmi v danej implementation. Analýza vylučuje finálne Feature flowy označené ako broken_reference a navrhuje iba aditívne runtime fragmenty: moduly, komponenty, rozhrania a entity.

Každé odporúčanie zostáva na úrovni implementation a dá sa aplikovať po jednom. Pri aplikovaní sa analyzovaný implementačný Architecture upraví na mieste a jeho stav sa najprv zmení z final na candidate.

Výber promptu sa riadi tenant nastaveniami v tomto poradí:

  • explicitný prompt zvolený pri spustení
  • tenant predvolený prompt pre design.gap_analysis.implementation
  • repository predvolený prompt z config/prompts/implementation_gap_analysis_v1.md
  • New feature
  • New build
  • New architecture / New draft version
  • Generate architecture with AI / Generate draft version
  • Delivery target details: detailný prehľad jedného spravovaného delivery targetu
  • Execution mapping: otvorenie mapping modalu zo záložky Delivery targets, keď má implementation aspoň dva Git repository targety. Module mapping používajte ako predvolenú routing vrstvu a Component overrides (when one component belongs elsewhere) iba pre výnimky na úrovni komponentu.

Stránka Feature

Účel

Stránku Feature používajte na posun jednej feature od architektonického zámeru k delivery-ready orchestration artefaktom.

Súvisiaci "Flow"

Pozrite tiež

Hlavné akcie

  • prepínať medzi Feature flow, Guardrails a Delivery packages
  • používať delivery-packages ako kanonický URL tab pre Delivery packages; legacy odkazy instruction-sets a action-packs sa presmerujú na rovnaký tab
  • používať child odkazy v kontexte Feature a spätné odkazy descendantov bez straty príslušného tabu
  • chápať — ako nenačítaný stav; po načítaní tab zobrazuje Missing, Draft, Ready, Needs attention, Broken, Running, Done alebo Failed namiesto nesprávnej nuly pre neotvorený tab
  • kontrolovať alignment summary feature flowov
  • vytvoriť guardrails
  • otvárať feature flowy a delivery packagey
  • vyradiť nahradený Feature flow v ľubovoľnom stave životného cyklu vrátane final, aby sa už nezúčastňoval aktívnej implementačnej práce
  • zachovať Delivery packages, vygenerované pracovné položky a históriu buildov prepojenú s vyradeným Feature flowom kvôli sledovateľnosti
  • generovať nový feature flow z povinného patternu a kontextu Architecture v režime Recommended, All alebo Manual
  • kontrolovať generated draft a vykonať apply, discard alebo rerun
  • po obnovení vidieť najnovší vygenerovaný draft v každom browser tabe; kým sa nepoužije Apply, pripravenosť sa zobrazuje ako Generated draft, nie ako chýbajúci prijatý Feature flow alebo dokončený artefakt
  • vytvoriť delivery package z jedného feature flowu a vybraných flowov
  • keď je delivery blokované, použiť kontextovú akciu na generovanie alebo kontrolu Feature flowu, vyriešenie alignmentu či nefunkčných referencií alebo nastavenie Delivery targets; creation modal sa otvorí až po splnení použiteľných prerequisites

Architecture zostáva vo vlastníctve stránky Implementation. Pokročilá stránka Feature neponúka vytváranie ani úpravu Feature-local Architecture.

  • Create delivery package
  • New guardrails
  • Generate feature flow: vytvorenie draftu Feature flow-u z aktívneho a povoleného Patternu, zdrojových use case-ov, inštrukcií pre generovanie a náhľadu kontextu Architecture; server Pattern overí a pridelí identifikátory vygenerovaných krokov

Stránka Architecture

Účel

Stránku Architecture používajte na kontrolu a refinement autoritatívneho implementačného architektonického artefaktu.

Súvisiaci "Flow"

Pozrite tiež

Hlavné akcie

  • kontrolovať status, description, prompt template a kontext
  • prepínať medzi Overview, Modules, Components, Interfaces, Entities, Values, Processes, Events, Policies a ADRs
  • prezerať diagramy entít, modulov a komponentov s rozhraniami
  • filtrovať fragmentové zoznamy na jednotlivých záložkách
  • vyberať fragmenty a spúšťať Validate, Align alebo Enhance
  • používať uložené quick phrases v modale architecture akcie
  • ukladať allowed a preferred patterns
  • kontrolovať enhancement históriu a robiť apply, discard alebo rerun preview
  • prezerať YAML Architecture ako navigovateľný strom alebo úplný zdroj
  • kopírovať alebo sťahovať YAML Architecture bez otvorenia editora
  • zobraziť náhľad, kopírovať alebo stiahnuť export PlantUML so samostatnými diagramami modulov, komponentov s rozhraniami a entít
  • upravovať raw YAML manuálne
  • Run architecture action
  • Patterns
  • Raw YAML
  • Edit architecture
  • fullscreen modaly pre diagramy entít, modulov a komponentov s rozhraniami

Stránka Feature flow

Účel

Stránku Feature flow používajte na kontrolu feature-level flowov a ich zarovnanie s aktuálnou implementačnou Architecture a patternmi. Stránka vždy zobrazuje flow patriaci vybratej Feature, nikdy flow implicitne zdieľaný cez jej Epic.

Súvisiaci "Flow"

Pozrite tiež

Hlavné akcie

  • kontrolovať status, alignment badge a alignment details
  • spustiť recheck alignment
  • prepínať medzi Overview, Flows a Raw YAML
  • prezerať overview diagram flow krokov
  • vyberať flowy a spúšťať Validate, Align alebo Enhance
  • kontrolovať históriu akcií a follow-up odporúčania
  • upravovať raw YAML manuálne
  • vyradiť Feature flow aj v stave životného cyklu final alebo so zastaraným alignmentom

Vyradenie zmení Feature flow na archived, skryje ho z aktívnych implementačných zobrazení a umožní povýšiť opravený flow. Existujúce Delivery packages, vygenerované pracovné položky, buildy, commity, pull requesty a delivery výsledky zostanú prepojené s vyradeným flowom a dostupné cez historické detailné stránky. Priame vymazanie odstráni flow bez delivery histórie; ak delivery história existuje, rovnaká požiadavka ho bezpečne vyradí.

  • Run action
  • Edit feature flow
  • fullscreen overview modal pre flow overview diagram

Stránka Guardrails

Účel

Stránku Guardrails používajte na definovanie a refinement implementačných guardrailov pre jednu feature.

Súvisiaci "Flow"

Pozrite tiež

Hlavné akcie

  • kontrolovať status, prompt template a kontext
  • vybrať jeden focused Architecture context a read-only fragmenty
  • zadať enhancement query a zaradiť preview do frontu
  • kontrolovať enhancement históriu
  • použiť default guardrails, vyčistiť current set alebo upravovať YAML
  • posúvať artefakt medzi draft a final
  • Edit guardrails: úprava metadát alebo základných nastavení guardrails

Stránka Delivery package

Účel

Stránku Delivery package používajte na kontrolu jedného delivery orchestration balíka pred alebo po generovaní child instruction setov.

Súvisiaci "Flow"

Pozrite tiež

Hlavné akcie

  • kontrolovať status, počet delivery targetov, počet child instruction setov a repository strategy
  • generovať child instruction sety
  • overiť, či vygenerovaná repozitárová práca je agent-bootstrap, repo-init alebo feature implementation
  • otvoriť current alebo last build, ak je dostupný
  • kontrolovať zahrnuté flowy
  • kontrolovať delivery targety
  • skúmať tab Traceability map ako vrstvovú mapu od požiadaviek a use case-ov cez feature flowy, akčné položky, delivery artefakty až po zmenené súbory
  • otvárať vygenerované instruction sety

Stránka Instruction Set

Účel

Stránku Instruction Set používajte na kontrolu vygenerovaného execution balíka, ktorý riadi build alebo delivery prácu.

Pri repozitárovej práci pred spustením skontrolujte intent. agent-bootstrap materializuje iba markdown guidance. repo-init vytvorí runnable baseline pre nový repozitár alebo repozitár iba s guidance súbormi. Feature sady inštrukcií môžu byť viditeľné aj blokované, ale bežia až po tom, čo sa repo-init dostane do repozitára a Delivery package sa znovu vygeneruje.

Keď sú vygenerované, používajte children v poradí: agent-bootstrap, merge alebo land jeho Git výstupu, keď zmenil repository guidance, repo-init, merge alebo land výstupu repo-init, regenerácia, feature sada inštrukcií, merge alebo land feature výstupu, potom human review/task.

Súvisiaci "Flow"

Pozrite tiež

Hlavné akcie

  • locknúť alebo unlocknúť instruction set
  • kontrolovať metadata, intent badges a execution state
  • kontrolovať generation progress
  • zobraziť alebo skryť final prompt
  • prezerať vygenerované instructions
  • vyrenderovať skill.md a kontrolovať rendered artifacts
  • otvoriť current alebo last build

Stránka Build

Účel

Stránku Build používajte na monitoring execution výsledku jedného instruction setu alebo action-pack delivery runu.

Nový build zostáva v stave queued, kým čaká v samostatnom fronte sandbox runnerov. Do stavu running prejde až vtedy, keď ho runner prevezme a začne vykonávať.

Odkaz Repository používa snapshot repozitára vyriešený runnerom a managed Execution Target daného buildu. Pri staršom builde bez tohto snapshotu stránka odvodí odkaz na repozitár z URL GitHub pull requestu alebo GitLab merge requestu.

Položka Build v context tree zobrazuje namiesto interného databázového ID čas spustenia v lokálnom časovom pásme prehliadača spolu s aktuálnym stavom. Ak execution ešte nezačal, zobrazuje sa čas zaradenia do frontu.

Súvisiaci "Flow"

Pozrite tiež

Hlavné akcie

  • kontrolovať build status, repository, pull request a errors
  • prepínať medzi Build log a Files
  • prezerať streaming build output
  • prezerať changed files po execution
  • zopakovať Git push a vytvorenie review requestu po zlyhaní iba v push fáze
  • vracať sa späť na súvisiaci instruction set, delivery package alebo implementation

Ak GitHub build zlyhá pri pushovaní zmien pod .github/workflows/, pred opakovaním pushu skontrolujte, že vybraný GitHub token obsahuje workflow oprávnenie. Pozrite Nastavenie GitHub a GitLab tokenu.