DECK

Purpose

DECK is the artifact. DEAL is the relationship. A DECK is what you present — a DEAL is who you’re working with.

Every pitch deck, investor slide, and visual narrative is a published artifact — authored in markdown, compiled through the MAGIC pipeline, and surfaced on the governed frontend. DECK is a SHOP-gated publishing lane. The content is public (or auth-gated if PRIVATE). It gets read, explored, and shared.

DECK ≠ DEAL. A DECK is a presentation you bring to a meeting. A DEAL is the ongoing engagement with the person in that meeting. The HOWARD deck is the slide deck presented at Howard University. The HOWARD deal tracks the full relationship — meetings, follow-ups, contracts. One deal may involve many decks. The deck is frozen at publication. The deal is alive until it closes.

Structure

Leaf SERVICE scope. No governed child scopes. Deck content lives in {USER}/DECKS/ (instance scope, SHOP.md projection). Instance follows the Instance Pattern at {USER}/DECKS/.

Required closure artifacts per scope: CANON.md, README.md, DECK.md, VOCAB.md, ROADMAP.md, COVERAGE.md, LEARNING.md.

Learning lane per governed scope: LEARNING.md at the scope root is terminal and SHALL NOT nest further LEARNING/.

Routes

web_docs:    https://hadleylab-canonic.github.io/
web_surface: https://hadleylab-canonic.github.io/SERVICES/DECK/
web_app:     https://hadleylab-canonic.github.io/DECKS/
magic:       magic://hadleylab-canonic.github.io/DECKS/

Publishing Contract

1. Author writes {DECK}.md in {USER}/DECKS/{NAME}/
2. Front matter declares: title, date, scope, audience, slide_count
3. Build pipeline compiles to governed HTML slides
4. SHOP.md projection emits public-safe metadata (title, date, audience, slide count)
5. Full deck available at DECKS/{NAME}/ surface (auth-gated if PRIVATE)
6. Published artifacts are deterministic — same source = same output

Export Contract

Decks export to two offline formats via governed scripts:

Export outputs declared in front matter:

downloads:
  - label: "PDF"
    href: /DECKS/{NAME}/{NAME}.pdf
    icon: "↓"
  - label: "PPTX"
    href: /DECKS/{NAME}/{NAME}.pptx
    icon: "↓"

DECK.html renders download buttons when page.downloads is present.

Ecosystem Connectivity

1. Upstream: SERVICES governance contracts and DEXTER scope inheritance.
2. Runtime: Jekyll compilation via remote_theme — governed markdown to visual slide HTML.
3. Frontend: DECKS/ surface compiled to governed SPA route. SHOP-safe entries in catalog.
4. Ledger plane: publish events ledgered (author, title, audience, slide count, commit hash).

Pages

Default: Overview.

Instance Pattern

{USER}/DECKS/
  DECKS.md       <- instance spec
  CANON.md       <- scope governance
  SHOP.md        <- public projection
  COVERAGE.md    <- compliance
  LEARNING.md    <- learning trail
  README.md      <- scope readme
  ROADMAP.md     <- scope roadmap
  VOCAB.md       <- scope vocabulary