Skip to content

feat: Add personalized-outreach-agent template#190

Open
Ganesh-0509 wants to merge 2 commits into
Lamatic:mainfrom
Ganesh-0509:feat/personalized-outreach-agent
Open

feat: Add personalized-outreach-agent template#190
Ganesh-0509 wants to merge 2 commits into
Lamatic:mainfrom
Ganesh-0509:feat/personalized-outreach-agent

Conversation

@Ganesh-0509

@Ganesh-0509 Ganesh-0509 commented Jul 7, 2026

Copy link
Copy Markdown

Summary

Adds Personalized Outreach Agent — a template (single flow, 4 nodes) that writes personalized job-outreach messages that never lie about the candidate.

Most LLM outreach tools happily exaggerate — inventing skills or experience the candidate doesn't have. This flow fixes that with a write → verify → rewrite loop:

  1. Writer node drafts a warm, personalized message from a company brief and the candidate's real profile.
  2. Verifier node fact-checks every claim against that profile, removes or softens anything unsupported, and returns a transparent verification report showing what it kept and what it stripped.

It's an anti-hallucination guardrail applied to an everyday task — the "verify/optimize" side of building trustworthy agentic apps.

Contribution Type

  • Template (kits/personalized-outreach-agent/)

Flow (4 nodes)

API RequestLLM (Writer)LLM (Verifier)API Response

Inputs: companyInfo, candidateProfile · Output: verified message + verification report

Checklist

  • One project only, no unrelated changes
  • No API keys / secrets committed
  • kebab-case folder matching the flow ID
  • Documented in README.md + agent.md
  • lamatic.config.ts with valid metadata (type: template)
  • Flow is a Lamatic Studio export (node graph not hand-edited)

Built, deployed, and tested in Lamatic Studio.

  • Added a new kits/personalized-outreach-agent/ template for a “Personalized Outreach Agent” workflow that drafts personalized job outreach from a company brief and candidate profile, then verifies the draft against the candidate’s real experience to remove or soften unsupported claims.
  • Added the flow definition in flows/personalized-outreach-agent.ts, defining a 4-node sequence: API Request trigger → LLM writer → LLM verifier → API Response, with a response mapping back to the verifier output.
  • Added template metadata in lamatic.config.ts, marking the kit as a template and registering the personalized-outreach-agent step.
  • Added documentation in README.md and agent.md explaining the inputs, write/verify flow, output format, usage steps, and prompt/reference conventions.
  • Added a default constitution in constitutions/default.md covering safety, data handling, and tone rules for the agent.
  • Added node-specific prompt files for the writer and verifier LLMs, including runtime variable bindings for companyInfo, candidateProfile, and the draft message.
  • Added model config files for both LLM nodes, wiring them to the configured OpenRouter GPT-5 chat model.
  • Added a .gitignore to exclude .lamatic/, node_modules/, and local env files.

@coderabbitai

coderabbitai Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@Ganesh-0509, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 37 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

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

Review profile: ASSERTIVE

Plan: Pro

Run ID: 29a6ca2e-e844-4e15-96ed-d79946912aea

📥 Commits

Reviewing files that changed from the base of the PR and between bc672e0 and b93d14f.

📒 Files selected for processing (2)
  • kits/personalized-outreach-agent/README.md
  • kits/personalized-outreach-agent/prompts/personalized-outreach-agent_llmnode-613_system_0.md

Walkthrough

Mission briefing: this dossier adds a new “Personalized Outreach Agent” kit. It defines the flow, model configs, prompts, constitution, template config, ignore rules, and documentation for a write-verify-rewrite outreach pipeline.

Changes

Personalized Outreach Agent Kit

Layer / File(s) Summary
Flow definition: metadata, inputs, references, nodes, edges
kits/personalized-outreach-agent/flows/personalized-outreach-agent.ts
Exports flow metadata, inputs, references, nodes, edges, and the default export wiring a trigger node through two LLM nodes to a response node.
LLM model configurations for both nodes
kits/personalized-outreach-agent/model-configs/personalized-outreach-agent_llmnode-119_generative-model-name.ts, kits/personalized-outreach-agent/model-configs/personalized-outreach-agent_llmnode-613_generative-model-name.ts
Defines generator/text configs for both nodes, including token limits, model name, and OpenRouter credential/provider fields.
Writer and verifier prompt templates
kits/personalized-outreach-agent/prompts/*
Adds system and user prompts for the writer node and verifier node, including runtime placeholders and the verified-message/report output format.
Constitution and template config
kits/personalized-outreach-agent/constitutions/default.md, kits/personalized-outreach-agent/lamatic.config.ts
Adds baseline identity, safety, data-handling, and tone rules, plus the template config declaring the kit step and GitHub link.
Kit documentation and gitignore
kits/personalized-outreach-agent/README.md, kits/personalized-outreach-agent/agent.md, kits/personalized-outreach-agent/.gitignore
Adds kit documentation for the workflow and usage, plus ignore rules for .lamatic/, node_modules/, and local env files.

Suggested reviewers: amanintech, d-pamneja

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 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 and concisely describes the main change: adding the personalized outreach agent template.
Description check ✅ Passed The description covers the template type, flow behavior, inputs/outputs, documentation, metadata, and validation status.
✨ 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

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

:robot_face: AgentKit Structural Validation

New Contributions Detected

  • Template: kits/personalized-outreach-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.

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Failure recorded at 2026-07-07T17:09:46Z UTC. If this PR is not fixed within 4 weeks it will be automatically closed.

@Ganesh-0509 Ganesh-0509 force-pushed the feat/personalized-outreach-agent branch from 496dded to c10f70c Compare July 7, 2026 17:29
A self-fact-checking outreach writer. It drafts a personalized job-outreach
message from a company brief and the candidate's real profile, then a Verifier
step audits every claim against that profile, removes anything unsupported, and
returns a transparent verification report alongside the corrected message.

Contribution type: template (single flow, 4 nodes).
@Ganesh-0509 Ganesh-0509 force-pushed the feat/personalized-outreach-agent branch from c10f70c to bc672e0 Compare July 7, 2026 17:31

@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: 2

🤖 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/personalized-outreach-agent/prompts/personalized-outreach-agent_llmnode-613_system_0.md`:
- Around line 12-14: The verifier format in the prompt includes an extra
trailing character that should be removed so the output contract is exact and
unambiguous. Update the instructions around the claim-checking format in the
personalized-outreach-agent prompt so the final line ends cleanly with the
intended sentence, and verify the surrounding wording still clearly references
the supported/removed bullet format and the “All claims verified against the
profile — nothing removed.” fallback.

In `@kits/personalized-outreach-agent/README.md`:
- Around line 34-42: The README example uses an unlabeled fenced code block,
which triggers the markdownlint warning. Update the example fence in the
verification section to use a text label so the docs stay lint-clean. Make this
change in the markdown snippet that shows the VERIFIED MESSAGE and VERIFICATION
REPORT, keeping the content the same and only adjusting the fence label.
🪄 Autofix (Beta)

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

Run ID: 8dab9ad2-fcc1-4fd7-a23d-13af7e54071d

📥 Commits

Reviewing files that changed from the base of the PR and between dafde4c and c10f70c.

📒 Files selected for processing (12)
  • kits/personalized-outreach-agent/.gitignore
  • kits/personalized-outreach-agent/README.md
  • kits/personalized-outreach-agent/agent.md
  • kits/personalized-outreach-agent/constitutions/default.md
  • kits/personalized-outreach-agent/flows/personalized-outreach-agent.ts
  • kits/personalized-outreach-agent/lamatic.config.ts
  • kits/personalized-outreach-agent/model-configs/personalized-outreach-agent_llmnode-119_generative-model-name.ts
  • kits/personalized-outreach-agent/model-configs/personalized-outreach-agent_llmnode-613_generative-model-name.ts
  • kits/personalized-outreach-agent/prompts/personalized-outreach-agent_llmnode-119_system_0.md
  • kits/personalized-outreach-agent/prompts/personalized-outreach-agent_llmnode-119_user_1.md
  • kits/personalized-outreach-agent/prompts/personalized-outreach-agent_llmnode-613_system_0.md
  • kits/personalized-outreach-agent/prompts/personalized-outreach-agent_llmnode-613_user_1.md

Comment thread kits/personalized-outreach-agent/README.md Outdated
@Ganesh-0509

Copy link
Copy Markdown
Author

Thanks for the review! Addressed both points in b93d14f:

  • Removed the stray trailing > in the verifier prompt's output-format block.
  • Labeled the README example code fence as text to satisfy markdownlint (MD040).

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Hi @Ganesh-0509! 👋

Before this PR can be reviewed by maintainers, please resolve all comments and requested changes from the CodeRabbit automated review.

Steps to follow:

  1. Read through all CodeRabbit comments carefully
  2. Address each issue raised (or reply explaining why you disagree)
  3. Push your fixes as new commits
  4. Once all issues are resolved, comment here so we can re-review

This helps keep the review process efficient for everyone. Thank you! 🙏

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.

1 participant