{
  "id": "studio-75daba90-3cc4-4f30-bbc8-046dba537a55",
  "scope": "studio_project",
  "source_of_truth": "supabase.studio_artifacts",
  "source_path": "studio_artifacts/75daba90-3cc4-4f30-bbc8-046dba537a55",
  "source_kind": "supabase_json",
  "visibility": "internal",
  "renderer_id": "design_doc.dreamborn-forge.generated.v1",
  "design_system": "dreamborn-design-system:forge",
  "generated_at": "2026-05-10T18:19:39.273Z",
  "artifact_type": "v1-agent-contracts",
  "schema_version": "1",
  "title": "Limitless V1 AI-First Agent Contracts",
  "summary": "v1-agent-contracts artifact · for Limitless OS · status draft",
  "status": "draft",
  "version": 1,
  "phase_id": null,
  "project_id": "07dee66f-8143-4f4d-9af9-b1ed413d2767",
  "project_slug": "limitless-limitless-os-07dee66f",
  "project_title": "Limitless OS",
  "client_id": "limitless",
  "platform_project_id": null,
  "created_at": "2026-05-09T20:13:40.385798+00:00",
  "updated_at": "2026-05-09T20:13:40.385798+00:00",
  "format_source": "supabase_json",
  "content_shape": [
    "title",
    "agents",
    "source",
    "purpose",
    "client_id",
    "project_id",
    "updated_at",
    "design_notes",
    "project_name",
    "artifact_type",
    "schema_version",
    "shared_contract",
    "related_artifacts",
    "v1_minimum_viable_agent_set",
    "v1_optional_lightweight_agents"
  ],
  "content_data": {
    "title": "Limitless V1 AI-First Agent Contracts",
    "agents": [
      {
        "id": "thought_capture_agent",
        "pod": "Memory / Knowledge",
        "name": "Thought Capture Agent",
        "queue": "roles.limitless.thought-capture",
        "tools": [
          "Limitless MCP capture_thought",
          "Limitless MCP search_thoughts",
          "Projects brain_memory write path"
        ],
        "inputs": [
          "raw thought text",
          "source client",
          "optional user tags",
          "conversation context if provided"
        ],
        "handoff": "Seth controls what is captured; ambiguous sensitive items become clarification questions.",
        "v1_role": "Capture raw Seth thoughts from ChatGPT/Claude and preserve them as searchable Limitless operating memory.",
        "output_schema": {
          "source": "chatgpt | claude | voice | email | manual",
          "thought_id": "uuid",
          "raw_content": "string",
          "initial_tags": [
            "limitless-os",
            "front-office?",
            "content?",
            "patient-performance?"
          ],
          "inferred_topics": [
            "string"
          ],
          "capture_confidence": "number"
        },
        "confidence_rules": [
          "High confidence when user explicitly says capture/save/remember.",
          "Medium confidence when the user implies importance but does not explicitly request capture.",
          "Ask before capturing sensitive or ambiguous personal/patient details."
        ],
        "memory_available": [
          "existing Limitless MCP thoughts",
          "known topic taxonomy",
          "project id and source metadata"
        ]
      },
      {
        "id": "operating_memory_curator",
        "pod": "Memory / Knowledge",
        "name": "Operating Memory Curator",
        "queue": "roles.limitless.memory-curator",
        "tools": [
          "search_thoughts",
          "list_thoughts",
          "Studio artifact read",
          "classification write/proposal queue"
        ],
        "inputs": [
          "thought_id",
          "raw_content",
          "metadata",
          "recent related thoughts"
        ],
        "handoff": "Chief Operating Brain reviews queue-worthy classifications; Seth reviews canonical operating principles.",
        "v1_role": "Classify captured thoughts and propose what each thought should become.",
        "output_schema": {
          "lanes": [
            "front_office | content | command_guardrail"
          ],
          "topics": [
            "string"
          ],
          "confidence": "number",
          "sensitivity": "low | medium | high",
          "classifications": [
            "memory | decision | task | draft | sop_workflow_rule | question"
          ],
          "candidate_outputs": [
            {
              "reason": "string",
              "output_type": "string",
              "suggested_owner": "string"
            }
          ],
          "clarifying_question": "optional string"
        },
        "confidence_rules": [
          "One thought may receive multiple classifications.",
          "Low confidence or high sensitivity routes to question/review.",
          "Prefer memory-only when action is not clear."
        ],
        "memory_available": [
          "thought history",
          "agent taxonomy",
          "v1-hybrid-loop-spec",
          "known operating principles",
          "prior classifications"
        ]
      },
      {
        "id": "chief_operating_brain",
        "pod": "Executive",
        "name": "Chief Operating Brain",
        "queue": "roles.limitless.ops-chief",
        "tools": [
          "Studio artifacts",
          "MCP search/list",
          "HCS queue create/read",
          "daily brief draft"
        ],
        "inputs": [
          "classified thought",
          "candidate outputs",
          "active queue summary",
          "recent decisions",
          "business priority context"
        ],
        "handoff": "Seth reviews strategic priorities and daily brief recommendations.",
        "v1_role": "Prioritize classified thoughts and decide whether they become memory, daily brief items, front-office tasks, content tasks, SOP candidates, or clarifying questions.",
        "output_schema": {
          "priority": "low | normal | high | urgent",
          "rationale": "string",
          "queue_items": [
            {
              "lane": "front_office | content | command_guardrail",
              "owner": "string",
              "summary": "string",
              "due_timing": "string",
              "role_topic_slug": "string"
            }
          ],
          "route_decision": "memory_only | daily_brief | create_queue_item | ask_clarification | policy_review | no_action",
          "daily_brief_entry": "optional string"
        },
        "confidence_rules": [
          "High confidence only when action, owner, and lane are clear.",
          "If several outputs are possible, create separate queue items with clear reasons.",
          "Escalate strategy and policy decisions to Seth."
        ],
        "memory_available": [
          "operating principles",
          "decision history",
          "open V1 queues",
          "Seth preferences",
          "front-office and content priorities"
        ]
      },
      {
        "id": "intake_concierge",
        "pod": "Front Office",
        "name": "Intake Concierge",
        "queue": "roles.limitless.intake",
        "tools": [
          "CRM/lead refs when available",
          "message draft generator",
          "MCP search",
          "approval queue"
        ],
        "inputs": [
          "lead summary",
          "source thought/ref",
          "readiness/objection context",
          "requested response channel"
        ],
        "handoff": "Betsy/front office approves lead responses; Seth approves positioning or unusual offers.",
        "v1_role": "Draft next-step responses and summaries for lead/intake queue items created from thoughts or source-system events.",
        "output_schema": {
          "lead_summary": "string",
          "draft_message": "string",
          "approval_owner": "Betsy/front office | Seth | clinician/performance team",
          "readiness_category": "cold | curious | ready | urgent | unclear",
          "questions_for_human": [
            "string"
          ],
          "recommended_next_action": "string"
        },
        "confidence_rules": [
          "Draft confidently when issue is scheduling/interest/objection.",
          "Escalate symptoms, clinical questions, complaints, price exceptions, and unclear insurance questions.",
          "Do not promise outcomes or coverage."
        ],
        "memory_available": [
          "approved intake tone",
          "common objections",
          "offer language",
          "front-office rules",
          "related Seth thoughts"
        ]
      },
      {
        "id": "scheduler",
        "pod": "Front Office",
        "name": "Scheduler",
        "queue": "roles.limitless.scheduling",
        "tools": [
          "PT Everywhere schedule refs when available",
          "calendar refs",
          "message drafts",
          "approval queue"
        ],
        "inputs": [
          "schedule issue type",
          "patient/lead ref if available",
          "visit type",
          "timing constraint",
          "source thought/ref"
        ],
        "handoff": "Betsy/front office approves and performs schedule changes.",
        "v1_role": "Draft scheduling recommendations, cancellation recovery steps, unscheduled-eval follow-ups, and waitlist actions.",
        "output_schema": {
          "timing": "string",
          "risk_flags": [
            "string"
          ],
          "draft_message": "string",
          "approval_owner": "Betsy/front office | clinician/performance team",
          "schedule_issue": "new_eval | follow_up | cancellation | no_show | waitlist | unclear",
          "recommended_action": "string"
        },
        "confidence_rules": [
          "Can recommend and draft; cannot move appointments in V1.",
          "Escalate repeated no-shows, clinical risk, or patient frustration.",
          "Ask for missing availability details rather than guessing."
        ],
        "memory_available": [
          "schedule rules",
          "visit types",
          "follow-up cadence",
          "cancellation/no-show rules",
          "office preferences"
        ]
      },
      {
        "id": "patient_communication",
        "pod": "Front Office",
        "name": "Patient Communication Agent",
        "queue": "roles.limitless.patient-comms",
        "tools": [
          "message draft generator",
          "policy checker",
          "approval queue"
        ],
        "inputs": [
          "communication goal",
          "audience",
          "context summary",
          "sensitivity",
          "channel"
        ],
        "handoff": "Human approval required before any patient-facing send.",
        "v1_role": "Draft empathetic patient-safe communications for front-office and approved education contexts.",
        "output_schema": {
          "tone_notes": "string",
          "message_type": "scheduling | reminder | follow_up | education_general | admin | clarification",
          "draft_message": "string",
          "approval_owner": "Betsy/front office | Seth | clinician/performance team | privacy review",
          "sensitivity_flags": [
            "string"
          ]
        },
        "confidence_rules": [
          "General scheduling/admin drafts can be medium/high confidence.",
          "Clinical or patient-specific advice is low confidence and clinician-routed.",
          "Avoid blame, fear, diagnosis, or guarantees."
        ],
        "memory_available": [
          "approved tone",
          "message templates",
          "patient-safe language rules",
          "Seth/Limitless voice examples"
        ]
      },
      {
        "id": "content_brain",
        "pod": "Growth / Voice",
        "name": "Content Brain",
        "queue": "roles.limitless.content-brain",
        "tools": [
          "MCP search/list",
          "content brief generator",
          "approval queue"
        ],
        "inputs": [
          "captured thought",
          "topic",
          "audience",
          "desired channel if known"
        ],
        "handoff": "Seth approves content direction and final publish.",
        "v1_role": "Turn Seth’s thoughts into content angles, themes, series ideas, and draft briefs while preserving Limitless voice.",
        "output_schema": {
          "formats": [
            "social_post | reel_script | newsletter | faq_blog | referral_partner_education"
          ],
          "audience": "patients | athletes | parents | runners | referral partners | general community",
          "key_points": [
            "string"
          ],
          "risk_flags": [
            "clinical_claim | patient_story | PHI | none"
          ],
          "content_angle": "string",
          "downstream_queue_items": [
            "social_post_drafter | newsletter_agent | patient_education_agent"
          ]
        },
        "confidence_rules": [
          "High confidence for general content angles based on Seth thoughts.",
          "Escalate patient stories, specific cases, claims, and clinical advice.",
          "Ask when audience or channel is unclear."
        ],
        "memory_available": [
          "Seth voice principles",
          "content themes",
          "clinical philosophy notes",
          "approved claims",
          "prior content ideas"
        ]
      },
      {
        "id": "social_post_drafter",
        "pod": "Growth / Voice",
        "name": "Social Post Drafter",
        "queue": "roles.limitless.social-drafts",
        "tools": [
          "draft generator",
          "MCP search",
          "approval queue"
        ],
        "inputs": [
          "content brief",
          "audience",
          "format",
          "tone target",
          "source thought ids"
        ],
        "handoff": "Seth approves before publishing.",
        "v1_role": "Draft social posts, hooks, short scripts, captions, and repurposing variants from content briefs.",
        "output_schema": {
          "cta_options": [
            "string"
          ],
          "reel_script": "optional string",
          "hook_options": [
            "string"
          ],
          "draft_caption": "string",
          "approval_owner": "Seth | clinician/performance team | privacy review",
          "source_thought_ids": [
            "uuid"
          ]
        },
        "confidence_rules": [
          "Draft-only in V1.",
          "Escalate claims, patient examples, and content that sounds unlike Seth.",
          "Prefer clear, practical, non-hype language."
        ],
        "memory_available": [
          "Seth voice examples",
          "approved CTAs",
          "content pillars",
          "platform preferences"
        ]
      },
      {
        "id": "newsletter_agent",
        "pod": "Growth / Voice",
        "name": "Newsletter Agent",
        "queue": "roles.limitless.newsletter",
        "tools": [
          "newsletter draft generator",
          "MCP search",
          "approval queue"
        ],
        "inputs": [
          "content theme",
          "audience",
          "campaign context",
          "source thoughts"
        ],
        "handoff": "Seth approves send or campaign use.",
        "v1_role": "Lightweight V1 agent for turning content themes into newsletter sections, subject lines, and nurture ideas.",
        "output_schema": {
          "cta_options": [
            "string"
          ],
          "review_flags": [
            "string"
          ],
          "draft_section": "string",
          "subject_lines": [
            "string"
          ],
          "newsletter_outline": [
            "string"
          ]
        },
        "confidence_rules": [
          "Keep V1 newsletter output as draft sections/outlines unless Seth asks for a full draft.",
          "Escalate clinical claims and offers.",
          "Ask if audience segment is unclear."
        ],
        "memory_available": [
          "Seth voice",
          "audience segments",
          "approved education themes",
          "offers/campaigns if known"
        ]
      },
      {
        "id": "patient_education_agent",
        "pod": "Growth / Voice / Clinical Support",
        "name": "Patient Education Agent",
        "queue": "roles.limitless.patient-education",
        "tools": [
          "education draft generator",
          "clinical safety review queue",
          "approval queue"
        ],
        "inputs": [
          "education topic",
          "audience",
          "source thought",
          "risk flags"
        ],
        "handoff": "Clinician/performance team approves clinical education when patient-specific or claim-heavy.",
        "v1_role": "Draft general patient education snippets from Seth thoughts, routed through clinical review when needed.",
        "output_schema": {
          "approval_owner": "Seth | clinician/performance team",
          "what_not_to_say": [
            "string"
          ],
          "education_snippet": "string",
          "plain_language_summary": "string",
          "clinical_review_required": "boolean"
        },
        "confidence_rules": [
          "General education can be drafted; individualized advice always requires clinician review.",
          "Avoid diagnosis, prescribing, guarantees, or return-to-play clearance.",
          "Flag all medical claims for review."
        ],
        "memory_available": [
          "approved education language",
          "clinical safety rules",
          "Limitless philosophy notes"
        ]
      },
      {
        "id": "human_approval_router",
        "pod": "Governance",
        "name": "Human Approval Router",
        "queue": "roles.limitless.approvals",
        "tools": [
          "approval queue create/update",
          "notification refs",
          "outcome logger"
        ],
        "inputs": [
          "draft output",
          "sensitivity",
          "agent recommendation",
          "policy flags",
          "owner hints"
        ],
        "handoff": "Human owner must approve/reject/edit before external action.",
        "v1_role": "Route drafts and decisions to the correct human owner and record approval outcomes.",
        "output_schema": {
          "sla_hint": "string",
          "approval_owner": "Seth | Betsy/front office | clinician/performance team | privacy review",
          "allowed_actions": [
            "approve",
            "edit",
            "reject",
            "defer",
            "escalate",
            "mark_as_rule_update"
          ],
          "approval_reason": "string",
          "outcome_log_required": "boolean"
        },
        "confidence_rules": [
          "Route conservatively when multiple owners apply.",
          "Privacy/clinical flags override convenience.",
          "Ask Seth to assign owner when ownership is unknown."
        ],
        "memory_available": [
          "approval matrix",
          "owner preferences",
          "past approval outcomes",
          "policy artifact"
        ]
      },
      {
        "id": "privacy_clinical_guardrail",
        "pod": "Governance",
        "name": "Privacy / Clinical Guardrail",
        "queue": "roles.limitless.guardrail",
        "tools": [
          "policy checker",
          "payload inspector",
          "approval router"
        ],
        "inputs": [
          "thought/draft/queue item",
          "intended audience",
          "source refs",
          "proposed action"
        ],
        "handoff": "Relevant human owner reviews medium/high/blocked items.",
        "v1_role": "Review thoughts, drafts, and queue items for PHI, clinical safety, automation boundary, and content risk.",
        "output_schema": {
          "risk_level": "low | medium | high | blocked",
          "policy_note": "string",
          "allowed_mode": "memory_only | draft_only | human_review_required | blocked",
          "required_owner": "Seth | Betsy/front office | clinician/performance team | privacy review",
          "risk_categories": [
            "PHI",
            "clinical_advice",
            "return_to_play",
            "insurance_payment",
            "patient_story",
            "staff_sensitive",
            "automation_boundary"
          ]
        },
        "confidence_rules": [
          "If uncertain, require review.",
          "Block unsafe automation until policy allows it.",
          "Do not allow PHI in public content or HCS payloads beyond opaque refs."
        ],
        "memory_available": [
          "policy artifact",
          "clinical safety rules",
          "privacy classifications",
          "automation permissions"
        ]
      }
    ],
    "source": "atlas-codex",
    "purpose": "Define precise AI-first contracts for the agents in the V1 Hybrid Thought-to-Front-Office + Content Loop before implementation planning.",
    "client_id": "limitless",
    "project_id": "07dee66f-8143-4f4d-9af9-b1ed413d2767",
    "updated_at": "2026-05-09T20:13:39.941Z",
    "design_notes": [
      "Newsletter and patient education are included as lightweight V1 contracts because many Seth thoughts will become content or education, but they should remain draft/review-first.",
      "The guardrail may be implemented as one combined V1 agent even though later specs split HIPAA/privacy, clinical safety, and automation boundary agents.",
      "The first implementation plan should start with contract tests around classification, routing, approval ownership, and blocked clinical/privacy outputs."
    ],
    "project_name": "Limitless OS",
    "artifact_type": "v1-agent-contracts",
    "schema_version": "1",
    "shared_contract": {
      "contract_principle": "Each V1 agent is defined by judgment, memory, tools, queue, output schema, confidence behavior, and human handoff. Implementation must serve this contract rather than reducing agents to CRUD handlers.",
      "shared_input_envelope": {
        "lane": [
          "front_office",
          "content",
          "command_guardrail"
        ],
        "task_id": "HCS or internal queue item id",
        "project_id": "07dee66f-8143-4f4d-9af9-b1ed413d2767",
        "sensitivity": [
          "low",
          "medium",
          "high"
        ],
        "source_refs": [
          "thought id",
          "email thread id",
          "CRM lead id",
          "schedule ref",
          "draft ref"
        ],
        "context_summary": "short self-contained brief",
        "human_owner_hint": "Seth | Betsy/front office | clinician/performance team | privacy review",
        "requested_output": "memory | decision | task | draft | sop_workflow_rule | question | review"
      },
      "shared_output_envelope": {
        "status": [
          "completed",
          "drafted",
          "needs_clarification",
          "needs_human_approval",
          "blocked_by_policy",
          "no_action"
        ],
        "summary": "what the agent produced or decided",
        "confidence": "0.0-1.0 plus plain-language reason",
        "output_type": "memory | decision | task | draft | sop_workflow_rule | question | review",
        "policy_notes": "privacy/clinical/automation boundary notes",
        "approval_owner": "Seth | Betsy/front office | clinician/performance team | privacy review | none",
        "memory_updates": "facts, decisions, examples, or preferences learned",
        "next_queue_items": "optional queue items created for downstream agents",
        "approval_required": "boolean",
        "structured_payload": "agent-specific JSON payload"
      },
      "universal_escalation_rules": [
        "Escalate all individualized clinical advice, diagnosis, treatment plan changes, return-to-play implications, and red flags to clinician/performance review.",
        "Escalate all PHI-sensitive use, patient stories, payer details, staff-sensitive items, and HCS payload concerns to privacy/guardrail review.",
        "Escalate pricing exceptions, financial disputes, collections language, insurance explanations, and coverage promises to front office/Seth approval.",
        "Ask a clarifying question when the requested action, owner, patient context, or intended audience is ambiguous.",
        "Draft first in V1; do not send, publish, schedule, or alter records automatically."
      ]
    },
    "related_artifacts": {
      "agent_team_spec": "36c57e41-dbda-434b-ba2b-42e13cff1c29",
      "v1_hybrid_loop_spec": "19911d80-32bc-4890-b033-c028aa0c0122",
      "implementation_roadmap": "3bbfdbc8-0578-4542-8d64-8f64886b60a2"
    },
    "v1_minimum_viable_agent_set": [
      "thought_capture_agent",
      "operating_memory_curator",
      "chief_operating_brain",
      "intake_concierge",
      "scheduler",
      "patient_communication",
      "content_brain",
      "social_post_drafter",
      "human_approval_router",
      "privacy_clinical_guardrail"
    ],
    "v1_optional_lightweight_agents": [
      "newsletter_agent",
      "patient_education_agent"
    ]
  },
  "sections": [
    {
      "title": "Artifact Shape",
      "level": 2,
      "body": "- title: Limitless V1 AI-First Agent Contracts\n- agents: 12 items\n- source: atlas-codex\n- purpose: Define precise AI-first contracts for the agents in the V1 Hybrid Thought-to-Front-Office + Content Loop before implementation planning.\n- client id: limitless\n- project id: 07dee66f-8143-4f4d-9af9-b1ed413d2767\n- updated at: 2026-05-09T20:13:39.941Z\n- design notes: 3 items\n- project name: Limitless OS\n- artifact type: v1-agent-contracts\n- schema version: 1\n- shared contract: contract_principle: string, shared_input_envelope: object, shared_output_envelope: object, universal_escalation_rules: object"
    }
  ],
  "html_path": "projects/limitless-limitless-os-07dee66f/artifacts/v1-agent-contracts-75daba90.html",
  "json_path": "projects/limitless-limitless-os-07dee66f/artifacts/v1-agent-contracts-75daba90.json"
}