Skip to content

Conversation

@awlevin
Copy link
Contributor

@awlevin awlevin commented Dec 1, 2025

Summary

This PR adds the recent-workflow-doc-creator workflow as an example in the examples/workflows directory.

About This Workflow

The Recent Workflow Documentation Creator is a scheduled workflow that automatically creates GitHub pull requests to document recently deployed Vellum workflows. It demonstrates several advanced Vellum patterns:

Key Features

  • Scheduled Trigger: Runs daily at 10:00 AM Mountain Time using a cron schedule
  • Map Node Pattern: Processes multiple deployments concurrently (max concurrency of 4)
  • Tool-Calling Agent: Uses Claude with GitHub integration tools (via Composio) to:
    • Create new branches
    • Commit workflow code and README files
    • Open pull requests
  • Parallel Outputs: Returns multiple outputs simultaneously (PR URLs, comments, deployments JSON)

Workflow Flow

Scheduled Trigger → FetchRecentDeployments → ProcessDeployments (Map) → {
    DeploymentsOutput,
    CommentsOutput,
    PrUrlsOutput
}

Why This Example is Useful

  1. Demonstrates scheduled workflows with cron triggers
  2. Shows how to use Map Nodes for parallel processing with subworkflows
  3. Illustrates Tool-Calling Nodes with external integrations (GitHub via Composio)
  4. Examples of custom node displays with icons and colors
  5. Shows accessing the Vellum client context for API calls within nodes

This workflow is perfect for teams who want to automate documentation of their workflows as they're deployed.

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +3 to +6
from .nodes.comments_output import CommentsOutput
from .nodes.deployments_output import DeploymentsOutput
from .nodes.fetch_recent_deployments import FetchRecentDeployments
from .nodes.pr_urls_output import PrUrlsOutput

Choose a reason for hiding this comment

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

P1 Badge Provide missing node/trigger modules for workflow

The new example workflow imports .nodes.* and .triggers.scheduled, but the recent-workflow-doc-creator directory only contains README.md and workflow.py (no nodes/ or triggers/ subpackages anywhere in the repo per rg/ls). Importing this workflow will immediately raise ModuleNotFoundError, so the example cannot run or be opened in the SDK. Please add the referenced node and trigger definitions or adjust the imports.

Useful? React with 👍 / 👎.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants