Add multi-workflow support to job definition guidance #190
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Update the define step and templates to support jobs with multiple workflows. This allows a single job to define different execution paths through the same set of steps (e.g., full_analysis vs. quick_summary). Changes: - Add Step 2.5 in define.md to ask about workflow organization - Update job.yml.template with workflows section - Add multi-workflow example to job.yml.example - Add Valid Workflows quality criterion to job_spec.md - Update example dialog to show workflow discovery https://claude.ai/code/session_01Mr1h2fVSKeVP84FDWXx4UM
Focus on the key use case: workflows are for when different parts need to happen at different points in time (human review gates, setup/teardown patterns, phased execution). Remove verbose questions about workflow organization and simplify the example dialog to show a single-workflow job (the common case). https://claude.ai/code/session_01Mr1h2fVSKeVP84FDWXx4UM
Demote from separate "Step 2.5" to a brief note alongside Browser Automation in the existing Capability Considerations section. https://claude.ai/code/session_01Mr1h2fVSKeVP84FDWXx4UM
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Enhanced the
deepwork_jobs.definejob creation process to support and guide users through defining multiple workflows within a single job. This allows jobs to expose different execution paths through the same set of steps, enabling use cases like quick summaries, full analyses, and refresh-only workflows.Key Changes
New Step 2.5 in define.md: Added structured workflow organization guidance that asks users about different ways to use their steps and when to create multiple workflows
exposed: trueflag for standalone skillsUpdated job specification documentation (job_spec.md):
Enhanced example and template files:
job.yml.exampleto demonstrate a competitive research job with three workflows (full_analysis, quick_summary, refresh_research)job.yml.templatewith optional workflows section and inline documentationUpdated CHANGELOG.md: Documented the new guidance and examples for multi-workflow job creation
Implementation Details
workflowssection use all steps as an implicit single workflowhttps://claude.ai/code/session_01Mr1h2fVSKeVP84FDWXx4UM