@synap-core/workspace-templates 0.5.0 → 0.6.1

package/src/communication.yaml

@@ -0,0 +1,689 @@
+# Communication workspace template
+# Enterprise-OS reference "Communication" domain (Wave 1).
+# MERGES the Brand Library's brand kinds with the Foundation's narrative kinds:
+# Communication OWNS the brand + narrative ARTIFACTS (identity, voice, rules,
+# positioning, narrative, audience, differentiator) — the on-brand source every
+# downstream domain (Content, Marketing, Social) reads from. It does NOT own
+# company-DNA (mission/vision/values) nor relationship roles (client/partner).
+
+meta:
+  slug: communication
+  name: Communication
+  description: "Owns brand identity, voice, and narrative/positioning — the on-brand source of truth every downstream domain (Content, Marketing, Social) reads from so everything ships on-brand and on-message."
+  icon: messages-square
+  color: "#7C3AED"
+  tags: [communication, brand, narrative, voice, positioning]
+  isPublic: true
+
+workspace:
+  name: Communication
+  description: "Owns brand identity, voice, and narrative/positioning — the on-brand source of truth every downstream domain reads from."
+  subtype: communication
+  visibility: pod_visible
+  capabilities:
+    - brand.library
+    - brand.identity
+    - brand.voice
+    - brand.assets
+    - brand.templates
+    - brand.components
+    - narrative.positioning
+  # Communication CONSUMES brand and PROVIDES narrative.
+  #
+  # `brand: provider` here was a LIVE bug, not dead metadata. brand-library.yaml
+  # also declares `brand: provider`, and the IS reads this to pick which
+  # workspace supplies brand for EVERY agent's system prompt
+  # (`resolveWorkspaceForCapability` in agents/utils/context-manager.ts): it
+  # filters candidates by the `brand.library` capability, then takes the FIRST
+  # workspace whose sourceRoles.brand is a provider. With both installed, "first"
+  # is whatever order listWorkspaces returned — an arbitrary, non-deterministic
+  # brand voice across turns. brand-library is the canonical brand source (this
+  # file's brand profiles are, by its own admission below, verbatim from it);
+  # Communication is the narrative/voice layer that reads from it.
+  #
+  # Every other domain in this template set has exactly ONE provider and names
+  # its consumers (content-studio: `brand: consumer`; marketing: `brand: consumer`).
+  # `brand` was the only domain with two. This restores that invariant.
+  #
+  # Expressed as a source ROLE, not `defaultSources.brand`, because a
+  # TemplateDefaultSource requires a concrete `workspaceId` (types.ts) that does
+  # not exist until provisioning — a template cannot know it. finance.yaml makes
+  # the same call for `strategy` and says so. `defaultSources` remains the
+  # correct RUNTIME override (`synap_declare_workspace_source`).
+  #
+  # The `brand.library` capability above is deliberately KEPT: it is what the
+  # resolver filters candidates on, and it makes this workspace a graceful
+  # fallback (step 3) when brand-library is not installed — in which case the
+  # local brand profiles below are exactly what the agent should read.
+  sourceRoles:
+    brand: consumer
+    narrative: provider
+
+profiles:
+  # ═══════════════════════════════════════════════════════════════════════════
+  # BRAND KINDS — verbatim from brand-library.yaml
+  # ═══════════════════════════════════════════════════════════════════════════
+  - slug: brand-identity
+    displayName: Brand Identity
+    icon: fingerprint
+    color: amber
+    description: "Root brand context: positioning, audience, website, voice summary, and generation intent."
+    semanticSlug: brand.identity
+    properties:
+      - slug: brand-type
+        label: Brand type
+        valueType: string
+        inputType: select
+        enumValues: [product-digital, product-physical, agency, personal-brand, nonprofit, institutional, universal]
+        constraints: { defaultValue: universal }
+      - slug: brand-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, active, archived]
+        constraints: { defaultValue: active }
+      - slug: brand-tagline
+        label: Tagline
+        valueType: string
+        inputType: text
+      - slug: brand-website
+        label: Website
+        valueType: string
+        inputType: url
+      - slug: brand-industry
+        label: Industry
+        valueType: string
+        inputType: text
+      - slug: brand-positioning
+        label: Positioning
+        valueType: string
+        inputType: textarea
+      - slug: brand-audience-primary
+        label: Primary audience
+        valueType: string
+        inputType: textarea
+      - slug: brand-audience-secondary
+        label: Secondary audience
+        valueType: string
+        inputType: textarea
+      - slug: brand-voice-summary
+        label: Voice summary
+        valueType: string
+        inputType: textarea
+      - slug: brand-notes
+        label: Notes
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-color
+    displayName: Brand Color
+    icon: swatch-book
+    color: violet
+    description: Approved palette entry with semantic role, usage notes, and print references.
+    semanticSlug: brand.color
+    properties:
+      - slug: color-role
+        label: Role
+        valueType: string
+        inputType: select
+        enumValues: [primary, secondary, accent, background, surface, surface-elevated, text, text-muted, border, success, warning, error, info, neutral, campaign, custom]
+        constraints: { defaultValue: custom }
+      - slug: color-group
+        label: Group
+        valueType: string
+        inputType: select
+        enumValues: [core, extended, semantic, neutral, seasonal, campaign]
+        constraints: { defaultValue: core }
+      - slug: color-hex
+        label: Hex
+        valueType: string
+        inputType: color
+      - slug: color-rgb
+        label: RGB
+        valueType: string
+        inputType: text
+      - slug: color-cmyk
+        label: CMYK
+        valueType: string
+        inputType: text
+      - slug: color-pantone
+        label: Pantone
+        valueType: string
+        inputType: text
+      - slug: color-ral
+        label: RAL
+        valueType: string
+        inputType: text
+      - slug: color-token-name
+        label: Token name
+        valueType: string
+        inputType: text
+      - slug: color-usage
+        label: Usage note
+        valueType: string
+        inputType: textarea
+      - slug: color-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+
+  - slug: brand-font
+    displayName: Brand Typeface
+    icon: type
+    color: blue
+    description: Typeface with role, family, licensing, import URL, weights, and fallback stack.
+    semanticSlug: brand.font
+    properties:
+      - slug: font-role
+        label: Role
+        valueType: string
+        inputType: select
+        enumValues: [heading, body, display, mono, accent, ui, caption]
+        constraints: { defaultValue: body }
+      - slug: font-family
+        label: Family
+        valueType: string
+        inputType: text
+      - slug: font-foundry
+        label: Foundry
+        valueType: string
+        inputType: text
+      - slug: font-license
+        label: License
+        valueType: string
+        inputType: select
+        enumValues: [open-source, google-fonts, adobe-fonts, licensed, custom, system]
+        constraints: { defaultValue: google-fonts }
+      - slug: font-weights
+        label: Weights
+        valueType: string
+        inputType: text
+      - slug: font-fallback
+        label: Fallback stack
+        valueType: string
+        inputType: text
+      - slug: font-url
+        label: Import URL
+        valueType: string
+        inputType: url
+      - slug: font-document-id
+        label: Font document ID
+        valueType: string
+        inputType: text
+      - slug: font-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [active, draft, deprecated]
+        constraints: { defaultValue: active }
+
+  - slug: brand-asset
+    displayName: Brand Asset
+    icon: image
+    color: green
+    description: "Document-backed or URL-backed reusable media: logos, imagery, icons, fonts, video, references, and documents."
+    semanticSlug: brand.asset
+    properties:
+      - slug: asset-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [logo, wordmark, symbol, monogram, pattern, texture, icon-set, illustration, photo, video, document, font, 3d-model, print-ready, reference, other]
+      - slug: asset-variant
+        label: Variant
+        valueType: string
+        inputType: select
+        enumValues: [primary, secondary, horizontal, stacked, mono-dark, mono-light, white, reversed, favicon, social-avatar, og-image, other]
+      - slug: asset-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+      - slug: asset-usage
+        label: Usage notes
+        valueType: string
+        inputType: textarea
+      - slug: asset-tags
+        label: Tags
+        valueType: string
+        inputType: text
+      - slug: asset-url
+        label: External URL
+        valueType: string
+        inputType: url
+      - slug: asset-document-id
+        label: Document ID
+        valueType: string
+        inputType: text
+      - slug: asset-file-id
+        label: Legacy file ID
+        valueType: string
+        inputType: text
+      - slug: asset-alt-text
+        label: Alt text
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-reference
+    displayName: Brand Reference
+    icon: bookmark
+    color: teal
+    description: Website, competitor, campaign, moodboard, or example used as source context for generation.
+    semanticSlug: brand.reference
+    properties:
+      - slug: reference-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [website, competitor, campaign, moodboard, copy-example, design-example, customer-example, other]
+      - slug: reference-url
+        label: URL
+        valueType: string
+        inputType: url
+      - slug: reference-notes
+        label: Notes
+        valueType: string
+        inputType: textarea
+      - slug: reference-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, archived]
+        constraints: { defaultValue: approved }
+
+  - slug: brand-token-set
+    displayName: Token Set
+    icon: code-2
+    color: violet
+    description: Generated or curated design tokens for color, typography, spacing, radii, and exported CSS variables.
+    semanticSlug: brand.tokens
+    properties:
+      - slug: token-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, active, archived]
+        constraints: { defaultValue: active }
+      - slug: token-mode
+        label: Mode
+        valueType: string
+        inputType: select
+        enumValues: [base, light, dark, high-contrast, campaign, experimental]
+        constraints: { defaultValue: base }
+      - slug: token-source-ids
+        label: Source IDs
+        valueType: string
+        inputType: textarea
+      - slug: token-json
+        label: Tokens JSON
+        valueType: string
+        inputType: textarea
+      - slug: token-css
+        label: CSS variables
+        valueType: string
+        inputType: textarea
+      - slug: token-notes
+        label: Notes
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-voice-guide
+    displayName: Voice Guide
+    icon: message-circle
+    color: orange
+    description: "Generated or curated voice guidance by context: traits, tone, vocabulary, and copy examples."
+    semanticSlug: brand.voice
+    properties:
+      - slug: voice-context
+        label: Context
+        valueType: string
+        inputType: select
+        enumValues: [general, marketing, product, support, social, legal, editorial, investor]
+        constraints: { defaultValue: general }
+      - slug: voice-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+      - slug: voice-personality-traits
+        label: Personality
+        valueType: string
+        inputType: textarea
+      - slug: voice-tone-descriptors
+        label: Tone
+        valueType: string
+        inputType: text
+      - slug: voice-vocabulary
+        label: Vocabulary
+        valueType: string
+        inputType: textarea
+      - slug: voice-example-do
+        label: Do
+        valueType: string
+        inputType: textarea
+      - slug: voice-example-dont
+        label: Don't
+        valueType: string
+        inputType: textarea
+      - slug: voice-source-ids
+        label: Source IDs
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-rule
+    displayName: Brand Rule
+    icon: shield-check
+    color: red
+    description: Usage constraints, accessibility requirements, do/don't examples, and generation guidance.
+    semanticSlug: brand.rule
+    properties:
+      - slug: rule-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [visual, voice, legal, accessibility, sizing, clearance, color-usage, typography-usage, do, dont, generation, other]
+      - slug: rule-subject
+        label: Subject
+        valueType: string
+        inputType: select
+        enumValues: [logo, color, typography, pattern, asset, voice, general, digital, print, packaging]
+      - slug: rule-severity
+        label: Severity
+        valueType: string
+        inputType: select
+        enumValues: [guideline, important, mandatory]
+        constraints: { defaultValue: important }
+      - slug: rule-content
+        label: Rule
+        valueType: string
+        inputType: textarea
+      - slug: rule-example
+        label: Example
+        valueType: string
+        inputType: textarea
+      - slug: rule-source-ids
+        label: Source IDs
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-template
+    displayName: Brand Template
+    icon: layout-template
+    color: pink
+    description: Reusable output template for artboards, decks, carousels, banners, documents, or generated HTML.
+    semanticSlug: brand.template
+    properties:
+      - slug: template-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [artboard, deck, carousel, banner, document, html, social, other]
+      - slug: template-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+      - slug: template-format
+        label: Format
+        valueType: string
+        inputType: select
+        enumValues: [tldraw, html, json, markdown, image, mixed]
+      - slug: template-config
+        label: Config JSON
+        valueType: string
+        inputType: textarea
+      - slug: template-usage
+        label: Usage notes
+        valueType: string
+        inputType: textarea
+
+  - slug: brand-component
+    displayName: Brand Component
+    icon: component
+    color: green
+    description: "Reusable branded UI or content component: hero, CTA, card, quote, banner, section, or HTML snippet."
+    semanticSlug: brand.component
+    properties:
+      - slug: component-kind
+        label: Kind
+        valueType: string
+        inputType: select
+        enumValues: [hero, card, cta, quote, banner, section, layout, html, other]
+      - slug: component-status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, approved, deprecated]
+        constraints: { defaultValue: approved }
+      - slug: component-html
+        label: HTML
+        valueType: string
+        inputType: textarea
+      - slug: component-props
+        label: Props JSON
+        valueType: string
+        inputType: textarea
+      - slug: component-usage
+        label: Usage notes
+        valueType: string
+        inputType: textarea
+
+  # ═══════════════════════════════════════════════════════════════════════════
+  # NARRATIVE KINDS — verbatim from foundation.yaml
+  # (Communication owns the narrative ARTIFACTS: positioning, story arc,
+  #  audiences, and differentiators — NOT mission/vision/values.)
+  # ═══════════════════════════════════════════════════════════════════════════
+  - slug: positioning
+    displayName: Positioning
+    icon: crosshair
+    color: cyan
+    description: "Market category, who we stand against, and why we win."
+    properties:
+      - slug: category
+        label: Category
+        valueType: string
+        inputType: text
+      - slug: against
+        label: Against
+        valueType: string
+        inputType: textarea
+      - slug: because
+        label: Because
+        valueType: string
+        inputType: textarea
+
+  - slug: narrative
+    displayName: Narrative
+    icon: book-open
+    color: amber
+    description: "The origin -> insight -> mission story arc."
+    properties:
+      - slug: arc
+        label: Story arc
+        valueType: string
+        inputType: textarea
+      - slug: status
+        label: Status
+        valueType: string
+        inputType: select
+        enumValues: [draft, active, archived]
+        constraints: { defaultValue: active }
+
+  - slug: audience
+    displayName: Audience
+    icon: users
+    color: blue
+    description: "An ideal customer profile — who we are built for."
+    properties:
+      - slug: segment
+        label: Segment
+        valueType: string
+        inputType: text
+      - slug: persona
+        label: Persona
+        valueType: string
+        inputType: textarea
+      - slug: jobs-to-be-done
+        label: Jobs to be done
+        valueType: string
+        inputType: textarea
+      - slug: traits
+        label: Traits
+        valueType: array
+        inputType: text
+
+  - slug: differentiator
+    displayName: Differentiator
+    icon: sparkles
+    color: green
+    description: "One thing only we do, believe, or refuse."
+    properties:
+      - slug: statement
+        label: Statement
+        valueType: string
+        inputType: textarea
+      - slug: proof
+        label: Proof
+        valueType: string
+        inputType: textarea
+
+# CURATED views — not one per profile
+views:
+  - name: Brand Identity
+    slug: brand-identities
+    type: table
+    scopeProfileSlug: brand-identity
+    description: Root brand context and active identities.
+    defaultView: true
+  - name: Voice & Rules
+    slug: voice-rules
+    type: list
+    scopeProfileSlug: brand-voice-guide
+    description: Voice guides — tone, personality, vocabulary, and do/don't examples per context.
+  - name: Assets
+    slug: brand-assets
+    type: grid
+    scopeProfileSlug: brand-asset
+    description: Logos, media, documents, and visual references.
+  - name: Narrative
+    slug: narrative
+    type: table
+    scopeProfileSlug: positioning
+    description: Positioning, audiences, and the differentiators that anchor the message.
+
+onboarding:
+  goal: >
+    Capture the real brand and narrative — the visual + verbal identity, the
+    voice rules that keep everything on-brand, the sharp positioning, and who
+    it's aimed at — so every downstream domain (Content, Marketing, Social)
+    inherits one on-brand, on-message source of truth instead of guessing.
+  framing: >
+    THE BRAND & COMMS LEAD: Act as the person who owns how this company sounds and
+    what story it tells. You are protective of the voice and relentless about the
+    narrative. Push for a real, sharp positioning — a category and a wedge, not a
+    vague "we help companies with X" — and for documented voice rules (testable
+    do/don't pairs), never a pile of adjectives. Translate fuzzy vibes into
+    concrete voice guides, rules, and a positioning a stranger could repeat.
+  expertise:
+    starters:
+      - >
+        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
+        instead ("say 'you', not 'users'"; "short declaratives, never hedged
+        qualifiers"). Pairs are testable; adjectives are decoration.
+      - >
+        Positioning is sharpest as ONE sentence — "the <X> for <who>" or "the only
+        <category> that <wedge>". If they give you a vague "we help companies with
+        Y", propose a crisp category+wedge framing from what they've told you and
+        let them sharpen it — never file the vague version.
+      - >
+        A voice guide is only real if it survives a sentence test. Take one actual
+        line from their site or a competitor's and rewrite it in the proposed voice
+        on the spot — if the rewrite looks identical to the original, the voice isn't
+        differentiated yet. Push until the two versions are visibly different.
+    blindSpots:
+      - >
+        "Brand = logo" is the classic trap. The logo is the least-used, most-argued
+        asset; the voice, the positioning, and the do/don't rules drive 90% of what
+        anyone actually ships. If they lead with the logo, redirect to how the brand
+        SOUNDS and what story it tells in a paragraph of copy.
+      - >
+        Rules with no severity are ignored. A pile of equally-weighted "guidelines"
+        gives an AI or a teammate nothing to obey — mark each as mandatory,
+        important, or guideline so the non-negotiables (forbidden words, contrast,
+        clearspace) actually hold under pressure.
+      - >
+        Positioning that's really a feature list isn't positioning. If "why we win"
+        is a bullet list of capabilities, name it — push for the ONE wedge a
+        competitor can't easily claim, tied to a specific audience.
+    bar: >
+      A stranger handed the voice pairs, the positioning sentence, and the audience
+      could write a new paragraph that reads unmistakably as THIS brand AND explain
+      who it's for and why it wins — every voice rule testable on a real sentence,
+      the positioning repeatable in one breath.
+  collect:
+    - profileSlug: brand-voice-guide
+      what: Voice guides — tone, personality traits, vocabulary, and do/don't examples per context.
+      cardinality: few
+      keyFields: [voice-personality-traits, voice-tone-descriptors, voice-example-do, voice-example-dont]
+    - profileSlug: brand-rule
+      what: Usage and voice rules (mandatory / important / guideline).
+      cardinality: several
+      keyFields: [rule-kind, rule-severity, rule-content]
+    - profileSlug: positioning
+      what: The market category, who we stand against, and why we win.
+      cardinality: few
+      keyFields: [category, against, because]
+    - profileSlug: audience
+      what: The ideal audiences the message is aimed at.
+      cardinality: several
+      keyFields: [segment, jobs-to-be-done]
+  openingQuestions:
+    - "In three words, how should the brand sound — and what's one thing it must never say?"
+    - "Who's the message aimed at — which audience does the brand talk to first?"
+    - "In one sentence — what category are you in, and why do you win it?"
+  doneWhen: at least one voice guide + one positioning + one audience captured.
+
+# App reference — no custom app for communication
+app:
+  kind: stored
+  cellKey: entity-detail
+
+# Layout config for browser sidebar
+layout:
+  pinnedApps: [dashboard, data]
+  defaultView: Brand Identity
+  defaultApp: null
+  sidebarItems:
+    - kind: view
+      viewName: Brand Identity
+      label: Brand Identity
+      icon: fingerprint
+    - kind: view
+      viewName: Voice & Rules
+      label: Voice & Rules
+      icon: message-circle
+    - kind: view
+      viewName: Assets
+      label: Assets
+      icon: image
+    - kind: view
+      viewName: Narrative
+      label: Narrative
+      icon: crosshair
+
+# Bento dashboard
+bento:
+  viewName: Brand Identity
+  blocks:
+    - kind: view
+      viewName: Voice & Rules
+      pos: { x: 0, y: 0, w: 6, h: 5 }
+    - kind: view
+      viewName: Narrative
+      pos: { x: 6, y: 0, w: 6, h: 5 }