Restructure skills to distinguish workflows from standalone skills#169
Merged
Restructure skills to distinguish workflows from standalone skills#169
Conversation
…ions This adds a new `workflows` element to job.yml that explicitly defines which steps belong to which workflow. This distinguishes multi-step workflows from standalone independent skills: - Added WORKFLOW_SCHEMA to job_schema.py - Added Workflow dataclass and workflow helpers to parser.py - Updated generator.py to use workflow info for step ordering and context - Updated jinja templates to show workflow vs standalone skill info - Updated deepwork_jobs with new_job workflow (define→review_job_spec→implement) and learn as standalone skill - Updated add_platform, commit, and manual_tests jobs with workflows This resolves the issue where independent steps (like `learn`) were being incorrectly displayed as part of the main workflow sequence. https://claude.ai/code/session_01GaDCCNqeCTh9SfTesqFw5C
- Add workflows feature to CHANGELOG [Unreleased] section - Add workflows example to job.yml documentation in architecture.md - Update deepwork_jobs description to show workflows vs standalone skills - Update execution flow example to show automatic workflow continuation - Replace outdated refine command docs with learn command https://claude.ai/code/session_01GaDCCNqeCTh9SfTesqFw5C
…e_step The dependency-based standalone detection is mutually exclusive with workflow-based detection. Using an explicit else branch makes this clearer. https://claude.ai/code/session_01GaDCCNqeCTh9SfTesqFw5C
When jobs have standalone steps but no workflows, the template was generating duplicate intent patterns - once for standalone_steps and again for all steps. Fixed by only showing the old-style "Available Steps" section when there are no standalone_steps. Also includes ruff formatting fixes and removes unused Workflow import. https://claude.ai/code/session_01GaDCCNqeCTh9SfTesqFw5C
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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
This PR restructures the skill documentation and job definitions to clearly distinguish between multi-step workflows and standalone skills. The changes improve clarity about which skills are part of coordinated workflows versus those that can be run independently.
Key Changes
Added explicit workflow definitions to job.yml files for
add_platform,commit,deepwork_jobs, andmanual_testsjobs, each with a named workflow (e.g., "integrate", "full", "new_job", "run_all") and ordered step sequencesRenamed workflow references throughout skill documentation:
add_platformworkflow → "integrate"commitworkflow → "full"deepwork_jobsworkflow → "new_job"manual_testsworkflow → "run_all"Reorganized skill documentation structure to separate:
Updated completion messages to reference workflow names (e.g., "integrate step 2/4 complete" instead of "Step 2/4 complete")
Clarified deepwork_jobs and deepwork_rules to explicitly mark
learnanddefineas standalone skills that can run independentlyUpdated version numbers for affected jobs (add_platform 0.4.0, commit 1.5.0, deepwork_jobs 1.0.0)
Added guardrail clarifications about not skipping steps "in a workflow" to emphasize the distinction
Implementation Details
name,summary, and orderedstepslisthttps://claude.ai/code/session_01GaDCCNqeCTh9SfTesqFw5C