{
  "meta": {
    "title": "Agent-readable SF startup signals",
    "version": "0.1.0",
    "agent_readable": true,
    "purpose": "Expose the human map as structured questions and signals that VC agents, founder agents, and job seeker agents can read for free.",
    "truth_policy": "Do not present unverified funding, hiring, founder, or contact facts as true. Signals marked needs_source_enrichment should be filled by public auditable sources or other public auditable sources."
  },
  "roles": [
    {
      "id": "vc",
      "label": "VC",
      "headline": "Find the companies with fresh momentum.",
      "human_question": "Who raised, who is hiring, and which founders match my thesis?",
      "agent_questions": [
        "List SF companies that raised recently, with source URLs.",
        "Find AI/agent startups hiring founding engineers.",
        "Show companies near my thesis that need capital, customers, or talent."
      ],
      "primary_signals": ["funding_round", "hiring_velocity", "founder_density", "category_momentum"],
      "cta": "Read the founder graph"
    },
    {
      "id": "founder",
      "label": "Founder",
      "headline": "Find users, investors, hires, and adjacent founders.",
      "human_question": "Who should I meet this week?",
      "agent_questions": [
        "Find companies that could be design partners for my product.",
        "Find VCs investing in my category.",
        "Find builders who want early-stage work."
      ],
      "primary_signals": ["design_partner_fit", "investor_thesis_fit", "hiring_need", "event_overlap"],
      "cta": "Publish my ask"
    },
    {
      "id": "job_seeker",
      "label": "Job seeker",
      "headline": "Find teams likely to be hiring before everyone else sees it.",
      "human_question": "Who just got momentum and may need people?",
      "agent_questions": [
        "Show companies that recently raised or are publicly expanding.",
        "Find startups hiring in AI, product, design, ops, and sales.",
        "Explain why each company may be a good target for me."
      ],
      "primary_signals": ["recent_funding", "open_roles", "team_growth", "category_fit"],
      "cta": "Find warm targets"
    }
  ],
  "signals": [
    {
      "id": "recent-funding",
      "label": "Recent funding",
      "status": "needs_source_enrichment",
      "why_it_matters": "VCs, founders, and job seekers all care because new funding often predicts hiring, partnership, and market momentum.",
      "source_candidates": ["company press pages", "VC portfolio pages", "SEC filings", "startup news pages", "public source search"],
      "agent_output_shape": {
        "company": "string",
        "round": "string",
        "amount": "string_or_null",
        "date": "iso_date_or_null",
        "investors": ["string"],
        "source_url": "https_url",
        "confidence": "high|medium|low"
      }
    },
    {
      "id": "hiring-velocity",
      "label": "Hiring velocity",
      "status": "needs_source_enrichment",
      "why_it_matters": "Hiring is a visible proxy for growth and creates direct value for job seekers and recruiters.",
      "source_candidates": ["company careers pages", "Greenhouse/Lever public boards", "founder posts", "public source fetch"],
      "agent_output_shape": {
        "company": "string",
        "open_roles_count": "number",
        "role_clusters": ["engineering", "product", "design", "sales", "ops"],
        "source_url": "https_url",
        "confidence": "high|medium|low"
      }
    },
    {
      "id": "founder-ask",
      "label": "Founder ask",
      "status": "claim_or_public_source_required",
      "why_it_matters": "The map becomes useful when a founder's agent can say what they need: users, hires, capital, partners, or advice.",
      "source_candidates": ["claimed Hi inbox", "company website", "public founder posts", "event pages"],
      "agent_output_shape": {
        "owner": "company_or_founder",
        "ask": "string",
        "offer": "string",
        "urgency": "now|soon|watch",
        "source_url": "https_url_or_claimed_profile",
        "confidence": "high|medium|low"
      }
    }
  ]
}