Skip to content

Comments

Add terminology section to DeepWork skill documentation#216

Merged
nhorton merged 2 commits intomainfrom
claude/clarify-job-workflow-terms-Q2UFU
Feb 17, 2026
Merged

Add terminology section to DeepWork skill documentation#216
nhorton merged 2 commits intomainfrom
claude/clarify-job-workflow-terms-Q2UFU

Conversation

@nhorton
Copy link
Contributor

@nhorton nhorton commented Feb 16, 2026

Summary

Added a "Terminology" section to the DeepWork skill documentation to clarify the distinction between "jobs" and "workflows" and help users understand how these terms relate to each other.

Changes

  • Added a new "Terminology" section across all DeepWork skill documentation files that explains:
    • A job is a collection of related workflows
    • Provides a concrete example using "code_review" job with "review_pr" and "review_diff" workflows
    • Clarifies that users may use these terms interchangeably and instructs to use context and get_workflows to determine the best match

Files Modified

  • .claude/skills/deepwork/SKILL.md
  • .gemini/skills/deepwork/index.toml
  • src/deepwork/templates/claude/skill-deepwork.md.jinja
  • src/deepwork/templates/gemini/skill-deepwork.md.jinja

The terminology section is consistently placed after the introductory description and before the "IMPORTANT" note about using MCP tools across all documentation variants.

https://claude.ai/code/session_01PryjYaPSdnV5vyFqaHi2ze

claude and others added 2 commits February 16, 2026 23:14
Jobs are collections of related workflows, and users may refer to
them interchangeably. Added a Terminology section to the deepwork
skill (both templates and generated files) so the agent understands
this relationship and can use context to resolve ambiguity.

https://claude.ai/code/session_01PryjYaPSdnV5vyFqaHi2ze
@nhorton nhorton enabled auto-merge February 17, 2026 01:35
@nhorton nhorton added this pull request to the merge queue Feb 17, 2026
Merged via the queue into main with commit 355dc6b Feb 17, 2026
4 checks passed
@nhorton nhorton deleted the claude/clarify-job-workflow-terms-Q2UFU branch February 17, 2026 01:47
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