Sada komponent
Jeden slovník.Každá obrazovka.
Komponenty, z nichž je složena každá stránka tohoto webu: tóny, atomy, panely, seznamy, terminály, záložky, dashboard a diagramy. Každá je zde ukázána vykreslená z vlastních dat repozitáře, napsaná jednou v share/design/kit.css a site/templates/kit/.
“Stránka říká, čím věc je — odznak, tabulka, blok kódu, karta — a tento soubor říká, jak ta věc vypadá.”
01 / tóny
Tóny
Odstíny, které nesou identitu a nikdy význam: barva kroku, karty jednoho povrchu, jednoho druhu v oblaku druhů. Tón je třída; každá komponenta jej čte přes stejné čtyři vlastnosti.
-
1 modráGET
první krok sekvence; tón CLI, soubory, které repozitář drží
.mj-tone--blue -
2 fialováGET
druhý krok; tón typovaného modelu a API
.mj-tone--violet -
3 zelenáGET
třetí krok; tón odvozených povrchů
.mj-tone--green -
4 oranžováGET
čtvrtý krok; tón toho, co se předkládá a vrací zpět
.mj-tone--orange -
5 vzrostloGET
pátý odstín pro slovník delší než čtyři, například mrak druhů
.mj-tone--rose -
6 azurováGET
šestý odstín pro slovník delší než pět
.mj-tone--cyan
02 / atomy
Atomy
Tlačítka, glyfy, kroky, slova slovníku a slova stavu. Slovo stavu je barevné podle stavu, pod kterým je vedeno v share/design/tokens.yaml, a podle ničeho jiného.
03 / nadpis stránky
Hero, citace a hlavička sekce
Horní část této stránky je hero; jeho aside přijímá citát, terminál nebo řadu tvrzení. Hlavička sekce je to, co otevírá každou sekci níže.
“projekce trvalého stavu, ne zdroj pravdy: každý řádek ověřte proti gitu”
kicker
Název sekce
Úvod, který jednou větou říká, co sekce obsahuje.
04 / kontejnery
Panely a fáze
Kontejner, ve kterém sedí každý blok, prostý, tónovaný nebo tichý, a řada fází spojených šipkami, která se na širokém displeji čte zleva doprava a na úzkém shora dolů.
Deklarovat
share/design/tokens.yaml rozhoduje každou hodnotu
Fáze 1 ze 4.
Generovat
majordomus generate design jej promítá
Fáze 2 ze 4.
Kontrola
scripts/ci/design-check odmítá drift
Fáze 3 ze 4.
Opotřebení
každý povrch importuje projekce
Fáze 4 ze 4.
05 / seznamy
Stromy, body, trasy, dlaždice
Co repozitář drží, co stránka slibuje, které rozhraní co dělá a kam jít dál.
Repozitář
Co vrstva čte
prismatic-majordomus/
- .ai/vrstva: politika, pravidla, prompty, workflow
- apps/spustitelný soubor v Rustu
- docs/rozhodnutí, manuály a generované dokumenty
- share/distribuce: schémata, design, druhy
- site/tento web, odvozený ze zbytku
-
test/případy
- cases/567 test objects
- justfilerecepty, které člověk spouští
Záruky
Body, linkované
- Jedna deklaracekaždý povrch čte stejný registr
- Deterministickéstejný vstup promítne stejné bajty
- Vynucovánodeklarované pravidlo má kontrolu
- Rozšiřitelnéschopnost se deklaruje jednou a promítá
Rozhraní
Routy, popsané
-
Příkazová řádkamajordomus briefLokální prácekaždá schopnost jako příkaz
-
HTTP APIGET /api/v1/briefProgramový přístupJSON, popsaný OpenAPI
-
MCPmajordomus_briefNástroje pro agentytáž schopnost jako nástroj
- Documentationhttps://majordomus.dev/docs/ Tento webgenerovaný z repozitáře
Kompaktní dlaždice
Související
- Regenerovánonikdy neupravováno ručně
- Zkontrolovánokontrolami v CI
- Jeden zdrojvrstva pod .ai/
- Pro lidi i agentytýž kontrakt
Tabulka řádků
| path | metoda | co dělá |
|---|---|---|
| /api/v1/brief | GET | Brief relace |
Každý druh, který vrstva drží
Mrak slov, každé v tónu svého místa v seznamu; z indexu registru.
- adr
- aplikace
- oblast
- publikum
- claim
- command
- kontext
- kritika
- nasazení
- derive-offload
- distribution-model
- dokument
- doména
- funkce
- mezera
- implementace
- intent
- issue
- knowledge
- mesh-declaration
- milestone
- okamžik
- policy
- profil
- prompt
- release-record
- pravidlo
- scope
- session
- dovednost
- taxonomie
- test
- use-case
- workspace
- Jeden zdrojvrstva pod .ai/
- Odvozenépřegenerované, nikdy ručně upravované
- Zkontrolovánokontroly v CI
- Objevenonic se neregistruje ručně
- Pro lidi i agentystejný kontrakt
06 / kód
Terminál, příkazy, karty, operace
Přepis zaznamenaný generátorem, strukturovaný blok výstupu, příkazy s tlačítky kopírování, pruh záložek ve třech podobách a operace čtené z vlastního popisu API.
started t-<id> profile=implementation scope=lib INFO handover .ai/local/state/handovers/<time>--main--<head>--<hash>.md — prior record, same_worktree_same_branch, exact, <age> ago [reproduce: majordomus handover --resolve] next: majordomus context; checkpoint every 15m; majordomus check before claiming anything
- rules
- 189
- rozhodnutí
- 158
- skills
- 8
- commands
- 31
Příkazy
Tlačítka kopírování se objeví, když skript běží; výpis se čte, nespouští
[
{
"about": "the first step of a sequence; the tone of the CLI, the files a repository holds",
"class": ".mj-tone--blue",
"dark": "oklch(70.7% 0.165 254.624)",
"light": "oklch(48.8% 0.243 264.376)",
"name": "blue"
},
{
"about": "the second step; the tone of the typed model and of the API",
"class": ".mj-tone--violet",
"dark": "oklch(70.2% 0.183 293.541)",
…-
majordomus context -
majordomus check -
majordomus brief
Brief relace
Jedna schopnost, tři povrchy
CLI
majordomus brief
HTTP
/api/v1/brief
curl -s "http://127.0.0.1:8741/api/v1/brief?session=00000000-0000-0000-0000-000000000000&checkouts=this&local=true"
MCP
majordomus_brief
Přehled
Přehledový panel segmentovaného pruhu.
Prozkoumat
Inspekční panel segmentovaného pruhu.
Spustit
Panel běhu segmentovaného pruhu.
Přehled
Panel přehledu pruhu štítků.
Prozkoumat
Inspekční panel pruhu pills.
Spustit
Panel běhu pruhu pills.
Operace
Operace briefu, z vlastního popisu API
GET/api/v1/briefBrief relace
Jeden řádek a několik dalších: epizoda a úloha této relace (ta, kterou vlastní daná relace poskytovatele, jinak ta ukazatele), peerové každé nástěnky s nástěnkami, které nešlo přečíst n…
07 / dashboard
Řídicí rovina, zobrazená
Okno s navigací, počty, řadou, tím, co se změnilo, a akcemi, které člověk provádí. Cockpit vykresluje spustitelný soubor; tyto jsou pro stránku, která ho popisuje.
Přehled repozitáře
z generovaného registru- Rules189
- Decisions158
- Tests567
- Features29
Changes in 1.0.0-alpha.1
Vrstva
- rules189
- rozhodnutí158
- tests567
- případy užití49
- Index ok
- Diagnostika čisté
08 / dokumentace
Stopa, hledání, obsah, tok
Části stránky dokumentace: kde je, jak najít jinou, co obsahuje a kroky prvního spuštění. Obsah na straně této stránky je komponenta obsahu, která označuje sekci, kterou právě čtete.
- Začínáme
Jak to funguje
- Přehled příkazů
-
1
Instalace
jeden archiv, jeho digest ověřen
-
curl -fsSL https://majordomus.dev/install.sh | sh
-
-
2
Dohlížet
zapisuje .ai/ a nic jiného
-
majordomus init
-
-
3
Projekt
každý bootstrap z politiky
-
majordomus update
-
-
4
Briefing
co repozitář už ví
-
majordomus context
-
09 / diagramy
Zásobník, vějíř a cyklus
Kreslí se z dat, která dostanou, bez skriptu: křivky vějíře se počítají z toho, kolik řádků má každá strana, a na telefonu se části skládají pod sebe se šipkou mezi nimi.
- .ai/politika, pravidla, prompty
- docs/rozhodnutí a příručky
- share/schémata a design
- test/cases/případy
share/design/tokens.yaml
jedna deklarace, čtená jako typovaný model
- paletasurové barvy
- rolesémantický povrch
- statuspět významů a jejich slova
- tónyodstíny pro identitu
- typografie · rozložení · pohybsdílená měření
- Příkazová řádkamajordomus
- HTTP API/api/v1/
- Swagger UI/swagger
- Cockpit/cockpit
- MCPmajordomus mcp
- Tento webGitHub Pages
S anotacemi
karta ukazuje na to, co popisuje
Přímé vodiče
jedna na kartu, ve výšce karty
# task id=t-<id> task=narrow the parser profile=implementation owner=<owner> scope.0=lib started_at=<time> checkpoint_at=<time> outcome=active repository_id=<repo>/.git worktree=<repo> branch=main head=<sha> working_tree=clean # profile implementation name=implementation description=build …
Jakýkoli střed
terminál, okno, zásobník
Skutečný výstup
tento přepis zaznamenal generátor
- Upravit tokens.yaml
- majordomus generate design
- design-check v CI
- Nosí ho každá plocha
Body na kartách
seznam vedle dashboardu
- Odvozenonic není registrováno ručně
- Seřazenopořadí deklarace na každém povrchu
- Změřenokaždý barevný pár proti WCAG 2.1 AA
10 / obrazovek
Obrazovky složené ze sady komponent
Celé stránky sestavené pouze z těchto komponent, z nichž každá vykresluje jeden z návrhů stránek z vlastních dat tohoto repozitáře.
- ArchitekturaJeden repozitář, mnoho rozhraní: co vrstva čte, model, který staví, a každý povrch z něj odvozený.
- Příkazová řádkaPříkazová řádka tak, jak ji kreslí design: příkazy nejvyšší úrovně čtené z generované reference, zaznamenaný běh a příklady, které reference dokumentuje.
- CockpitObraz Cockpitu, který majordomus obsluhuje na /cockpit: jeho oblasti, počty vrstvy, rozhodnutí na release, nejnovější změny a co je deklarováno, ze stejných dat.
- DokumentaceStránka dokumentace tak, jak ji kreslí design: kde jsou dokumenty, první čtyři příkazy dozorovaného repozitáře a briefing, který zaznamenal generátor.
- Klíčové funkceŠest povrchů kolem jednoho modelu: příkazová řádka, HTTP API, OpenAPI a Swagger UI, Cockpit, MCP a dokumentace, každý ukázaný s tím, co skutečně obsluhuje.
- Jak to fungujeOd repozitáře ke každému povrchu: objev, co repozitář deklaruje, sestav jeden typovaný index, odvoď každé rozhraní, ukaž na každém tytéž skutečnosti a co to přináší, jen s měřenými čísly.
- IntegraceJeden repozitář, každé rozhraní: co vrstva čte, snímek, který sestaví, a příkazová řádka, HTTP API, Swagger UI, Cockpit, MCP, tento web a CI, které jej čtou.
- ÚvodJeden repozitář, mnoho pohledů: co Majordomus objevuje, model, který sestavuje, povrchy, které odvozuje, a co z nich člověk získá.