Axiom

DEAL governs relationships. Every deal ledgered. Every stage evidenced.

Constraints

MUST:     Ledger all deal events
MUST:     Link to governed contacts
MUST:     Evidence every stage transition
MUST:     Every child instance at DEALS/ inherits these constraints
MUST:     Instance trees carry all state (CANON, INTEL, LEARNING, COVERAGE, ROADMAP, VOCAB)
MUST NOT: Store secrets in public surfaces
MUST NOT: Hardcode deal names in law
MUST NOT: Nest instance directories under SERVICES/DEAL/ (service contract is the class, not the instance)

Capabilities

CONTACT_LINK, DEAL_LEDGER, EVIDENCE_CHAIN, STAGE_GATE

COVERAGE: 255/255

SPEC

Purpose

DEAL is the relationship. DECK is the artifact. DEAL ends in a contract.

A DEAL is a governed business relationship — the full lifecycle from first contact through signed contract. Every deal scope tracks a specific person or organization: meetings, follow-ups, proposals, negotiations, and economic events. DEAL content is VAULT-gated because it contains sensitive commercial terms, counter-proposals, and private correspondence.

DEAL ≠ DECK. A DECK is a presentation you bring to a deal. A DEAL is the ongoing engagement with a person or institution. The HOWARD deal tracks the relationship with Howard University. The HOWARD deck is the slide deck presented at Howard. One deal may involve many decks. The deal outlives every deck.

Structure

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

Required closure artifacts per scope: CANON.md, README.md, DEAL.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.org/
web_surface: https://hadleylab.org/SERVICES/DEAL/
web_app:     https://hadleylab.org/DEALS/
magic:       magic://hadleylab.org/SERVICES/DEAL/

Deal Lifecycle

PROSPECT -> QUALIFY -> PROPOSE -> NEGOTIATE -> CLOSE -> LEDGER

Each stage transition is a governed gate:
  PROSPECT:   First contact logged, INTEL populated
  QUALIFY:    Fit assessment complete, stakeholders identified
  PROPOSE:    DECK delivered, terms outlined
  NEGOTIATE:  Terms iterated, counter-proposals governed
  CLOSE:      Agreement executed, COIN minted
  LEDGER:     Full deal ledgered with evidence chain

Ecosystem Connectivity

1. Upstream: SERVICES governance contracts and hadleylab-canonic scope inheritance.
2. Runtime: VAULT-gated deal content. SHOP-safe summaries only in public projection.
3. Frontend: DEAL scope surfaced through governed catalog at DEALS/ route.
4. Ledger plane: deal events ledgered (stage transitions, evidence, COIN minted).

Pages

Default: Overview.

Instance Pattern

{USER}/DEALS/
  DEALS.md       <- instance spec
  CANON.md       <- scope governance
  VAULT.md       <- private projection (auth-gated)
  COVERAGE.md    <- compliance
  LEARNING.md    <- learning trail
  README.md      <- scope readme
  ROADMAP.md     <- scope roadmap
  VOCAB.md       <- scope vocabulary

LEARNING

Patterns

LEARNING | DEAL | _generated

ROADMAP

Now

• MARK-MALEK DECK deployed (IP patent counsel)
• ATOM-AVINASH DECK deployed (credentialing partnership)

Next

• Additional deal DECKs as pipeline grows
• Automated CANON.json compilation from INTEL

Later

• Self-service DECK generation via MAGIC API
• Deal pipeline analytics

VOCAB

INHERITANCE CHAIN

DEAL

DEAL governs relationships. Every deal ledgered. Every stage evidenced.

MUST:     Ledger every deal stage transition
MUST:     Evidence every stage
MUST:     Gate stage transitions (QUALIFY → NEGOTIATE → CLOSE)
MUST:     Cross-reference deal parties to CONTACTS
MUST NOT: Advance deal stage without evidence
MUST NOT: Expose deal terms on public surfaces

SERVICES

SERVICES are SURFACE routes with governed boundaries.

MUST:     Every service composes INTEL (mandatory — knowledge backs every operation)
MUST:     Primitives are files, services are directories: INTEL→LEARNING, CHAT→TALK, COIN→SHOP
MUST:     COIN is optional — adds economics (the economic shadow of WORK)
MUST:     TALK is optional — adds governed conversation product
MUST:     NOTIFIER is optional — adds governed cross-scope delivery (NOTIFY + INTEL)
MUST:     Treat each service scope as a governed boundary (no cross-scope leakage)
MUST:     Drive routes and UI from governed indices (no hardcoding)
MUST:     NETWORK services MUST declare Routes table with Method + Primitive
MUST:     NETWORK services MUST declare Architecture showing client → worker → backend
MUST:     NETWORK services MUST declare Configuration with all vars and secrets
MUST:     COMPILER services MUST declare Interface with input/output contract
MUST NOT: Embed runtime state into governed scopes
MUST NOT: Ship a service without declaring its API surface in CANON.md

SURFACE

SURFACE is the platform lane.

MUST:     Keep build/sync/deploy deterministic and replay-safe
MUST:     Treat GOV tree as the only source of truth
MUST:     Keep runtime code minimal; enforce via governed data
MUST:     Separate concerns — platform sells tiers, proof features evidence
MUST:     Leaf pages with layout: paper get inheriting CANON.json — TALK walks inheritance chain
MUST:     APP surface_type — Next.js App Router, reads galaxy.json + CANON.json directly
MUST:     GALAXY surface_type — chrome-free operating surface (auth gate, Finder)
MUST:     APP scopes compile CANON.md → CANON.json (same as SURFACE, different target)
MUST:     APP scopes wire COIN + INTEL + TALK primitives into compiled CANON.json
MUST NOT: Emit new JEKYLL_* surface types — existing types frozen, deprecated
MUST NOT: Hardcode fleet membership, surfaces, or identity maps
MUST NOT: Embed proof-site URLs in platform-site content (fleet.json eco-bar only)

MAGIC

INTEL. CHAT. COIN. — Three primitives. One governed economy.

MUST:     CANON.md in every scope
MUST:     Services compose primitives — never duplicate
MUST:     Primitive structure is fixed — industry is the only variable
MUST:     Primitives compose into services — never duplicate
MUST:     Services connect through SHOP.md and VAULT.md projection files
MUST:     SHOP.md = public projection file (filesystem-discoverable, UPPERCASE per LANGUAGE)
MUST:     VAULT.md = private projection file (filesystem-discoverable, auth-gated, UPPERCASE per LANGUAGE)
MUST:     Instance = service projected through user governance context
MUST:     Instance directories live at USER scope ({USER}/{PLURAL}/), not nested in SERVICES/
MUST:     Service directories (SERVICES/{SINGULAR}/) define schemas — instances hold content
MUST:     Every .md compiles to .json with the same name (direct mapping)
MUST:     CANON.md = axiom + universal constraints only (no service names, no paths, no implementation)
MUST:     README.md = how to run the CANON only
MUST:     {SCOPE}.md = SPEC — the interface (purpose, routes, projections, ecosystem)
MUST NOT: Hardcode service names in CANON constraints (law speaks universals)
MUST:     Inheritance resolves upward — scopes compose by directories
MUST:     Tier algebra is canonical — DESIGN.md is the single source (COMPLIANCE tier algebra)
MUST NOT: Expose dimension internals to users or developers
MUST NOT: Hardcode outside governed contracts
MUST:     Nonprofits get enterprise for free
MUST:     ORG is the container; USER is the repo (`github.com/{org}/{user}`; duplicates across orgs allowed)
MUST:     MARKET/ SALES/ GTM/ exist (META self-closure; one primitive each)
MUST:     Each META sub-scope maps exactly one primitive (INTEL, CHAT, COIN)
MUST NOT: Add META business knowledge outside MAGIC/ scope
MUST NOT: Remove META sub-scope without replacing its primitive coverage
MUST:     `{SCOPE}.md` is the scope contract surface; it MUST NOT be treated as a generic filename placeholder
MUST:     LEARNING.md is the terminal — governance evidence, patterns, epoch rotation
MUST:     LEARNING/ is the IDF directory — machine-generated individual data files
MUST:     LEARNING.md rotates at epoch boundaries — frozen epochs archive as LEARNING-{EPOCH}.md at scope root
MUST:     LEARNING.md is always the current epoch — active, append-only
MUST:     Epoch boundary = EVOLUTION signal in LEARNING.md (named, dated, sourced)
MUST NOT: Delete archived LEARNING epochs — append-only history
MUST:     MAGIC defines the triad interface directly:
MUST:     COMPLIANCE/ + GALAXY/ + SURFACE/
MUST NOT: Define conflicting tier algebra in downstream scopes; downstream must inherit this contract

FOUNDATION

SPEC = {SCOPE}. The LANGUAGE. The v0 discovery.

MUST:     LANGUAGE defines all governance primitives
MUST:     Every scope inherits from FOUNDATION
MUST:     Triad (CANON.md + VOCAB.md + README.md) in every scope
MUST NOT: Define terms outside VOCAB.md
MUST NOT: Hardcode outside the kernel
SHOULD:   Vocabulary closure — every term resolves to a definition