Kontrakty adresářů
Každý adresář vrstvy říká, k čemu je, v README, které se skládá s jeho předky. Strom níže je ten, který čte resolver, s verdiktem, ke kterému validace u každého adresáře dospěla.
- Adresáře ve stromě
- 70
- Nesení kontraktu
- 39
- Vyňato svým řídicím kontraktem
- 31
Strom
Každý řádek je adresář .ai. Adresář nese svůj vlastní kontrakt, nebo ho z vlastního kontraktu vyjímá kontrakt, který řídí jeho podstrom — instance druhu, jako je dovednost a její příklady, nedluží žádný vlastní kontrakt. Co platí pro cestu, je majordomus context resolve <path>; tato stránka je tvar, který toto řešení prochází.
-
.ai/.aipodstrom finálníai.layer— Kontext AI repozitářeProtokol vrstvy: co drží, kdo vlastní kterou polovinu, jak se objevuje a co má přednost před čím.
-
repo/.ai/repopodstrom rozšířitai.repo— Sledovaný kontext repozitářeSledovaná polovina vrstvy a k čemu slouží každá sekce pod ní.
-
adrs/.ai/repo/adrspodstrom rozšířitai.repo.adrs— Architektonická rozhodnutíPřijatá, trvalá rozhodnutí o tom, jak je tento repozitář postaven.
-
applications/.ai/repo/applicationspodstrom rozšířitai.repo.applications— AplikaceKontexty, kterým nástroj vyhovuje, kdy se hodí a kdy ne, složené z případů užití.
-
automation/.ai/repo/automationpodstrom rozšířitai.repo.automation— Inventář automatizaceKaždá jednotka automatizace tohoto repozitáře, její disposice migrace a výjimka, která dovoluje shellové jednotce zůstat shellem.
-
benchmarks/.ai/repo/benchmarkspodstrom rozšířitai.repo.benchmarks— Měření výkonuZaznamenané základy, se kterými se porovnává tvrzení o výkonu, jeden adresář na měřený povrch.
-
economics/.ai/repo/benchmarks/economicspodstrom rozšířitpotomci vyňatiai.repo.benchmarks.economics— Benchmark ekonomiky tokenůMetodika, sady a korpus úloh, které měří, co relace spotřebuje s Majordomus a bez něj, a surové běhy zaznamenané pod nimi.
sleduje
apps/majordomus-cli/src/economics,test/fixtures/economics -
runs/.ai/repo/benchmarks/economics/runsŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
context/.ai/repo/benchmarks/economics/runs/contextŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
suites/.ai/repo/benchmarks/economics/suitesŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
tasks/.ai/repo/benchmarks/economics/tasksŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
csv-credit-notes/.ai/repo/benchmarks/economics/tasks/csv-credit-notesŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
currency-czk/.ai/repo/benchmarks/economics/tasks/currency-czkŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
invoice-discounts/.ai/repo/benchmarks/economics/tasks/invoice-discountsŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
recurring-invoices/.ai/repo/benchmarks/economics/tasks/recurring-invoicesŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
storage-v2/.ai/repo/benchmarks/economics/tasks/storage-v2Žádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
test-repair/.ai/repo/benchmarks/economics/tasks/test-repairŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
vat-rounding/.ai/repo/benchmarks/economics/tasks/vat-roundingŽádný vlastní kontrakt;
.ai/repo/benchmarks/economics/README.mdosvobozuje adresáře pod ním. -
observatory/.ai/repo/benchmarks/observatorypodstrom rozšířitpotomci vyňatiai.repo.benchmarks.observatory— Důkazy ObservatoryKontroly Observatory (G0 až G7) s jejich verdikty a měřeními v prohlížeči, která za nimi stojí, každé s uvedením revize, příkazu a stroje.
-
live/.ai/repo/benchmarks/observatory/liveŽádný vlastní kontrakt;
.ai/repo/benchmarks/observatory/README.mdosvobozuje adresáře pod ním. -
production/.ai/repo/benchmarks/observatory/productionŽádný vlastní kontrakt;
.ai/repo/benchmarks/observatory/README.mdosvobozuje adresáře pod ním. -
pages/.ai/repo/benchmarks/pagespodstrom rozšířitai.repo.benchmarks.pages— Základní hodnoty publikaceKolik stálo publikování webu na pojmenované platformě, uchováno jako srovnání pro další běh.
sleduje
scripts/pages -
rust/.ai/repo/benchmarks/rustpodstrom rozšířitai.repo.benchmarks.rust— Baselines executablesZáklady podle platforem pro příkazy spustitelného souboru v Rustu, s politikou, která rozhoduje o regresi.
sleduje
apps/majordomus-cli/src/bench,scripts/rust-check -
ci/.ai/repo/cipodstrom rozšířitai.repo.ci— Kontinuální integraceKontroly, které tento repozitář spouští, které změněné cesty je vybírají a co smí publikace utratit.
sleduje
scripts/ci-plan,scripts/pages,.github/workflows/validate.yml -
deployments/.ai/repo/deploymentspodstrom rozšířitai.repo.deployments— NasazeníJeden kanonický objekt na nasazení spustitelného souboru tohoto repozitáře; každý artefakt z něj sestavený — definice image kontejneru a její ignore soubor — se z něj generuje a žádný z nich není autoritativní.
sleduje
share/schemas/majordomus/deployment/deployment.v1.schema.json,share/kinds.yaml -
evidence/.ai/repo/evidencepodstrom rozšířitai.repo.evidence— EvidenceZaznamenaná provedení, z nichž se čte důkaz tvrzení — co běželo, proti kterému commitu a s jakým výsledkem.
-
features/.ai/repo/featurespodstrom rozšířitai.repo.features— Funkce produktuCo produkt dělá pro člověka, jedna funkce na soubor, každá složená z věcí, které už vlastní ostatní registry; každý povrch, který funkci prezentuje, je odvozen z těchto souborů.
sleduje
apps/majordomus-cli/src/product.rs,apps/majordomus-cli/src/capability/builtin/product.rs,site/templates/index.html,site/templates/feature.html,site/templates/features-section.html -
domains/.ai/repo/features/domainspodstrom rozšířitai.repo.features.domains— Produktové doményTěch málo věcí, které produkt řídí, jedna doména na soubor; každá funkce jmenuje právě jednu a členové, rozhraní a důkazy každé domény se odvozují z funkcí, které ji jmenují.
sleduje
apps/majordomus-cli/src/product.rs,site/templates/domain.html,site/templates/domains-section.html,site/templates/partials/domain-map.html -
knowledge/.ai/repo/knowledgepodstrom rozšířitai.repo.knowledge— ZnalostiJak se znalosti repozitáře deklarují a objevují, nikdy neshromažďují.
sleduje
lib/knowledge.sh,lib/capture.sh,lib/session.sh,share/knowledge-sources.yaml -
candidates/.ai/repo/knowledge/candidatespodstrom rozšířitai.repo.knowledge.candidates— Kandidátní záznamyTo, co nástroj odvodil z knihy a gitu na hranici epizody a co zatím nikdo nezrevidoval, objevováno jako zdrojová třída znalostí.
-
curated/.ai/repo/knowledge/curatedpodstrom rozšířitai.repo.knowledge.curated— Kurátorské poznámkyTo, co se tento repozitář rozhodl napsat o sobě, zjištěné jako třída zdroje znalostí.
-
mesh/.ai/repo/meshpodstrom rozšířitai.repo.mesh— MeshJeden kanonický objekt, který říká, zda servery tohoto repozitáře participují na objevování meshe, přes které transporty a komu důvěřují; chybějící nebo vypnutý znamená, že se neotevře žádný socket.
sleduje
share/schemas/majordomus/mesh-declaration/mesh-declaration.v1.schema.json,share/kinds.yaml,docs/MESH.md -
observatory/.ai/repo/observatorypodstrom rozšířitai.repo.observatory— Záznam observatořeZáznam scén meshe, které publikovaná Observatory přehrává tam, kde žádný mesh neběží, zachycený z běžícího serveru a commitnutý.
-
offload/.ai/repo/offloadpodstrom rozšířitai.repo.offload— Derive offloadJediná deklarace strojů, na které lze odvození větve přenést, a limitů, které každý musí splnit; `majordomus offload` ji čte a žádný skript nenese adresu hostitele.
sleduje
share/schemas/majordomus/derive-offload/derive-offload.v1.schema.json,share/kinds.yaml,docs/OFFLOAD.md -
profiles/.ai/repo/profilespodstrom rozšířitai.repo.profiles— ProfilyKolik kontextu, úsilí a ceremonie úloha dostane, deklarováno pro každý pracovní režim.
sleduje
lib/common.sh,share/allow/profile.txt -
project/.ai/repo/projectpodstrom rozšířitai.repo.project— Model projektuMilníky jako výsledky, úkoly jako prováděcí kontrakty a graf závislostí, který rozhoduje, co je další.
sleduje
lib/project.sh,lib/project.awk,share/allow/project.txt -
critiques/.ai/repo/project/critiquespodstrom rozšířitai.repo.project.critiques— Kritiky plánuAdversariální průchod plánem záměru, jako strukturované nálezy s jejich řešeními.
-
gaps/.ai/repo/project/gapspodstrom rozšířitai.repo.project.gaps— Analýzy mezerCo worker pozoroval na tomto repozitáři vůči kritériím intentu, na jednom commitu.
-
intents/.ai/repo/project/intentspodstrom rozšířitai.repo.project.intents— ZáměryCo se musí stát pravdou nad milníky, které to realizují, s důkazy, které to rozhodují.
sleduje
share/allow/intent.txt,share/schemas/majordomus/intent/intent.v1.schema.json -
issues/.ai/repo/project/issuespodstrom rozšířitai.repo.project.issues— ÚkolyProváděcí smlouvy: každá jedna ohraničená změna s rozsahem, závislostmi a důkazy, které musí zanechat.
sleduje
share/allow/issue.txt -
milestones/.ai/repo/project/milestonespodstrom rozšířitai.repo.project.milestones— MilníkyKaždý jeden výsledek, zapsaný jako problém, který ukončuje, a stav, který dokládá, že skončil.
sleduje
share/allow/milestone.txt -
prompts/.ai/repo/promptspodstrom rozšířitai.repo.prompts— Prompt assetyPrompty neutrální vůči providerovi, které nástroj vykresluje, s tokeny, které doplňuje.
sleduje
lib/prompt.sh,share/allow/prompt.txt -
providers/.ai/repo/providerspodstrom rozšířitai.repo.providers— Šablony poskytovatelůJediný zdroj, ze kterého se vykresluje bootstrap každého poskytovatele; soubory v kořeni jsou výstup.
sleduje
lib/update.sh,.ai/repo/policy.yaml -
releases/.ai/repo/releasespodstrom rozšířitai.repo.releases— Publikované releaseJeden záznam na publikovaný release, zapsaný pipeline release a čtený každou projekcí veřejných metadat release.
-
rules/.ai/repo/rulespodstrom rozšířitchildren jsou povinnéai.repo.rules— Pravidla repozitářeFormát objektu pravidla, kde pravidla žijí, jak se načítají a skládají.
sleduje
lib/rules.sh,lib/doctrine.sh,share/standard/majordomus,share/allow/rule.txt -
project/.ai/repo/rules/projectpodstrom rozšířitai.repo.rules.project— Pravidla projektuPravidla, která si tento repozitář napsal sám, jeden soubor na pravidlo, vyřešená s vendorovanou základní hodnotou.
-
sessions/.ai/repo/sessionspodstrom rozšířitai.repo.sessions— Záznamy relacíJeden neměnný záznam na uzavřenou epizodu provádění, odvozený z gitu a ledgeru a sdílený každým povrchem.
sleduje
lib/session.sh,share/schemas/majordomus/session-record/session-record.v1.schema.json -
skills/.ai/repo/skillspodstrom rozšířitpotomci vyňatiai.repo.skills— DovednostiOpakovaně použitelné provozní postupy nezávislé na poskytovateli, načítané jen tehdy, když se úloha týká právě jich.
-
assess-before-deleting/.ai/repo/skills/assess-before-deletingŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
examples/.ai/repo/skills/assess-before-deleting/examplesŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
deploy-site/.ai/repo/skills/deploy-siteŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
evolve/.ai/repo/skills/evolveŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
examples/.ai/repo/skills/evolve/examplesŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
implement/.ai/repo/skills/implementŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
examples/.ai/repo/skills/implement/examplesŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
pack-for-chatgpt/.ai/repo/skills/pack-for-chatgptŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
examples/.ai/repo/skills/pack-for-chatgpt/examplesŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
pack-for-review/.ai/repo/skills/pack-for-reviewŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
examples/.ai/repo/skills/pack-for-review/examplesŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
repo-review/.ai/repo/skills/repo-reviewŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
examples/.ai/repo/skills/repo-review/examplesŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
report-verification-state/.ai/repo/skills/report-verification-stateŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
examples/.ai/repo/skills/report-verification-state/examplesŽádný vlastní kontrakt;
.ai/repo/skills/README.mdosvobozuje adresáře pod ním. -
use-cases/.ai/repo/use-casespodstrom rozšířitai.repo.use-cases— Případy užitíÚlohy, které lidé s nástrojem provádějí, každá jako soubor s příkazy, pravidly a tvrzeními, které jmenuje, a sekcí scénáře, která je dokazuje.
-
why/.ai/repo/whypodstrom rozšířitpotomci vyňatiai.repo.why— Proč tento nástroj existujeProvozní okamžiky, na které tento nástroj odpovídá, publika, která je poznávají, a oblasti, pod které spadají, každý jako soubor, z něhož se odvozují všechny projekce.
sleduje
site/templates/why-section.html,site/templates/why.html -
areas/.ai/repo/why/areasŽádný vlastní kontrakt;
.ai/repo/why/README.mdosvobozuje adresáře pod ním. -
audiences/.ai/repo/why/audiencesŽádný vlastní kontrakt;
.ai/repo/why/README.mdosvobozuje adresáře pod ním. -
moments/.ai/repo/why/momentsŽádný vlastní kontrakt;
.ai/repo/why/README.mdosvobozuje adresáře pod ním. -
workflows/.ai/repo/workflowspodstrom rozšířitai.repo.workflows— WorkflowVícekrokové postupy, kterými se pracovník řídí, a kdy se který použije.
sleduje
lib/start.sh,lib/check.sh,lib/finish.sh,lib/handover.sh,lib/plan.sh -
workspaces/.ai/repo/workspacespodstrom rozšířitai.repo.workspaces— Externí workspacesJedna deklarace na každý externí workspace, který tento repozitář smí číst; obsah, který jmenuje, je stav tohoto checkoutu a nikdy zde není.
sleduje
share/schemas/majordomus/workspace/workspace.v1.schema.json,share/kinds.yaml
Jak se řetěz skládá
Efektivní kontext pro cestu je každý použitelný dokument od kořene až k ní, nejméně specifický první, řazený podle hloubky, pak podle deklarovaného pořadí, pak podle cesty. Dokument subtree platí pro svůj adresář a vše pod ním; dokument directory jen pro svůj vlastní adresář; dokument explicit pro adresáře, které vypisuje. extend připojuje, replace jmenuje předky, které zastupuje, a final nesmí být nahrazen ničím pod ním.