the workflow library

t4-deep-research-brief

{"t2-invoice-chaser":"nika: v1\nworkflow:\n  id: invoice-chaser\n  description: \"Ledger CSV → overdue filter → drafted reminders → human gate → drafts file\"\n\nmodel: ollama/qwen3.5:4b   # local · zero key · swap for groq/llama-3.3-70b (drafting is a fast-model job)\n\nvars:\n  ledger_csv: \"./finance/invoices.csv\"\n\ntasks:\n  ledger:\n    invoke:\n      tool: \"nika:read\"\n      args: { path: \"${{ vars.ledger_csv }}\" }\n\n  rows:\n    with:\n      csv: ${{ tasks.ledger.output }}\n    invoke:\n      tool: \"nika:convert\"\n      args:\n        input: \"${{ with.csv }}\"\n        from: csv\n        to: json\n        has_header: true\n\n  overdue:\n    with:\n      rows: ${{ tasks.rows.output }}\n    invoke:\n      tool: \"nika:jq\"\n      args:\n        input: \"${{ with.rows }}\"\n        expression: 'map(select(.status == \"overdue\"))'\n\n  drafts:\n    with:\n      overdue: ${{ tasks.overdue.output }}\n    when: ${{ size(with.overdue) > 0 }}\n    infer:\n      prompt: |\n        Draft one short, polite payment reminder per overdue invoice ·\n        ${{ with.overdue }}\n        Markdown · one section per client · firm but warm.\n\n  approve:\n    with:\n      drafts: ${{ tasks.drafts.output }}\n    when: ${{ with.drafts != null }}   # nothing drafted · nothing to approve\n    invoke:\n      tool: \"nika:prompt\"\n      args:\n        message: \"Save the reminder drafts for sending?\"\n        default: false\n\n  save:\n    with:\n      drafts: ${{ tasks.drafts.output }}\n      approved: ${{ tasks.approve.output }}\n    when: ${{ with.drafts != null && with.approved == true }}   # zero overdue → drafts skipped (null) · don't write nothing\n    invoke:\n      tool: \"nika:write\"\n      args:\n        path: \"./finance/reminders-to-send.md\"\n        content: \"${{ with.drafts }}\"\n\noutputs:\n  overdue:\n    value: ${{ tasks.overdue.output }}\n    description: \"The overdue rows the reminders were drafted for\"\n","t4-deep-research-brief":"nika: v1\nworkflow:\n  id: deep-research-brief\n  description: \"plan → budgeted research agent → thinking synthesis → brief on disk\"\n\nmodel: ollama/qwen3.5:4b   # local default · per-task overrides below pick stronger models\n\nvars:\n  topic:\n    type: string\n    required: true\n    description: \"What to research\"\n\ntasks:\n  plan:\n    infer:\n      model: anthropic/claude-haiku-4-5    # planning is a fast-model job\n      prompt: \"Break '${{ vars.topic }}' into 4 sharp research queries · no overlap.\"\n      schema:\n        type: object\n        required: [queries]\n        properties:\n          queries:\n            type: array\n            items: { type: string }\n\n  investigate:\n    with:\n      plan_queries: ${{ tasks.plan.output.queries }}\n    agent:\n      system: |\n        You are a rigorous researcher. Work the queries one by one ·\n        fetch sources · keep verbatim quotes · note what each source\n        actually supports. Call nika:done when the plan is exhausted.\n      prompt: \"Research plan · ${{ with.plan_queries }}\"\n      tools:\n        - \"nika:fetch\"                 # the web\n        - \"nika:write\"                 # scratch notes\n        - \"nika:done\"                  # the loop-completion sentinel\n      max_turns: 25\n      max_tokens_total: 150000\n      schema:\n        type: object\n        required: [findings, sources]\n        properties:\n          findings:\n            type: array\n            items: { type: string }\n          sources:\n            type: array\n            items: { type: string }\n\n  brief:\n    with:\n      investigate_findings: ${{ tasks.investigate.output.findings }}\n      investigate_sources: ${{ tasks.investigate.output.sources }}\n    infer:\n      prompt: |\n        Findings · ${{ with.investigate_findings }}\n        Sources · ${{ with.investigate_sources }}\n        Write the executive brief · what's true · what's contested ·\n        what it means · what to do. Two pages max.\n      thinking:\n        enabled: true\n        budget_tokens: 8000\n\n  save:\n    with:\n      brief: ${{ tasks.brief.output }}\n    invoke:\n      tool: \"nika:write\"\n      args:\n        path: \"./research/${{ vars.topic }}.md\"\n        content: \"${{ with.brief }}\"\n        create_dirs: true\n\noutputs:\n  brief: ${{ tasks.brief.output }}\n  sources:\n    value: ${{ tasks.investigate.output.sources }}\n    description: \"Every source the agent actually used\"\n","t3-localization-factory":"nika: v1\nworkflow:\n  id: localization-factory\n  description: \"glob docs → parallel read → parallel translate → mirror tree\"\n\nmodel: ollama/qwen3.5:4b   # local default · swap for mistral/mistral-large (EU model for EU locales)\n\nvars:\n  lang: \"fr\"\n  source_glob: \"./docs/**/*.md\"\n\ntasks:\n  files:\n    invoke:\n      tool: \"nika:glob\"\n      args:\n        pattern: \"${{ vars.source_glob }}\"\n        exclude: [\"**/node_modules/**\"]\n\n  texts:\n    with:\n      files: ${{ tasks.files.output }}\n    for_each: ${{ with.files }}\n    max_parallel: 8\n    invoke:\n      tool: \"nika:read\"\n      args: { path: \"${{ item }}\" }\n\n  pairs:\n    with:\n      files: ${{ tasks.files.output }}\n      texts: ${{ tasks.texts.output }}\n    invoke:\n      tool: \"nika:jq\"\n      args:\n        input: [\"${{ with.files }}\", \"${{ with.texts }}\"]\n        expression: \"transpose | map({path: .[0], text: .[1]})\"\n\n  translated:\n    with:\n      pairs: ${{ tasks.pairs.output }}\n    for_each: ${{ with.pairs }}\n    max_parallel: 3                    # rate-limit the provider\n    fail_fast: false                   # finish the batch · a failed file yields null at its index\n    on_error:\n      recover: null                    # null keeps the transpose zip aligned (order preserved)\n    infer:\n      prompt: |\n        Translate to ${{ vars.lang }} · keep markdown structure, code blocks\n        untouched, and the original tone ·\n        ${{ item.text }}\n\n  bundle:\n    with:\n      pairs: ${{ tasks.pairs.output }}\n      translated: ${{ tasks.translated.output }}\n    invoke:\n      tool: \"nika:jq\"\n      args:\n        input: [\"${{ with.pairs }}\", \"${{ with.translated }}\"]\n        expression: \"transpose | map(select(.[1] != null)) | map({path: .[0].path, text: .[1]})\"\n\n  mirror:\n    with:\n      bundle: ${{ tasks.bundle.output }}\n    for_each: ${{ with.bundle }}\n    max_parallel: 8\n    invoke:\n      tool: \"nika:write\"\n      args:\n        path: \"./i18n/${{ vars.lang }}/${{ item.path }}\"\n        content: \"${{ item.text }}\"\n        create_dirs: true\n\noutputs:\n  files:\n    value: ${{ tasks.files.output }}\n    description: \"Every source file that was mirrored\"\n"}

an agent works the web inside hard caps, then the brief. A pack showcase file, shown whole to read; nika run t4-deep-research-brief.nika.yaml is the honest affordance — this site never fabricates a replay for it.

4tasksthe plan below walks them
4wavesrun together when they can
infer · agent · invokeverbsthe whole grammar it speaks
browseread, then runno fabricated replay

the plan

derived from the file, never drawn by hand

planinfer

investigateagent

briefinfer

saveinvoke

the file, whole

t4-deep-research-brief.nika.yaml

1nika: v12workflow:3  id: deep-research-brief4  description: "plan → budgeted research agent → thinking synthesis → brief on disk"56model: ollama/qwen3.5:4b   # local default · per-task overrides below pick stronger models78vars:9  topic:10    type: string11    required: true12    description: "What to research"1314tasks:15  plan:16    ◇infer:17      model: anthropic/claude-haiku-4-5    # planning is a fast-model job18      prompt: "Break '${{ vars.topic }}' into 4 sharp research queries · no overlap."19      schema:20        type: object21        required: [queries]22        properties:23          queries:24            type: array25            items: { type: string }2627  investigate:28    with:29      plan_queries: ${{ tasks.plan.output.queries }}30    ✦agent:31      system: |32        You are a rigorous researcher. Work the queries one by one ·33        fetch sources · keep verbatim quotes · note what each source34        actually supports. Call nika:done when the plan is exhausted.35      prompt: "Research plan · ${{ with.plan_queries }}"36      tools:37        - "nika:fetch"                 # the web38        - "nika:write"                 # scratch notes39        - "nika:done"                  # the loop-completion sentinel40      max_turns: 2541      max_tokens_total: 15000042      schema:43        type: object44        required: [findings, sources]45        properties:46          findings:47            type: array48            items: { type: string }49          sources:50            type: array51            items: { type: string }5253  brief:54    with:55      investigate_findings: ${{ tasks.investigate.output.findings }}56      investigate_sources: ${{ tasks.investigate.output.sources }}57    ◇infer:58      prompt: |59        Findings · ${{ with.investigate_findings }}60        Sources · ${{ with.investigate_sources }}61        Write the executive brief · what's true · what's contested ·62        what it means · what to do. Two pages max.63      thinking:64        enabled: true65        budget_tokens: 80006667  save:68    with:69      brief: ${{ tasks.brief.output }}70    ◆invoke:71      tool: "nika:write"72      args:73        path: "./research/${{ vars.topic }}.md"74        content: "${{ with.brief }}"75        create_dirs: true7677outputs:78  brief: ${{ tasks.brief.output }}79  sources:80    value: ${{ tasks.investigate.output.sources }}81    description: "Every source the agent actually used"82

lines 35–40: agent: three tools granted, caps it cannot exceed. Source: the spec pack · open it in the playground →

Watch the recorded one replay on the home page, walk the showcase gallery, or install and run the file yourself.