@synap-core/workspace-templates 0.12.0 → 0.23.0

package/src/brand-library.yaml

@@ -11,6 +11,9 @@ meta:
   color: "#B67A38"
   tags: [brand, assets, tokens, templates, components, creative]
   isPublic: true
+  # A LIBRARY: it produces nothing a home counts (homes).
+  intent:
+    label: Brand
 
 workspace:
   name: Brand Library
@@ -36,6 +39,16 @@ profiles:
     color: amber
     description: "Root brand context: positioning, audience, website, voice summary, and generation intent."
     semanticSlug: brand.identity
+    # The ONE lifecycle (work model L1): every option's category.
+    lifecycle:
+      property: brand-status
+      options:
+        - { key: draft, category: open }
+        - { key: active, category: done }
+        - { key: archived, category: lost }
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: document
     properties:
       - slug: brand-type
         label: Brand type
@@ -58,6 +71,12 @@ profiles:
         inputType: select
         enumValues: [draft, active, archived]
         constraints: { defaultValue: active }
+      - slug: default-brand
+        label: Default brand
+        description: Used when no project is selected.
+        valueType: boolean
+        inputType: checkbox
+        constraints: { defaultValue: false }
       - slug: brand-tagline
         label: Tagline
         valueType: string
@@ -97,6 +116,13 @@ profiles:
     color: violet
     description: Approved palette entry with semantic role, usage notes, and print references.
     semanticSlug: brand.color
+    # The ONE lifecycle (work model L1): the asset base without its review
+    # step (lifecycle-presets.ts). The compiler writes the options and the
+    # select's enumValues.
+    lifecycle:
+      property: color-status
+      adopts: asset
+      drop: [in-review]
     properties:
       - slug: color-role
         label: Role
@@ -160,7 +186,6 @@ profiles:
         label: Status
         valueType: string
         inputType: select
-        enumValues: [draft, approved, deprecated]
         constraints: { defaultValue: approved }
 
   - slug: brand-font
@@ -169,6 +194,18 @@ profiles:
     color: blue
     description: Typeface with role, family, licensing, import URL, weights, and fallback stack.
     semanticSlug: brand.font
+    # The ONE lifecycle (work model L1): every option's category.
+    lifecycle:
+      property: font-status
+      options:
+        - { key: active, category: done }
+        - { key: draft, category: open }
+        - { key: deprecated, category: lost }
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: media
+      media:
+        source: { property: font-document-id }
     properties:
       - slug: font-role
         label: Role
@@ -220,6 +257,23 @@ profiles:
     color: green
     description: "Document-backed or URL-backed reusable media: logos, imagery, icons, fonts, video, references, and documents."
     semanticSlug: brand.asset
+    # The ONE lifecycle (work model L1): the asset base without its review
+    # step; deprecating an asset is a person's call (lifecycle-presets.ts).
+    lifecycle:
+      property: asset-status
+      adopts: asset
+      drop: [in-review]
+      humanOnly: { deprecated: true }
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    # The picture: an upload (asset-document-id — both upload doors write it),
+    # else an external URL (asset-url — add-by-URL, the edit form): a link
+    # until the pod copies it, never a hot-linked image.
+    presentation:
+      family: media
+      media:
+        source: { property: asset-document-id }
+        fallbacks:
+          - { property: asset-url }
     properties:
       - slug: asset-kind
         label: Kind
@@ -236,7 +290,9 @@ profiles:
             icon-set,
             illustration,
             photo,
+            image,
             video,
+            audio,
             document,
             font,
             3d-model,
@@ -267,12 +323,68 @@ profiles:
         label: Status
         valueType: string
         inputType: select
-        enumValues: [draft, approved, deprecated]
-        constraints: { defaultValue: approved }
+        constraints: { defaultValue: draft }
+      - slug: asset-style
+        label: Style
+        valueType: string
+        inputType: select
+        enumValues: [on-white, on-dark, organic, editorial, technical, generative, cinematic, playful, bold, other]
       - slug: asset-usage
         label: Usage notes
         valueType: string
         inputType: textarea
+      # ── Inspiration → variation → Canva loop ──────────────────────────────
+      # An inspiration is an asset like any other: it keeps WHERE it came from
+      # and, when it is AI-made, the prompt that produced it — so any AI that
+      # reads the library can ask for "another version" without guessing.
+      - slug: asset-role
+        label: Role
+        description: Where this sits in the loop. Inspiration = something we admire; working = a draft we are iterating; final = approved output.
+        valueType: string
+        inputType: select
+        enumValues: [inspiration, working, final]
+      - slug: asset-origin
+        label: Made by
+        description: Who made it. Say unknown rather than guess.
+        valueType: string
+        inputType: select
+        enumValues: [human, ai-generated, mixed, unknown]
+      - slug: asset-source-url
+        label: Found at
+        description: The page or post where we found it (provenance). The file itself goes in External URL or Document ID.
+        valueType: string
+        inputType: url
+      - slug: asset-generator
+        label: Generator
+        description: AI model or tool that made it (e.g. Midjourney, Flux, GPT Image). Only if known.
+        valueType: string
+        inputType: text
+      - slug: asset-prompt
+        label: Prompt
+        description: The exact prompt behind an AI-made image, verbatim. Never reconstruct or paraphrase one.
+        valueType: string
+        inputType: textarea
+      - slug: asset-prompt-status
+        label: Prompt status
+        description: Lets an AI tell "no prompt" from "prompt not found yet".
+        valueType: string
+        inputType: select
+        enumValues: [known, not-found, not-applicable]
+      - slug: asset-generation-params
+        label: Generation settings
+        description: Seed, aspect ratio, negative prompt, reference images, model version — whatever is needed to reproduce it.
+        valueType: string
+        inputType: textarea
+      - slug: asset-canva-id
+        label: Canva ID
+        description: Canva asset or design ID once this has been sent to Canva.
+        valueType: string
+        inputType: text
+      - slug: asset-canva-url
+        label: Canva link
+        description: Edit link of the Canva design or asset.
+        valueType: string
+        inputType: url
       - slug: asset-tags
         label: Tags
         valueType: string
@@ -300,6 +412,18 @@ profiles:
     color: teal
     description: Website, competitor, campaign, moodboard, or example used as source context for generation.
     semanticSlug: brand.reference
+    # The ONE lifecycle (work model L1): the asset base (lifecycle-presets.ts).
+    # Its review step is `studied` (2026-10-12): the takeaways are written, a
+    # person has not approved it as a source yet.
+    lifecycle:
+      property: reference-status
+      adopts: asset
+      rename: { in-review: studied, deprecated: archived }
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: link
+      media:
+        source: { property: reference-url }
     properties:
       - slug: reference-kind
         label: Kind
@@ -328,8 +452,29 @@ profiles:
         label: Status
         valueType: string
         inputType: select
-        enumValues: [draft, approved, archived]
-        constraints: { defaultValue: approved }
+        constraints: { defaultValue: draft }
+      - slug: reference-style
+        label: Style
+        valueType: string
+        inputType: select
+        enumValues: [on-white, on-dark, organic, editorial, technical, generative, cinematic, playful, bold, other]
+      # What a study of the reference keeps. Content guidelines are distilled
+      # from these (guideline → reference, `derived_from`).
+      - slug: reference-takeaways
+        label: What to take
+        description: What to borrow from it — layout, elements, voice, pacing.
+        valueType: string
+        inputType: textarea
+      - slug: reference-avoid
+        label: What to avoid
+        valueType: string
+        inputType: textarea
+      - slug: reference-formats
+        label: Formats
+        description: The content formats this reference is an example of.
+        valueType: array
+        inputType: select
+        enumValues: [carousel, deck, video-motion, video-face, image, text]
 
   - slug: brand-token-set
     displayName: Token Set
@@ -337,6 +482,13 @@ profiles:
     color: violet
     description: Generated or curated design tokens for color, typography, spacing, radii, and exported CSS variables.
     semanticSlug: brand.tokens
+    # The ONE lifecycle (work model L1): every option's category.
+    lifecycle:
+      property: token-status
+      options:
+        - { key: draft, category: open }
+        - { key: active, category: done }
+        - { key: archived, category: lost }
     properties:
       - slug: token-status
         label: Status
@@ -373,6 +525,13 @@ profiles:
     color: orange
     description: "Generated or curated voice guidance by context: traits, tone, vocabulary, and copy examples."
     semanticSlug: brand.voice
+    # The ONE lifecycle (work model L1): every option's category.
+    lifecycle:
+      property: voice-status
+      options:
+        - { key: draft, category: open }
+        - { key: approved, category: done }
+        - { key: deprecated, category: lost, humanOnly: true }
     properties:
       - slug: voice-context
         label: Context
@@ -395,7 +554,9 @@ profiles:
         valueType: string
         inputType: select
         enumValues: [draft, approved, deprecated]
-        constraints: { defaultValue: approved }
+        # A new guide is a draft until a person approves it (founder decision
+        # 2026-10-12): content is only checked against an approved voice.
+        constraints: { defaultValue: draft }
       - slug: voice-personality-traits
         label: Personality
         valueType: string
@@ -483,30 +644,55 @@ profiles:
         valueType: string
         inputType: textarea
 
+  # `scope: shared` — the ONE pod-wide template kind (plan D6): Content OS
+  # re-declares it to get the grant, instead of owning a `content-template`
+  # twin (retired by the w11.content.template-* manifest ops). Shares the
+  # DEFINITION, not the entities — no `entityScope: pod`, so each brand
+  # workspace's templates stay its own.
   - slug: brand-template
     displayName: Brand Template
     icon: layout-template
     color: pink
-    description: Reusable output template for artboards, decks, carousels, banners, documents, or generated HTML.
+    description: Reusable output template for artboards, decks, carousels, banners, documents, video, or generated HTML.
     semanticSlug: brand.template
+    scope: shared
+    # The ONE lifecycle (work model L1): every option's category.
+    lifecycle:
+      property: template-status
+      options:
+        - { key: draft, category: open }
+        - { key: approved, category: done }
+        - { key: deprecated, category: lost }
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: document
     properties:
       - slug: template-kind
         label: Kind
         valueType: string
         inputType: select
         enumValues:
-          [artboard, deck, carousel, banner, document, html, social, other]
+          [artboard, deck, carousel, banner, document, html, social, video, other]
       - slug: template-status
         label: Status
         valueType: string
         inputType: select
         enumValues: [draft, approved, deprecated]
-        constraints: { defaultValue: approved }
+        constraints: { defaultValue: draft }
+      - slug: template-style
+        label: Style
+        valueType: string
+        inputType: select
+        enumValues: [on-white, on-dark, organic, editorial, technical, generative, cinematic, playful, bold, other]
+      # `layered` = a carousel / image built as a layered composition in the
+      # pod, `open-design` = a deck or PDF document built in Open Design: the
+      # words content-os `render-engine` uses (static edit loop, founder D1,
+      # 2 Nov 2026). Additive only: the reconciler never drops a value.
       - slug: template-format
         label: Format
         valueType: string
         inputType: select
-        enumValues: [tldraw, html, json, markdown, image, mixed]
+        enumValues: [tldraw, html, json, markdown, image, mixed, hyperframes, layered, open-design]
       - slug: template-config
         label: Config JSON
         valueType: string
@@ -515,6 +701,32 @@ profiles:
         label: Usage notes
         valueType: string
         inputType: textarea
+      # ── Folded in from content-studio's `production-recipe` (decision D2,
+      # 2026-10-12): a recipe was a template with a platform and a script. Same
+      # values as recipe-platform / recipe-mode / recipe-script / recipe-stages.
+      - slug: template-platform
+        label: Platform
+        valueType: string
+        inputType: select
+        enumValues: [instagram, tiktok, youtube, linkedin, x, all]
+      - slug: template-mode
+        label: Render mode
+        valueType: string
+        inputType: select
+        enumValues: [fast, quality, data]
+      - slug: template-script
+        label: Script
+        valueType: string
+        inputType: textarea
+      - slug: template-stages
+        label: Stages
+        valueType: string
+        inputType: textarea
+      - slug: template-slots
+        label: Slots JSON
+        description: 'What a piece made from this template fills in: [{"slot", "component", "need": required|recommended|optional, "where"}].'
+        valueType: string
+        inputType: textarea
 
   - slug: brand-component
     displayName: Brand Component
@@ -522,6 +734,13 @@ profiles:
     color: green
     description: "Reusable branded UI or content component: hero, CTA, card, quote, banner, section, or HTML snippet."
     semanticSlug: brand.component
+    # The ONE lifecycle (work model L1): every option's category.
+    lifecycle:
+      property: component-status
+      options:
+        - { key: draft, category: open }
+        - { key: approved, category: done }
+        - { key: deprecated, category: lost }
     properties:
       - slug: component-kind
         label: Kind
@@ -548,6 +767,57 @@ profiles:
         valueType: string
         inputType: textarea
 
+  # How this brand makes content, distilled from approved references (decision
+  # D3, 2026-10-12). `base` = holds for everything; `format` = one format
+  # (carousel, video…); `frame` = the structure for one goal (sell, tutorial…).
+  # The long body is the entity's document. Workspace-scoped like brand-rule and
+  # brand-voice-guide: other spaces READ it through the pod-visible Brand space.
+  - slug: content-guideline
+    displayName: Content Guideline
+    icon: book-open-check
+    color: amber
+    description: "How this brand makes content: a base guideline, a format guideline, or the frame for one goal — distilled from approved references."
+    semanticSlug: brand.content-guideline
+    # The ONE lifecycle (work model L1): every option's category.
+    lifecycle:
+      property: guideline-status
+      options:
+        - { key: draft, category: open }
+        - { key: approved, category: done }
+        - { key: deprecated, category: lost, humanOnly: true }
+    # How it renders (entity rendering, decision 8): @synap-core/types/presentation.
+    presentation:
+      family: document
+    properties:
+      - slug: guideline-type
+        label: Type
+        valueType: string
+        inputType: select
+        enumValues: [base, format, frame]
+        constraints: { defaultValue: base }
+      - slug: guideline-format
+        label: Format
+        valueType: string
+        inputType: select
+        enumValues: [any, carousel, deck, video-motion, video-face, image, text, thread, newsletter]
+        constraints: { defaultValue: any }
+      - slug: guideline-goal
+        label: Goal
+        description: Only for a frame guideline — the goal this structure serves.
+        valueType: string
+        inputType: select
+        enumValues: [sell, hot-take, tutorial, product-demo, announcement, proof, behind-the-scenes, community]
+      - slug: guideline-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: draft }
+      - slug: guideline-summary
+        label: Summary
+        valueType: string
+        inputType: textarea
+
 views:
   - name: Brand Identity
     slug: brand-identities
@@ -600,6 +870,11 @@ views:
     type: grid
     scopeProfileSlug: brand-component
     description: Reusable branded blocks and snippets.
+  - name: Content Guidelines
+    slug: content-guidelines
+    type: list
+    scopeProfileSlug: content-guideline
+    description: Base, format and goal-frame guidelines for making content.
 
 entityLinks:
   - sourceProfileSlug: brand-token-set
@@ -614,13 +889,45 @@ entityLinks:
     targetProfileSlug: brand-asset
     type: references
     label: References asset
+  # A variation points at the asset it was made from (child → parent). Same
+  # edge for "AI version of an inspiration" and "Canva export of a draft".
+  - sourceProfileSlug: brand-asset
+    targetProfileSlug: brand-asset
+    type: derived_from
+    label: Variation of
+  - sourceProfileSlug: brand-asset
+    targetProfileSlug: brand-reference
+    type: references
+    label: Found in reference
   - sourceProfileSlug: brand-template
     targetProfileSlug: brand-token-set
     type: uses
     label: Uses token set
+  - sourceProfileSlug: content-guideline
+    targetProfileSlug: brand-reference
+    type: derived_from
+    label: Distilled from
 
 onboarding:
-  goal: Capture the brand's expressive DNA — voice, visual identity, and the rules that keep everything on-brand — so any human or AI can generate on-brand content and assets.
+  purpose: >-
+    The brand's source of truth. Before writing copy or generating an asset,
+    read the brand identity, the voice guides and the mandatory rules here;
+    store brand assets, colors, fonts and token sets as their own typed kinds,
+    never as generic files.
+  anchors:
+    - profileSlug: brand-identity
+      role: root
+      limit: 10
+    - profileSlug: brand-rule
+      role: context
+      limit: 10
+    - profileSlug: brand-voice-guide
+      role: context
+      limit: 3
+    - profileSlug: content-guideline
+      role: context
+      limit: 5
+  goal: One brand identity per project, filed into that project (the Brand space is shared; the project picks the brand). Capture each brand's expressive DNA — voice, visual identity, and the rules that keep everything on-brand — so any human or AI can generate on-brand content and assets.
   framing: >
     THE BRAND STRATEGIST: Act as a seasoned brand strategist. Draw out how the
     brand sounds (tone, personality, do's and don'ts), how it looks (identity,
@@ -629,6 +936,11 @@ onboarding:
     positioning) so the brand expresses the strategy, never contradicts it.
   expertise:
     starters:
+      - >
+        A post that sells follows a frame, not a pitch: Story (a real moment),
+        Example (what it looked like in practice), Lesson (what that taught),
+        Link (where to go next). Propose it as the brand's first frame guideline
+        for the `sell` goal, then test it on one real post before approving.
       - >
         Adjectives don't define a voice — "friendly, bold, human" describes every
         brand and constrains none. Propose voice as a small set of DO / DON'T pairs
@@ -660,17 +972,25 @@ onboarding:
         AA on text is off-brand the moment it's inaccessible. If they've picked
         colors without checking text-on-surface contrast, flag it before it's
         codified into tokens.
+      - >
+        Inspiration without distillation. A wall of saved references teaches an
+        AI nothing it can follow. Each reference only counts once its takeaways
+        and what to avoid are written down, and those become a guideline a person
+        approves. Until then it is a bookmark.
     bar: >
       A stranger handed the voice pairs, the color roles, and the rules could write a
       new paragraph and pick a button color that both read unmistakably as THIS brand —
       and every rule is testable on a real sentence or a real screen, not a vibe.
   collect:
     - profileSlug: brand-identity
-      what: The core brand identity — name, essence, and how it presents itself.
-      cardinality: one
+      what: One brand identity per project — name, essence, and how it presents itself — filed into its project. Mark one as the default brand when several exist.
+      cardinality: few
+      min: 1
+      keyFields: [brand-positioning, brand-audience-primary]
     - profileSlug: brand-voice-guide
       what: Voice guides — tone, personality traits, vocabulary, and do/don't examples per context.
       cardinality: few
+      min: 1
       keyFields:
         [
           voice-personality-traits,
@@ -681,17 +1001,87 @@ onboarding:
     - profileSlug: brand-rule
       what: Usage rules and constraints (mandatory / important / guideline).
       cardinality: several
+      min: 1
+      keyFields: [rule-content]
     - profileSlug: brand-color
       what: The brand's core colors.
       cardinality: few
     - profileSlug: brand-font
       what: The brand's typefaces (heading / body / mono).
       cardinality: few
+    - profileSlug: brand-reference
+      what: At least three references a person has approved, each with what to take from it and what to avoid.
+      cardinality: several
+      min: 3
+      keyFields: [reference-url, reference-takeaways, reference-avoid]
+    - profileSlug: content-guideline
+      what: An approved base guideline (how all of this brand's content is made), then a format or frame guideline when one is needed.
+      cardinality: few
+      min: 1
+      keyFields: [guideline-type, guideline-summary]
+    - profileSlug: brand-template
+      what: At least one approved template for each format the brand publishes, with its slots.
+      cardinality: few
+      min: 1
+      keyFields: [template-kind, template-slots]
   openingQuestions:
     - In three words, how should the brand sound?
     - What's one thing the brand must never say or do?
     - Who's the brand talking to (tie this back to your Foundation audience)?
-  doneWhen: A brand identity + at least one voice guide + a few rules are captured.
+  doneWhen: >-
+    Ready for content: a brand identity, an approved voice guide, the rules, at
+    least three approved references, an approved base content guideline, and at
+    least one approved template for each format the brand publishes.
+
+rules:
+  - key: brand-approved-assets-first
+    intent: >-
+      When generating brand content or an asset, use only APPROVED brand
+      assets, references and templates plus the active token set; a draft is a
+      candidate the user has not validated yet and never feeds generation.
+      Match the piece's style to their Style field. Create new variants only
+      when the user explicitly asks for exploration, and load the
+      creative-director skill (linked to this space) to route the ask.
+  - key: brand-read-before-generating
+    intent: >-
+      Before writing copy or generating an asset for this brand, read its brand
+      identity, voice guides and mandatory brand rules in the Brand Library, and
+      follow them.
+  - key: brand-store-typed
+    intent: >-
+      Store brand material as its own Brand Library kind (brand-asset,
+      brand-color, brand-font, brand-token-set, brand-rule, brand-reference,
+      content-guideline), never as a generic file or note.
+
+skills:
+  # The space DECLARES what its work needs, so every AI here is told the skill
+  # exists and finds it first — instead of the rule above having to ASK for it in
+  # prose, which a model may or may not honour. `on-demand`: the Brand space is a
+  # reference space, so the director loads when the work calls for it.
+  #
+  # A REF, not a copy: the skill itself ships as its own package
+  # (`skills/creative-director.skill.json`), installed via the `dependencies`
+  # block below. This is the LINK; that is the INSTALL.
+  - slug: creative-director
+    when: Any content ask about this brand — carousel, deck, video, text
+    mode: on-demand
+  - slug: content-taste
+    when: Studying inspiration, writing content guidelines, building the asset kit
+    mode: on-demand
+
+dependencies:
+  # Bottom-up authoring: the small standalone piece is published first, then the
+  # spaces that need it declare it. Resolved BEFORE the skills linker runs
+  # (dependencies are Step 0 of materialization; the linker runs post-workspace),
+  # so a freshly installed skill links instead of reporting `unresolved`.
+  - slug: creative-director
+    kind: skill
+    relation: require
+    reason: "Routes every content ask to this brand's approved recipes, references and assets."
+  - slug: content-taste
+    kind: skill
+    relation: require
+    reason: "Turns references into approved guidelines and the asset kit content is made from."
 
 app:
   kind: native
@@ -764,3 +1154,124 @@ bento:
     - kind: view
       viewName: Templates
       pos: { x: 6, y: 8, w: 6, h: 4 }
+
+playbooks:
+  - name: Make a brand asset
+    description: Turn a request for a logo, image, icon or template into a draft built from the approved brand, and approve it with a person before anything uses it.
+    goalTemplate: >-
+      Make this brand asset ({asset}); each stage moves its status. DRAFT: read
+      the request and the approved brand only — approved colours, fonts,
+      references and the active token set; never a draft — and load the
+      creative-director skill to pick the recipe. Make the draft (or up to
+      three variants, each its own asset derived from this one) and record the
+      generator, prompt and parameters on it. APPROVE: a person approves one
+      draft as final; with variants, the approval asks them to `choose` one,
+      your recommendation first, and that choice is the approval. Until then
+      nothing may use it.
+      Deprecating an asset is a person's call.
+    subjectProfile:
+      profileSlug: brand-asset
+      statusProperty: asset-status
+    humanOnlyStatuses: [deprecated]
+    params:
+      - { name: asset, type: entity, label: Brand asset, required: true }
+    executor: is-agent
+    status: active
+    requiredIntents: [generate_media]
+    expectedOutputs:
+      - { kind: brand-asset, label: Variants, relationToSubject: derived_from }
+    stages:
+      - key: draft
+        name: Draft
+        category: started
+        subjectStatus: draft
+        goal: Build the draft from approved brand sources only and record how it was made.
+        criteria:
+          - key: asset-approved-sources
+            statement: The draft was built only from approved colours, fonts, references and the active token set.
+            check: { kind: judge }
+          - key: asset-provenance
+            statement: The asset records its generator, prompt and parameters, or says it was made by hand.
+            check: { kind: judge }
+      - key: approve
+        name: Approve
+        category: completed
+        subjectStatus: approved
+        goal: A person approves one draft as final; with variants, they choose one, recommended first.
+        gate: { kind: human }
+        onFail: { toStage: draft }
+
+  - name: Write the brand voice
+    description: Draft or revise the brand voice guide from what the brand already publishes, and approve it with a person.
+    goalTemplate: >-
+      Write this brand voice guide ({guide}); each stage moves its status.
+      DRAFT: read the brand identity, the approved assets and the last posts
+      and emails the brand published; write the voice in a few traits, each
+      with a do and a don't taken from real examples, and the words to use and
+      avoid. APPROVE: a person approves the guide; then it is what every draft
+      is checked against. Retiring a guide is a person's call.
+    subjectProfile:
+      profileSlug: brand-voice-guide
+      statusProperty: voice-status
+    humanOnlyStatuses: [deprecated]
+    params:
+      - { name: guide, type: entity, label: Brand voice guide, required: true }
+    executor: is-agent
+    status: active
+    stages:
+      - key: draft
+        name: Draft
+        category: started
+        subjectStatus: draft
+        goal: Write the voice traits with real do and don't examples, and the words to use and avoid.
+        criteria:
+          - key: voice-examples
+            statement: Every voice trait has a do and a don't example taken from published material.
+            check: { kind: judge }
+      - key: approve
+        name: Approve
+        category: completed
+        subjectStatus: approved
+        goal: A person approves the guide.
+        gate: { kind: human }
+        onFail: { toStage: draft }
+
+  - name: Write a content guideline
+    description: Distil approved references into a content guideline (base, format or the frame for one goal), and approve it with a person.
+    goalTemplate: >-
+      Write this content guideline ({guideline}); each stage moves its status.
+      DRAFT: read the brand identity, the approved voice guide and the approved
+      references; load the content-taste skill. Write what to take and what to
+      avoid as rules a maker can follow, link the guideline to every reference
+      it was distilled from, and fill the summary. For a frame guideline, set
+      the goal and give the structure in order. APPROVE: a person approves the
+      guideline; then content is made and checked against it. Retiring a
+      guideline is a person's call.
+    subjectProfile:
+      profileSlug: content-guideline
+      statusProperty: guideline-status
+    humanOnlyStatuses: [deprecated]
+    params:
+      - { name: guideline, type: entity, label: Content guideline, required: true }
+    executor: is-agent
+    status: active
+    stages:
+      - key: draft
+        name: Draft
+        category: started
+        subjectStatus: draft
+        goal: Distil the approved references into rules a maker can follow, linked to their sources.
+        criteria:
+          - key: guideline-sources
+            statement: The guideline is linked to at least one approved reference it was distilled from.
+            check: { kind: judge }
+          - key: guideline-followable
+            statement: Every point says what to do or avoid concretely enough to check a draft against it.
+            check: { kind: judge }
+      - key: approve
+        name: Approve
+        category: completed
+        subjectStatus: approved
+        goal: A person approves the guideline.
+        gate: { kind: human }
+        onFail: { toStage: draft }