I1026 — Architektura se vysvětluje sama, zevnitř sebe

✕BLOKOVÁNO vlna 4 · p1 · profil implementation · bezpečné paralelně

Součást capability-graph — Jeden graf schopností, dvě projekce a žádný druhý inventář toho, co tento repozitář umí.

Cíl

Zdokumentovat graf, jeho zdroje, model vztahů, jeho dvě projekce a postup pro přispěvatele a nechat rozhraní říct, jak a z čeho bylo vygenerováno.

Proč

Celý slib je, že přispěvatel zaregistruje schopnost na jednom místě a všechno ostatní následuje. Ten slib je použitelný, jen když je to jedno místo zapsáno, a samotné rozhraní je nejspolehlivějším místem pro svůj vlastní původ.

Aktuální stav

Cockpit má dokument. Složený graf, model relací a pracovní postup přispěvatele žádný nemají.

Cílový stav

Jeden architektonický dokument dostupný z míst, kde čtenář začíná, a rozhraní, které uvádí svůj vlastní režim, zdroje a revizi.

Rozsah

• docs/COCKPIT.md

Mimo rozsah

• Duplikace zdůvodnění ADR v próze
• Opakování úplných pokynů v každém adresářovém dokumentu místo jejich skládání

Závislosti

• I1012○PŘIPRAVENO Jeden detailní pohled, sestavený z toho, co uzel skutečně má
• I1025✓HOTOVO Federovaný model a jeho dvě projekce jsou architektonické rozhodnutí

Co na tom čeká

• I1030✕ZABLOKOVÁNO Milník se přijímá na základě svých důkazů

Kritéria přijetí

• Dokument vysvětluje zdroje, model relací, obě projekce, podmíněné vystavení runtime povrchů, jak se nová schopnost objeví bez úpravy, pravidla, dovednost a jak ladit chybějící uzel
• Rozhraní uvádí svůj vlastní režim, své zdroje, verzi schématu a revizi sestavení z bezpečných metadat
• Je dosažitelný z kořenového dokumentu, dokumentů architektury a samotného rozhraní, přes stávající křížové odkazy, ne ručně psaný seznam
• Každý nový adresář, který tento milník vytvoří, nese svůj kontextový dokument podle kontraktu adresářů

Validace

• bash test/run.sh
• bin/majordomus doctor

Požadované důkazy

• architecture_documented
• self_documenting

Důkazy

Nic nezaznamenáno. Za každým tokenem výše musí stát příkaz nebo artefakt, než lze tento úkol dokončit; vyprávění se odmítá.

Riziko

Dokument vysvětlující odvození zastarává rychleji než odvození. Každá hodnota, kterou uvádí o současném repozitáři, je generována, ne psána.

Časová osa

zahájeno

—

ověřeno

—

dokončeno

—

Tato tři pole, důkazy výše a stav závislostí jsou vše, z čeho se stav skládá. Neexistuje žádné pole stavu, které by s nimi mohlo být v rozporu.

Kanonický záznam: .ai/repo/project/issues/I1026.yaml. Přečtěte ho zpět pomocí majordomus plan show I1026.