← Files DesignlyARCHIVED FILE

shared/contracts/routing-graph.json

14.9 KB · Sep 30, 2026 · 23:14 UTC

↓ Download file

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "version": "4.4.0",
  "name": "Design Neural Mesh Orchestration Graph",
  "primary_orchestrator": "designly-director",
  "architecture_layers": [
    {
      "tier": 1,
      "name": "Strategy & Ideation",
      "description": "Deconstructs business problem, unearths consumer tensions, benchmarks against 571 campaigns, and generates Cannes-calibrated concepts.",
      "skills": ["creative-strategy", "insight-mining", "creative-director", "campaign-canon", "brand-activation"]
    },
    {
      "tier": 2,
      "name": "Visual Architecture & Representation",
      "description": "Establishes narrative arcs, spatial hierarchy, typography, native RTL eye flow, and anti-bias human representation.",
      "skills": ["visual-storytelling", "composition-director", "typography-director", "arabic-rtl-director"]
    },
    {
      "tier": 3,
      "name": "Brand Identity & Taste Intelligence",
      "description": "Audits brand assets, enforces logo clearspace, and extracts evidence-backed transferable aesthetic rules.",
      "skills": ["brand-intelligence", "taste-engine", "reference-memory"]
    },
    {
      "tier": 4,
      "name": "Craft Physics & Optics",
      "description": "Directs camera focal length, 3-point lighting systems, melanin-accurate color grading, and compositing contact physics.",
      "skills": ["photography-director", "manipulation-director", "campaign-dna"]
    },
    {
      "tier": 5,
      "name": "Sanitization & Model Compilation",
      "description": "Normalizes annotation-guided edits into bounded contracts and compiles approved art direction into provider instructions.",
      "skills": ["edit-sanitizer", "prompt-compiler"]
    },
    {
      "tier": 6,
      "name": "Verification & QA Release Gates",
      "description": "Independent release gate enforcing category floors, 7-point representation review, AI-slop vetoes, and targeted revision routing.",
      "skills": ["visual-qa"]
    }
  ],
  "role_aware_pipelines": {
    "new_commercial_campaign": [
      "designly-director",
      "creative-strategy",
      "insight-mining",
      "creative-director",
      "campaign-canon",
      "brand-intelligence",
      "taste-engine",
      "composition-director",
      "typography-director",
      "photography-director",
      "prompt-compiler",
      "visual-qa"
    ],
    "brand_activation_stunt": [
      "designly-director",
      "insight-mining",
      "brand-activation",
      "campaign-canon",
      "brand-intelligence",
      "manipulation-director",
      "prompt-compiler",
      "visual-qa"
    ],
    "arabic_first_poster": [
      "designly-director",
      "creative-strategy",
      "insight-mining",
      "creative-director",
      "brand-intelligence",
      "composition-director",
      "arabic-rtl-director",
      "typography-director",
      "photography-director",
      "prompt-compiler",
      "visual-qa"
    ],
    "narrative_storyboard": [
      "designly-director",
      "creative-strategy",
      "insight-mining",
      "visual-storytelling",
      "campaign-dna",
      "composition-director",
      "photography-director",
      "prompt-compiler",
      "visual-qa"
    ],
    "bounded_image_edit": [
      "designly-director",
      "edit-sanitizer",
      "arabic-rtl-director",
      "prompt-compiler",
      "visual-qa"
    ]
  },
  "feedback_loops": [
    {
      "name": "cannes_ideation_refinement_loop",
      "source": "creative-director",
      "target": "insight-mining",
      "condition": "concept_score < 9.0 or humankind_score < 7",
      "action": "Rotate structural method in methods-catalog (SIT -> Bisociation -> Inversion), refine underlying tension, and re-score (up to 5 passes).",
      "max_iterations": 5
    },
    {
      "name": "craft_physics_alignment_loop",
      "source": "manipulation-director",
      "target": "photography-director",
      "condition": "perspective_or_lighting_mismatch_detected",
      "action": "Realign horizon lines, key light angles, and color temperatures between composite elements and background plate.",
      "max_iterations": 3
    },
    {
      "name": "bounded_edit_containment_loop",
      "source": "visual-qa",
      "target": "edit-sanitizer",
      "condition": "collateral_drift > 0 or wrong_target_mutated",
      "action": "Reject output, reset to approved source checkpoint, shrink mutation polygon, and reissue EditContract.",
      "max_iterations": 3
    },
    {
      "name": "arabic_glyph_integrity_loop",
      "source": "visual-qa",
      "target": "arabic-rtl-director",
      "condition": "arabic_glyph_error or rtl_flow_reversed",
      "action": "Issue hard veto, extract exact Unicode string, verify ligature shaping, and inject strict typographic constraints into prompt-compiler.",
      "max_iterations": 2
    },
    {
      "name": "anti_bias_representation_loop",
      "source": "visual-qa",
      "target": "prompt-compiler",
      "condition": "clone_faces_detected or stereotypical_trope_found",
      "action": "Inject explicit facial bone structure variance, melanin-calibrated lighting spec, and negative constraints against generic stock archetypes.",
      "max_iterations": 2
    }
  ],
  "verification_gates": [
    {
      "gate_id": "GATE-0",
      "name": "Intake & Brief Invariants",
      "owner": "designly-director",
      "criteria": "Task type, primary communication job, deliverables, and immutable client locks established."
    },
    {
      "gate_id": "GATE-1",
      "name": "Ideation & Originality",
      "owner": "creative-director",
      "criteria": "Cannes weighted score >= 8.5, Pollard taxonomy matched, pattern saturation capped at 6.0 for P09/P11/P16 without structural novelty."
    },
    {
      "gate_id": "GATE-2",
      "name": "Representation & Inclusivity",
      "owner": "visual-qa",
      "criteria": "Passes 7-point representation checklist, no clone faces, melanin-calibrated lighting, no gibberish cultural symbols."
    },
    {
      "gate_id": "GATE-3",
      "name": "Spatial & Typographic Preflight",
      "owner": "composition-director",
      "criteria": "1-second thumbnail test passes, grayscale value mass clear, exact copy locked, Arabic glyphs shaped."
    },
    {
      "gate_id": "GATE-4",
      "name": "Craft Realism & Physics",
      "owner": "manipulation-director",
      "criteria": "Consistent horizon, ambient occlusion contact shadows, directional reflections, and physical light wrap."
    },
    {
      "gate_id": "GATE-5",
      "name": "Bounded-Edit Containment",
      "owner": "edit-sanitizer",
      "criteria": "Mutation budget = 1, protected complement locked, approved source checkpoint verified."
    },
    {
      "gate_id": "GATE-6",
      "name": "Post-Generation Visual Signoff",
      "owner": "visual-qa",
      "criteria": "Weighted score >= 92, all applicable category floors met, AI-slop veto clear, collateral drift zero."
    }
  ],
  "nodes": {
    "designly-director": {
      "type": "orchestrator",
      "agent": "designly-director",
      "description": "Brief intake, routing, conflict resolution, lock enforcement, and final approval.",
      "reads": ["brief", "all_packets"],
      "writes": ["session_id", "task_type", "objective", "locks", "qa_state.final_approval"]
    },
    "creative-strategy": {
      "type": "specialist",
      "agent": "strategy-planner",
      "description": "Objective, audience, message hierarchy, and visual concept territory.",
      "reads": ["objective", "audience", "cultural_context"],
      "writes": ["strategy_state", "primary_message", "desired_action"]
    },
    "creative-director": {
      "type": "specialist",
      "agent": "creative-director",
      "description": "Cannes-calibrated ideation, structural concept generation (SIT/TRIZ/Bisociation), 7-level idea taxonomy, and multi-round recursive refinement.",
      "reads": ["objective", "audience", "platform", "cultural_context", "brand_state"],
      "writes": ["strategy_state", "primary_message", "desired_action"]
    },
    "insight-mining": {
      "type": "specialist",
      "agent": "insight-miner",
      "description": "Consumer tension spotting (cultural, category, human), JTBD, Mark Pollard Four Points, and insight synthesis.",
      "reads": ["brief", "audience", "cultural_context"],
      "writes": ["strategy_state.insight", "primary_message"]
    },
    "campaign-canon": {
      "type": "specialist",
      "agent": "canon-analyst",
      "description": "571 canonical advertising campaigns, P01-P18 pattern taxonomy, anti-derivative benchmarking, and saturation caps.",
      "reads": ["strategy_state", "brief", "brand_state"],
      "writes": ["strategy_state.canon_benchmark"]
    },
    "brand-activation": {
      "type": "specialist",
      "agent": "activation-strategist",
      "description": "Experiential campaigns, PR stunts, brand utility, cultural objects, and non-advertising diagnostics.",
      "reads": ["strategy_state", "brand_state", "brief"],
      "writes": ["strategy_state.activation"]
    },
    "visual-storytelling": {
      "type": "specialist",
      "agent": "story-architect",
      "description": "Narrative architecture, 6 storytelling frameworks (Story Spine, Sparkline, Freytag, Monroe), and emotional tiers.",
      "reads": ["strategy_state", "composition_state", "brief"],
      "writes": ["strategy_state.narrative_arc"]
    },
    "brand-intelligence": {
      "type": "specialist",
      "agent": "brand-guardian",
      "description": "Brand rules, observed patterns, brand-off test, and product/logo fidelity.",
      "reads": ["brand_assets", "product_specs"],
      "writes": ["brand_state"]
    },
    "taste-engine": {
      "type": "specialist",
      "agent": "taste-analyst",
      "description": "Reference deconstruction, evidence-backed transferable rules, anti-rules, and taste mixing.",
      "reads": ["references", "taste_state"],
      "writes": ["taste_state"]
    },
    "reference-memory": {
      "type": "specialist",
      "agent": "taste-analyst",
      "description": "Stable REF IDs, scoped likes/dislikes ledger, and preference recall.",
      "reads": ["reference_records", "user_feedback"],
      "writes": ["taste_state.reference_memory"]
    },
    "composition-director": {
      "type": "specialist",
      "agent": "structure-critic",
      "description": "Grid, hierarchy, focal structure, grouping, negative space, crop, and eye path.",
      "reads": ["strategy_state", "brand_state", "taste_state"],
      "writes": ["composition_state"]
    },
    "typography-director": {
      "type": "specialist",
      "agent": "structure-critic",
      "description": "Type hierarchy, text zones, line breaks, measure, spacing, and exact-copy strategy.",
      "reads": ["composition_state", "primary_message"],
      "writes": ["typography_state"]
    },
    "photography-director": {
      "type": "specialist",
      "agent": "craft-director",
      "description": "Camera logic, lighting, lens behavior, materials, realism, and subject treatment.",
      "reads": ["composition_state", "strategy_state"],
      "writes": ["craft_state.photography"]
    },
    "manipulation-director": {
      "type": "specialist",
      "agent": "craft-director",
      "description": "Compositing, perspective, scale, contact, reflections, relighting, and occlusion.",
      "reads": ["composition_state", "craft_state"],
      "writes": ["craft_state.manipulation"]
    },
    "arabic-rtl-director": {
      "type": "specialist",
      "agent": "arabic-visual-director",
      "description": "Arabic-first composition, RTL reading flow, glyph correctness, and mixed Arabic/English behavior.",
      "reads": ["typography_state", "composition_state", "cultural_context"],
      "writes": ["typography_state.arabic_rtl", "composition_state.rtl_flow"]
    },
    "campaign-dna": {
      "type": "specialist",
      "agent": "strategy-planner",
      "description": "Multi-asset continuity, visual-family rules, and deliberate variation.",
      "reads": ["strategy_state", "brand_state", "composition_state"],
      "writes": ["campaign_state"]
    },
    "edit-sanitizer": {
      "type": "specialist",
      "agent": "edit-sanitizer",
      "description": "Normalizes annotation-guided edits into a bounded EditContract and blocks ambiguous, over-broad, or drift-prone revisions before image execution.",
      "reads": ["edit_request", "generation_state.approved_checkpoint", "locks", "brand_state", "typography_state"],
      "writes": ["edit_state"]
    },
    "prompt-compiler": {
      "type": "specialist",
      "agent": "designly-director",
      "description": "Compiles approved Art Direction Spec or sanitized EditContract into provider/model-ready generation or edit instructions.",
      "reads": ["strategy_state", "brand_state", "taste_state", "composition_state", "typography_state", "craft_state", "campaign_state", "edit_state"],
      "writes": ["generation_state"]
    },
    "visual-qa": {
      "type": "specialist",
      "agent": "visual-reviewer",
      "description": "Post-generation critique, hard gates, category floors, anti-slop veto, and collateral-change review for bounded edits.",
      "reads": ["generation_state", "edit_state", "locks", "brand_state", "composition_state", "typography_state", "craft_state"],
      "writes": ["qa_state"]
    }
  },
  "signal_priorities": [
    {"level": 1, "name": "user_exact_constraints", "can_override": []},
    {"level": 2, "name": "documented_brand_rules", "can_override": [3,4,5,6,7,8,9,10,11]},
    {"level": 3, "name": "safety_legal_cultural_gates", "can_override": [4,5,6,7,8,9,10,11]},
    {"level": 4, "name": "primary_communication_job", "can_override": [5,6,7,8,9,10,11]},
    {"level": 5, "name": "hierarchy_and_composition", "can_override": [6,7,8,9,10,11]},
    {"level": 6, "name": "accessibility_and_legibility", "can_override": [7,8,9,10,11]},
    {"level": 7, "name": "campaign_continuity", "can_override": [8,9,10,11]},
    {"level": 8, "name": "craft_realism", "can_override": [9,10,11]},
    {"level": 9, "name": "explicit_user_taste_preference", "can_override": [10,11]},
    {"level": 10, "name": "inferred_taste_preference", "can_override": [11]},
    {"level": 11, "name": "decorative_finish", "can_override": []}
  ],
  "revision_routes": {
    "strategy": "creative-strategy",
    "concept_originality": "creative-director",
    "creative_ideation": "creative-director",
    "insight_depth": "insight-mining",
    "pattern_saturation": "campaign-canon",
    "activation_mechanic": "brand-activation",
    "narrative_arc": "visual-storytelling",
    "hierarchy": "composition-director",
    "composition": "composition-director",
    "typography": "typography-director",
    "arabic_rtl": "arabic-rtl-director",
    "brand_fidelity": "brand-intelligence",
    "product_fidelity": "brand-intelligence",
    "physical_believability": "manipulation-director",
    "edit_scope": "edit-sanitizer",
    "annotation_mapping": "edit-sanitizer",
    "collateral_change": "edit-sanitizer",
    "prompt_execution": "prompt-compiler",
    "ai_slop": "composition-director"
  }
}

SHA-256: 7c4f5d59cb80b4efbee9b3334cbeb23523fec02e792d30e83f9eb35d183c103f