Skip to content

feat: Add research-decision-brief-agent template - #340

Open
yooumarr wants to merge 4 commits into
Lamatic:mainfrom
yooumarr:feat/research-decision-brief-agent
Open

feat: Add research-decision-brief-agent template#340
yooumarr wants to merge 4 commits into
Lamatic:mainfrom
yooumarr:feat/research-decision-brief-agent

Conversation

@yooumarr

@yooumarr yooumarr commented Aug 11, 2026

Copy link
Copy Markdown

Summary

Adds a new template: research-decision-brief-agent.

This template converts research evidence into an actionable decision brief for product and engineering teams, including:

  • options analysis,
  • tradeoffs,
  • risk and confidence scoring,
  • recommendation,
  • short validation plan.

Why this is useful

Teams often have paper summaries but no clear implementation direction. This template bridges that gap by producing decision-ready output instead of plain summarization.

Included files

  • kits/research-decision-brief-agent/lamatic.config.ts
  • kits/research-decision-brief-agent/agent.md
  • kits/research-decision-brief-agent/README.md
  • kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts
  • kits/research-decision-brief-agent/constitutions/default.md
  • kits/research-decision-brief-agent/prompts/research-decision-brief-agent_assess-evidence_system.md
  • kits/research-decision-brief-agent/prompts/research-decision-brief-agent_assess-evidence_user.md
  • kits/research-decision-brief-agent/model-configs/research-decision-brief-agent_assess-evidence.ts
  • kits/research-decision-brief-agent/.gitignore
  • Added the research-decision-brief-agent template.
  • Added configuration, documentation, constitution, prompts, model configuration, and .gitignore files.
  • Added a triggerNode that accepts structured research objectives, constraints, timeline, audience, and evidence.
  • Added a dynamicNode that uses gpt-4o-mini to assess evidence and generate a decision brief.
  • Added an API response node that returns the brief as decision_brief.
  • Connected the nodes with defaultEdge and responseEdge flow transitions.
  • The flow produces a Markdown brief with evidence analysis, at least three options, tradeoffs, a recommendation, confidence, risks, mitigations, a two-week validation plan, and open questions.

@coderabbitai

coderabbitai Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Important

Review skipped

No new commits to review since the last review.

⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: f4fc590f-0811-4866-bfea-0eaea6ad2a71

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Walkthrough

The change adds a Research Decision Brief Agent template. It defines the agent contract and safeguards, connects structured research input to an evidence-assessment LLM flow, and documents configuration, invocation, and output behavior.

Changes

Research Decision Brief Agent

Layer / File(s) Summary
Brief contracts and evidence guidance
kits/research-decision-brief-agent/agent.md, kits/research-decision-brief-agent/constitutions/default.md, kits/research-decision-brief-agent/prompts/*
Defines agent capabilities, safety rules, evidence handling, input placeholders, and structured markdown output requirements.
Evidence-assessment flow
kits/research-decision-brief-agent/flows/..., kits/research-decision-brief-agent/model-configs/*
Connects the API trigger to the evidence-assessment LLM and maps its generated result to decision_brief.
Template wiring and documentation
kits/research-decision-brief-agent/lamatic.config.ts, kits/research-decision-brief-agent/README.md, kits/research-decision-brief-agent/.gitignore
Adds template metadata, setup and extension documentation, and ignore rules for environment, build, coverage, and log files.

Suggested reviewers: amanintech, d-pamneja

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description explains the template and lists its files, but it omits the required PR Checklist sections and validation status. Add the completed PR Checklist, including contribution type, general requirements, applicable file structure checks, and validation results.
✅ Passed checks (4 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly identifies the addition of the research-decision-brief-agent template.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown
Contributor

:robot_face: AgentKit Structural Validation

New Contributions Detected

  • Template: kits/research-decision-brief-agent

Check Results

Check Status
No edits to existing kits ✅ Pass
Required root files present ✅ Pass
Flow .ts files present ✅ Pass
lamatic.config.ts valid ✅ Pass
No changes outside kits/ ✅ Pass

🎉 All checks passed! This contribution follows the AgentKit structure.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@kits/research-decision-brief-agent/.gitignore`:
- Around line 1-2: Update the environment-file patterns in .gitignore so .env
and its .env.* variants are ignored, while explicitly allowing example
environment files such as .env.example to remain trackable.

In `@kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts`:
- Around line 41-51: Update the triggerNode_1 inline request schema by defining
advance_schema with fields for objective, constraints, timeline, audience, and
evidence, matching the inputs referenced by the prompt while preserving the
existing trigger configuration.

In
`@kits/research-decision-brief-agent/model-configs/research-decision-brief-agent_assess-evidence.ts`:
- Around line 4-8: Replace the recursive configuration in
kits/research-decision-brief-agent/model-configs/research-decision-brief-agent_assess-evidence.ts
by regenerating generativeModelName from Studio with a concrete provider and
model, while preserving Studio-generated credential identifiers. In
kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts lines
75-78, set memories and messages to "[]".

In `@kits/research-decision-brief-agent/README.md`:
- Line 3: Add one blank line after each Markdown section heading in the README,
including “Problem Statement” and the headings at the referenced locations, so
the document satisfies markdownlint MD022 without changing the section content.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: b75be8f2-eaa2-441e-9ff2-cee971192f3f

📥 Commits

Reviewing files that changed from the base of the PR and between e8f04eb and e961798.

📒 Files selected for processing (9)
  • kits/research-decision-brief-agent/.gitignore
  • kits/research-decision-brief-agent/README.md
  • kits/research-decision-brief-agent/agent.md
  • kits/research-decision-brief-agent/constitutions/default.md
  • kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts
  • kits/research-decision-brief-agent/lamatic.config.ts
  • kits/research-decision-brief-agent/model-configs/research-decision-brief-agent_assess-evidence.ts
  • kits/research-decision-brief-agent/prompts/research-decision-brief-agent_assess-evidence_system.md
  • kits/research-decision-brief-agent/prompts/research-decision-brief-agent_assess-evidence_user.md

Comment thread kits/research-decision-brief-agent/.gitignore
Comment thread kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts Outdated
Comment thread kits/research-decision-brief-agent/README.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts (1)

83-95: 🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Use responseNode for graphqlResponseNode

Set this node’s type to "responseNode". The current "dynamicNode" type does not declare the API response node, so the responseEdge and output mapping may not produce the flow response.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts`
around lines 83 - 95, Update the node with id "graphqlResponseNode_201" and
nodeName "API Response" to use type "responseNode" instead of "dynamicNode",
preserving its existing responseEdge compatibility and outputMapping.
♻️ Duplicate comments (1)
kits/research-decision-brief-agent/model-configs/research-decision-brief-agent_assess-evidence.ts (1)

5-10: 🗄️ Data Integrity & Integration | 🟠 Major | 🏗️ Heavy lift

Mission requirement: complete the model configuration before deployment.

generativeModelName omits the provider and credential metadata present in the supplied Studio-generated configuration contract. The flow references this artifact, so the LLM node may not resolve a provider credential at runtime.

Regenerate this configuration in Lamatic Studio with a valid provider and credential. Do not hand-edit credential identifiers.

This repeats the earlier model-configuration finding; the current change adds a model name but does not complete the configuration.

#!/bin/bash
set -euo pipefail

rg -n -C 6 \
  'generativeModelName|model_name|provider_name|credentialId|credential_name' \
  kits --glob 'model-configs/*.ts'

Based on learnings: Preserve Studio-generated credential identifiers and regenerate the artifact instead of editing identifiers manually.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@kits/research-decision-brief-agent/model-configs/research-decision-brief-agent_assess-evidence.ts`
around lines 5 - 10, Complete the generativeModelName configuration with the
provider and credential metadata required by the Studio-generated contract,
using a valid configuration regenerated from Lamatic Studio. Do not manually
invent or edit credential identifiers; preserve the generated provider_name,
credentialId, and credential_name values.

Source: Learnings

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Outside diff comments:
In `@kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts`:
- Around line 83-95: Update the node with id "graphqlResponseNode_201" and
nodeName "API Response" to use type "responseNode" instead of "dynamicNode",
preserving its existing responseEdge compatibility and outputMapping.

---

Duplicate comments:
In
`@kits/research-decision-brief-agent/model-configs/research-decision-brief-agent_assess-evidence.ts`:
- Around line 5-10: Complete the generativeModelName configuration with the
provider and credential metadata required by the Studio-generated contract,
using a valid configuration regenerated from Lamatic Studio. Do not manually
invent or edit credential identifiers; preserve the generated provider_name,
credentialId, and credential_name values.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 19c5b3f3-8ee3-4c66-aae5-b0a897f2ec82

📥 Commits

Reviewing files that changed from the base of the PR and between e961798 and a4f626c.

📒 Files selected for processing (4)
  • kits/research-decision-brief-agent/.gitignore
  • kits/research-decision-brief-agent/README.md
  • kits/research-decision-brief-agent/flows/research-decision-brief-agent.ts
  • kits/research-decision-brief-agent/model-configs/research-decision-brief-agent_assess-evidence.ts

@akshatvirmani

Copy link
Copy Markdown
Contributor

/validate

@github-actions

Copy link
Copy Markdown
Contributor

📡 Running Studio validation — results will appear here shortly.

@github-actions

Copy link
Copy Markdown
Contributor

Studio Runtime Validation (Phase 2)

Studio validation failed. The kit was rejected by Lamatic Studio.

Errors

research-decision-brief-agent

  • Flow: research-decision-brief-agent — config_json.nodes must be a non-empty array

Please fix the errors above and push a new commit to re-run validation.
Refer to CONTRIBUTING.md for guidance.

@akshatvirmani

Copy link
Copy Markdown
Contributor

@yooumarr please check the above error

@akshatvirmani

Copy link
Copy Markdown
Contributor

/validate

@github-actions

Copy link
Copy Markdown
Contributor

📡 Running Studio validation — results will appear here shortly.

@github-actions

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor
⚠️ Action not completed

Already reviewed.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@akshatvirmani

Copy link
Copy Markdown
Contributor

/validate

@github-actions

Copy link
Copy Markdown
Contributor

📡 Running Studio validation — results will appear here shortly.

1 similar comment
@github-actions

Copy link
Copy Markdown
Contributor

📡 Running Studio validation — results will appear here shortly.

@akshatvirmani

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor
⚠️ Action not completed

Already reviewed.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants