Skip to content

feat: add learning path replanner template#187

Open
gitsofyash wants to merge 3 commits into
Lamatic:mainfrom
gitsofyash:main
Open

feat: add learning path replanner template#187
gitsofyash wants to merge 3 commits into
Lamatic:mainfrom
gitsofyash:main

Conversation

@gitsofyash

@gitsofyash gitsofyash commented Jul 7, 2026

Copy link
Copy Markdown

PR Checklist

1. Select Contribution Type

  • Kit
  • Bundle
  • Template

2. General Requirements

  • PR is for one project only
  • No secrets, API keys, or real credentials are committed
  • Folder name uses kebab-case and matches the flow ID: learning-path-replanner
  • All changes are documented in README.md

3. File Structure

  • lamatic.config.ts present with valid metadata
  • Flow exists at flows/learning-path-replanner.ts
  • agent.md present
  • README.md present
  • constitutions/default.md present
  • Prompts and model configs exported
  • No .env or .env.local committed
  • No unrelated files modified

4. Validation

  • Flow tested successfully in Lamatic Studio
  • Deployed flow tested successfully
  • PR title starts with feat:
  • GitHub Actions workflows pass
  • CodeRabbit or other PR review comments are addressed and resolved
  • Added a new kits/learning-path-replanner template package for a “learning path replanner” education workflow.
  • Added lamatic.config.ts with template metadata, tags, required step info, and deployment/GitHub links.
  • Added flows/learning-path-replanner.ts, defining the full flow:
    • triggerNode API request input for student learning context
    • LLMNode_333 to diagnose learning gaps
    • LLMNode_593 to generate an adaptive recovery plan
    • responseNode to return learningDiagnosis and adaptiveRecoveryPlan
  • Added prompt files for both LLM stages:
    • system + user prompts for diagnosis
    • system + user prompts for recovery plan generation
  • Added model config files for both LLM nodes, pinning the Groq llama-3.3-70b-versatile model.
  • Added agent.md describing the agent behavior, required inputs, output shape, and privacy guardrails.
  • Added constitutions/default.md with safety, data handling, and tone rules.
  • Added README.md documenting purpose, input/output schema, privacy note, and use cases.
  • Added .gitignore entries for .lamatic/, node_modules/, and local env files.

Copilot AI review requested due to automatic review settings July 7, 2026 12:50
@coderabbitai

coderabbitai Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@github-actions[bot], you've reached your PR review limit, so we couldn't start this review.

Next review available in: 59 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: 808f3dfa-575f-4dfd-abe1-7af047f9e449

📥 Commits

Reviewing files that changed from the base of the PR and between 92a7778 and 55d670a.

📒 Files selected for processing (2)
  • kits/learning-path-replanner/model-configs/learning-path-replanner_llmnode-333_generative-model-name.ts
  • kits/learning-path-replanner/model-configs/learning-path-replanner_llmnode-593_generative-model-name.ts

Walkthrough

This PR adds a new "Learning Path Replanner" template under kits/learning-path-replanner, including flow wiring, model configs, prompts, template config, a constitution, and user-facing documentation.

Changes

Learning Path Replanner template

Layer / File(s) Summary
Template config and repo hygiene
kits/learning-path-replanner/lamatic.config.ts, kits/learning-path-replanner/.gitignore
Adds the Lamatic template metadata, tags, mandatory step, and deploy/GitHub links, plus gitignore rules for .lamatic/, node_modules/, and env files.
Flow definition: meta, inputs, references, nodes, edges
kits/learning-path-replanner/flows/learning-path-replanner.ts
Defines flow metadata and test input, two model-selection inputs, file references, trigger/LLM/response nodes, and edges wiring the diagnosis → recovery plan → response execution order.
Model configs for LLM nodes
kits/learning-path-replanner/model-configs/*.ts
Adds generativeModelName configs for llmnode-333 and llmnode-593 specifying the Groq model, provider, and credential identifiers.
Diagnosis and recovery-plan prompts
kits/learning-path-replanner/prompts/*.md
Adds system/user prompt templates for diagnosing learning gaps and generating an adaptive recovery plan, including privacy constraints and structured output formats.
Agent spec, constitution, and README docs
kits/learning-path-replanner/agent.md, kits/learning-path-replanner/constitutions/default.md, kits/learning-path-replanner/README.md
Documents the agent's purpose, flow, inputs/outputs, guardrails, and API response shape; defines assistant identity/safety/data-handling/tone rules; and describes the template's purpose, flow, schema, privacy note, and use cases.

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 Clear and specific: it names the new learning path replanner template and matches the changeset.
Description check ✅ Passed Mostly complete and well structured: it covers contribution type, requirements, file structure, and validation, with only a couple unchecked items left.
✨ 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/learning-path-replanner

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.

Copilot AI 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.

Pull request overview

This PR introduces a new “Learning Path Replanner” kit/template under kits/learning-path-replanner, intended to diagnose a student’s learning gaps and generate an adaptive, day-by-day recovery plan (including micro-lessons and a checkpoint quiz).

Changes:

  • Adds a new Lamatic flow (learning-path-replanner) with two LLM stages: diagnosis → plan generation.
  • Adds prompt assets, model configs, and a default constitution/agent documentation for the template.
  • Adds template packaging metadata (lamatic.config.ts), README, and kit-level .gitignore.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
kits/learning-path-replanner/README.md Documents the template purpose, IO shape, and usage.
kits/learning-path-replanner/prompts/learning-path-replanner_llmnode-333_system_0.md System prompt for the diagnosis node (structured diagnosis output).
kits/learning-path-replanner/prompts/learning-path-replanner_llmnode-333_user_1.md User prompt template feeding trigger inputs into the diagnosis node.
kits/learning-path-replanner/prompts/learning-path-replanner_llmnode-593_system_0.md System prompt for the recovery-plan node (structured plan output).
kits/learning-path-replanner/prompts/learning-path-replanner_llmnode-593_user_1.md User prompt template feeding trigger inputs + diagnosis into the plan node.
kits/learning-path-replanner/model-configs/learning-path-replanner_llmnode-333_generative-model-name.ts Model config for the diagnosis node.
kits/learning-path-replanner/model-configs/learning-path-replanner_llmnode-593_generative-model-name.ts Model config for the recovery-plan node.
kits/learning-path-replanner/lamatic.config.ts Template metadata (name/description/tags/links).
kits/learning-path-replanner/flows/learning-path-replanner.ts Defines the flow graph, references, trigger schema, and response mapping.
kits/learning-path-replanner/constitutions/default.md Adds a baseline constitution (identity/safety/data handling/tone).
kits/learning-path-replanner/agent.md Human-readable agent/template documentation and guardrails.
kits/learning-path-replanner/.gitignore Ignores Lamatic artifacts and local env files for this kit.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +9 to +12
"model_name": "groq/llama-3.3-70b-versatile",
"credentialId": "32548a6b-7257-4e98-b7bc-af545a7de462",
"provider_name": "groq",
"credential_name": "groq"
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

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

Caution

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

⚠️ Outside diff range comments (1)
kits/learning-path-replanner/README.md (1)

1-58: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Add a setup / getting-started section.

This README is a good overview, but it doesn't tell consumers how to install, import, or configure the kit. As per coding guidelines, kits/*/README.md must be a human-readable setup guide.

🤖 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/learning-path-replanner/README.md` around lines 1 - 58, The README is
missing the required setup/getting-started guidance for consumers of the
Learning Path Replanner kit. Update this README to add a human-readable setup
section that explains how to install or add the kit, how to import or invoke the
main workflow, and any required configuration or input expectations; keep the
existing overview but add a clear getting-started path using the kit’s core
concepts like Learning Path Replanner, input schema, and output sections.

Source: Coding guidelines

🤖 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/learning-path-replanner/prompts/learning-path-replanner_llmnode-593_user_1.md`:
- Around line 13-14: The diagnosis placeholder in this prompt is still wired to
the wrong upstream node, so the recovery-plan stage will not receive the actual
diagnosis text. Update the Learning Diagnosis input reference in this prompt to
use LLMNode_333.output.generatedResponse, matching the flow wiring used by the
replanner chain, and ensure the placeholder name stays consistent with the next
node’s expected diagnosis input.

---

Outside diff comments:
In `@kits/learning-path-replanner/README.md`:
- Around line 1-58: The README is missing the required setup/getting-started
guidance for consumers of the Learning Path Replanner kit. Update this README to
add a human-readable setup section that explains how to install or add the kit,
how to import or invoke the main workflow, and any required configuration or
input expectations; keep the existing overview but add a clear getting-started
path using the kit’s core concepts like Learning Path Replanner, input schema,
and output sections.
🪄 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: 4cfe8b95-c88e-4425-ba86-ffdf57a34a2a

📥 Commits

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

📒 Files selected for processing (12)
  • kits/learning-path-replanner/.gitignore
  • kits/learning-path-replanner/README.md
  • kits/learning-path-replanner/agent.md
  • kits/learning-path-replanner/constitutions/default.md
  • kits/learning-path-replanner/flows/learning-path-replanner.ts
  • kits/learning-path-replanner/lamatic.config.ts
  • kits/learning-path-replanner/model-configs/learning-path-replanner_llmnode-333_generative-model-name.ts
  • kits/learning-path-replanner/model-configs/learning-path-replanner_llmnode-593_generative-model-name.ts
  • kits/learning-path-replanner/prompts/learning-path-replanner_llmnode-333_system_0.md
  • kits/learning-path-replanner/prompts/learning-path-replanner_llmnode-333_user_1.md
  • kits/learning-path-replanner/prompts/learning-path-replanner_llmnode-593_system_0.md
  • kits/learning-path-replanner/prompts/learning-path-replanner_llmnode-593_user_1.md

@gitsofyash gitsofyash left a comment

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

I have resolved the issues flagged by the system

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor
✅ Action performed

Review finished.

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