Back to recipes

research-brief-recipe

Compose a deterministic research brief from reusable give.md skills.

Recipe JSON: https://api.give.md/v1/give/recipes/web/recipes-live.example/research-brief-recipe@1.0.427100

Publisher: web:recipes-live.example

Namespace: web/recipes-live.example

Supported runtimes: codex, claude

Required tools: fetch, markdown

Permissions: http:get, storage:write

Recipe definition

Goal: Produce a source-backed brief with citations and a next-action summary.

Parameters

• topic · string · required · Topic to research
• audience · enum · Who the brief is for

Preferred dependencies: ens/alice.eth/research-agent@1.0.0, gh/givemd-labs/finance/treasury-brief-agent@1.0.0

Fallback dependencies: web/give.md/policy-watchdog@1.0.0

Cost caps: 0.25 USDC

Stop conditions: No credible sources found

{
  "packageId": "web/recipes-live.example/research-brief-recipe@1.0.427100",
  "namespaceId": "web/recipes-live.example",
  "canonicalPath": "web/recipes-live.example/research-brief-recipe@1.0.427100",
  "packageSlug": "research-brief-recipe",
  "version": "1.0.427100",
  "contentHash": "sha256:0f6cf0172182002ba5119ce89026dcda822c33aba82abf4a997900cccea626a8",
  "ipfsMirror": {
    "cid": "bafkreiapntyboimcaav2kem45cicnxg2qiwdhk5ifk7uvglzadgm5jrgva",
    "uri": "ipfs://bafkreiapntyboimcaav2kem45cicnxg2qiwdhk5ifk7uvglzadgm5jrgva",
    "gatewayUrl": "https://w3s.link/ipfs/bafkreiapntyboimcaav2kem45cicnxg2qiwdhk5ifk7uvglzadgm5jrgva",
    "contentHash": "sha256:0f6cf0172182002ba5119ce89026dcda822c33aba82abf4a997900cccea626a8",
    "contentType": "text/markdown; charset=utf-8",
    "mirroredAt": "2026-03-15T13:13:48.107Z",
    "status": "published",
    "provider": "deterministic",
    "publishedAt": "2026-03-15T13:13:54.992Z"
  },
  "publisherBinding": "web:recipes-live.example",
  "verificationState": "stale",
  "verificationMethod": "fixture",
  "importedAt": "2026-03-15T13:13:48.107Z",
  "updatedAt": "2026-03-17T09:22:35.122Z",
  "schemaMode": "give-v1",
  "inferredFields": [],
  "compatibilityWarnings": [],
  "frontmatter": {
    "type": "recipe",
    "name": "research-brief-recipe",
    "version": "1.0.427100",
    "description": "Compose a deterministic research brief from reusable give.md skills.",
    "publisher": "web:recipes-live.example",
    "permissions": [
      "http:get",
      "storage:write"
    ],
    "required_tools": [
      "fetch",
      "markdown"
    ],
    "supported_runtimes": [
      "codex",
      "claude"
    ],
    "tests": [
      "Assembles the research brief plan",
      "Carries forward safeguards and budget"
    ],
    "artifact_hashes": {
      "recipe.md": "sha256:fixture-recipe-plan",
      "inputs.json": "sha256:fixture-recipe-inputs"
    },
    "parameters": [
      {
        "id": "topic",
        "type": "string",
        "required": true,
        "description": "Topic to research"
      },
      {
        "id": "audience",
        "type": "enum",
        "description": "Who the brief is for",
        "default": "operator",
        "values": [
          "operator",
          "governance"
        ]
      }
    ],
    "goal": "Produce a source-backed brief with citations and a next-action summary.",
    "preferred_dependencies": [
      "ens/alice.eth/research-agent@1.0.0",
      "gh/givemd-labs/finance/treasury-brief-agent@1.0.0"
    ],
    "fallback_dependencies": [
      "web/give.md/policy-watchdog@1.0.0"
    ],
    "cost_caps": [
      "0.25 USDC"
    ],
    "stop_conditions": [
      "No credible sources found"
    ],
    "caching_hints": [
      "cache fetched sources for one hour"
    ],
    "escalation_thresholds": [
      "Escalate after three failed fetches"
    ],
    "steps": [],
    "policy_hooks": [],
    "approval_points": [],
    "handoffs": [],
    "receipt_checkpoints": [],
    "output_expectations": [],
    "invokes": []
  },
  "body": "# Research Brief Recipe\n\nUse this recipe to orchestrate a repeatable research brief from trusted give.md skills.\n\n## Flow\n\n1. Gather source-backed notes with a verified research skill.\n2. Synthesize the notes into a concise markdown brief.\n3. Stop and escalate if the recipe cannot find enough credible sources.",
  "markdown": "---\ntype: recipe\nname: research-brief-recipe\nversion: 1.0.427100\ndescription: Compose a deterministic research brief from reusable give.md skills.\npublisher: web:recipes-live.example\npermissions: [\"http:get\",\"storage:write\"]\nrequired_tools: [\"fetch\",\"markdown\"]\nsupported_runtimes: [\"codex\",\"claude\"]\ntests: [\"Assembles the research brief plan\",\"Carries forward safeguards and budget\"]\nartifact_hashes: {\"recipe.md\":\"sha256:fixture-recipe-plan\",\"inputs.json\":\"sha256:fixture-recipe-inputs\"}\nparameters: [{\"id\":\"topic\",\"type\":\"string\",\"required\":true,\"description\":\"Topic to research\"},{\"id\":\"audience\",\"type\":\"enum\",\"description\":\"Who the brief is for\",\"values\":[\"operator\",\"governance\"],\"default\":\"operator\"}]\ngoal: Produce a source-backed brief with citations and a next-action summary.\npreferred_dependencies: [\"ens/alice.eth/research-agent@1.0.0\",\"gh/givemd-labs/finance/treasury-brief-agent@1.0.0\"]\nfallback_dependencies: [\"web/give.md/policy-watchdog@1.0.0\"]\ncost_caps: [\"0.25 USDC\"]\nstop_conditions: [\"No credible sources found\"]\ncaching_hints: [\"cache fetched sources for one hour\"]\nescalation_thresholds: [\"Escalate after three failed fetches\"]\n---\n# Research Brief Recipe\n\nUse this recipe to orchestrate a repeatable research brief from trusted give.md skills.\n\n## Flow\n\n1. Gather source-backed notes with a verified research skill.\n2. Synthesize the notes into a concise markdown brief.\n3. Stop and escalate if the recipe cannot find enough credible sources.\n",
  "attachedPolicy": {
    "policyId": "policy/conservative-usdc@1.0.0",
    "policyHash": "sha256:a363c2c0b513ef0382186d330cc3c9c18071083df98eaddf56f62f0aa8eac6ce",
    "summary": "Allow low-risk Bun or Codex runs with tight USDC and origin limits."
  },
  "receiptStats": {
    "total": 3,
    "success": 3,
    "failed": 0,
    "cancelled": 0,
    "lastReceiptId": "4a1c8089-2d2d-4aa0-ae04-836d8ae70d46",
    "lastCompletedAt": "2026-03-15T16:28:42.774Z"
  },
  "benchmarkStats": {
    "total": 1,
    "success": 1,
    "failed": 0,
    "lastRunId": "6d1c44f4-ab7a-4474-87d0-ee4342b448a9",
    "lastCompletedAt": "2026-03-15T13:13:58.470Z"
  },
  "authorityType": "web",
  "authority": "recipes-live.example",
  "rankingSignalsSnapshot": {
    "verificationScore": 20,
    "declaredTestCount": 2,
    "verifiedReceiptCount": 3,
    "successfulRunReceiptCount": 3,
    "successfulReceiptKindCount": 1,
    "easConfirmedReceiptCount": 0,
    "selfReportedReceiptCount": 0,
    "failedReceiptCount": 0,
    "benchmarkRunCount": 1,
    "successfulBenchmarkCount": 1,
    "successfulBenchmarkTaskCount": 1,
    "benchmarkRuntimeCount": 1,
    "benchmarkSuccessRatePct": 100,
    "averageBenchmarkScorePct": 100,
    "bestBenchmarkScorePct": 100
  },
  "rankingUpdatedAt": "2026-03-17T09:22:35.122Z"
}