I1310 — Subsystém je zdokumentován tam, kde ho člověk hledá, a plán je uzavřen proti repozitáři

✕BLOKOVÁNO vlna 5 · p2 · profil deep-work · bezpečné paralelně

Součást external-workspaces — Externí pracovní prostor se čte stejně jako cokoli jiného v tomto repozitáři a jeho obsah se nikdy nestane veřejným omylem.

Cíl

Napsat docs/WORKSPACES.md, přidat řádek do indexu dokumentace a znovu zauditovat repozitář proti tomuto milníku: co bylo znovu vynalezeno, jaká zděděná duplicita přežívá a které fáze balíčku se ukázaly jako zde neuplatnitelné.

Proč

Balíček, ze kterého tento milník vzešel, předpokládá rozhraní, která audit ukázal jako nedosažitelná pro lokální obsah, a pozdější worker čtoucí balíček místo tohoto milníku by ten předpoklad znovu vystavěl. Dokumentace je místo, kde se to pro každého dalšího vyřeší.

Aktuální stav

ADR 0025 zaznamenává rozhodnutí a stažení dvou dřívějších postojů. Nic v docs/ subsystém nepopisuje.

Cílový stav

docs/WORKSPACES.md uvádí, co je workspace, v čem se liší od poskytovatele, politiku transportu a její upřímnost ohledně způsobu získání, úložiště a jeho hranici, co se záměrně nepublikuje a jak se přidá druhý dodavatel. Řádek v indexu existuje; web ho vykresluje; opětovný audit je zaznamenán.

Rozsah

• dokumentace
• .ai/repo/adrs

Mimo rozsah

• Dokumentování schopnosti, která ještě neexistuje

Závislosti

• I1308✕BLOKOVÁNO Sdílení spustitelného souboru je jedna schopnost, utvářená jako continuity
• I1309✕BLOKOVÁNO Hranice, které tento milník tvrdí, jsou kontroly, ne věty

Kritéria přijetí

• docs/WORKSPACES.md existuje, je odkazován z rejstříku dokumentace a vykresluje se na webu
• Dokument vlastními slovy uvádí rozdíl oproti poskytovateli z ADR 0024, aby je čtenář, který ADR nikdy neotevře, nezaměnil
• Re-audit jmenuje každé místo, kde se předešlo druhé implementaci existujícího mechanismu, a každé, kde přežívá
• ADR 0025 přijímá nebo mění člověk a jeho stav odráží, co bylo skutečně vybudováno

Validace

• bash test/run.sh
• majordomus generate --check

Požadované důkazy

• zdokumentováno
• indexováno
• znovu auditováno
• adr_settled

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

Dokumentace psaná z plánu místo ze sestaveného subsystému. Z toho důvodu se píše jako poslední.

Č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/I1310.yaml. Přečtěte jej zpět pomocí majordomus plan show I1310.