Skills Architecture: Detailed Design¶

Every skill, where it runs, what it leaves in the repository and what picks it up. The studios write to the repository and the Wiki project reads from it: nothing passes from one project to another except through files.

Each project's folders sit directly below it. A folder that more than one project uses appears under each of them with a dashed outline: it is the same folder. Every wiki skill hands its result to wiki-publish, which writes docs/. The diagram is wider than the page: scroll sideways.

%%{init: {"flowchart": {"nodeSpacing": 22, "rankSpacing": 60, "padding": 10}, "themeVariables": {"fontSize": "16px"}}}%%
%% wb:fit 1.5
flowchart TB
    A(["You"])
    subgraph CSG["Cultures Studio project"]
        BD["bottle-dregs-analysis<br/>analysis, critique, measure,<br/>start journey, merge"]
        IRN["isolation-run<br/>start, update, consult, re-plan,<br/>hand-over, pick-up, milestone, close"]
    end
    subgraph IS["Ingredients Studio project"]
        R["ingredient-studio<br/>router and specialists"]
        M["ingredient-suite<br/>maintainer"]
    end
    subgraph WP["Wiki project"]
        TAS["wiki-tasting"]
        CAP["wiki-capture<br/>wiki-media"]
        INT["wiki-intake"]
        REL["wiki-release-skill"]
        GOV["wiki-rules, restructure,<br/>health, positioning"]
        PUB["wiki-publish"]
    end
    subgraph HO["Repository"]
        C_WK[("work/isolation-plans/")]
        C_DR[("inbox/drafts/")]
        C_BR[("work/beer-research/")]
        C_DOC[("docs/<br/>capability matrix")]
        I_DS[("designs/")]
        I_SK[("skills/, suite/<br/>ingredient skills")]
        I_IR[("inbox/raw/")]
        I_REL[("inbox/releases/")]
        W_BR[("work/beer-research/")]
        W_DR[("inbox/drafts/")]
        W_IR[("inbox/raw/")]
        W_REL[("inbox/releases/")]
        W_SK[("skills/<br/>culture skills")]
        W_DOC[("docs/, rules,<br/>skill zips")]
    end
    CF["Cloudflare<br/>live site"]
    A --> CSG
    A --> IS
    A --> WP
    IRN -- "readings, re-plans" --> BD
    R ~~~ M
    TAS ~~~ CAP ~~~ INT
    REL ~~~ GOV ~~~ PUB
    BD -- writes --> C_WK
    IRN -- writes --> C_WK
    BD -- "journey seed" --> C_DR
    IRN -- "update drafts" --> C_DR
    BD -. reads .-> C_BR
    BD -. reads .-> C_DOC
    R -- writes --> I_DS
    R -- "send to the wiki" --> I_IR
    M -. checks .-> I_SK
    M -- "suite:release" --> I_REL
    TAS -- writes --> W_BR
    CAP -. reads .-> W_DR
    INT -. reads .-> W_IR
    REL -. "Path A" .-> W_REL
    REL -. "Path B" .-> W_SK
    PUB -- writes --> W_DOC
    GOV -- writes --> W_DOC
    W_DOC -- "you commit, push" --> CF
    classDef shared stroke-dasharray: 5 3
    class C_DR,C_BR,C_DOC,I_IR,I_REL,W_BR,W_DR,W_IR,W_REL,W_DOC shared