Skip to content

Commit 87b309a

Browse files
committed
refactor: Move multi-workflow guidance into Capability Considerations
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
1 parent b3d9a20 commit 87b309a

4 files changed

Lines changed: 4 additions & 136 deletions

File tree

.claude/skills/deepwork_jobs.define/SKILL.md

Lines changed: 1 addition & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -212,40 +212,7 @@ When defining steps, identify any that require specialized tools:
212212

213213
**Browser Automation**: If any step involves web scraping, form filling, interactive browsing, UI testing, or research requiring website visits, ask the user what browser tools they have available. For Claude Code users, **Claude in Chrome** (Anthropic's browser extension) has been tested with DeepWork and is recommended for new users. Don't assume a default—confirm the tool before designing browser-dependent steps.
214214

215-
### Step 2.5: Consider Multiple Workflows
216-
217-
A job can define **multiple workflows** when different parts of the work need to happen at different points in time. Most jobs have a single workflow, but consider multiple workflows when:
218-
219-
- **Human review/approval gates**: Some steps produce output that needs human review before proceeding. Split into separate workflows so users can run the second part after review.
220-
- **Setup/teardown patterns**: Provisioning resources and later destroying them are distinct operations.
221-
- **Phased execution**: Steps that naturally happen days or weeks apart.
222-
223-
**Examples:**
224-
225-
| Job | Workflows | Reason |
226-
|-----|-----------|--------|
227-
| Twitter Ad Campaign | `analyze_and_propose``setup_approved_ads` | Human reviews proposed ads before setup |
228-
| Customer Environment | `provision``teardown` | Distinct operations at different times |
229-
| Quarterly Report | `gather_data``finalize_report` | Data gathering happens throughout quarter |
230-
231-
**Format:**
232-
233-
```yaml
234-
workflows:
235-
- name: analyze_and_propose
236-
summary: "Analyze trends and propose ad content"
237-
steps:
238-
- analyze_trends
239-
- generate_proposals
240-
- build_report
241-
242-
- name: setup_approved_ads
243-
summary: "Create approved ads on platform"
244-
steps:
245-
- setup_ads
246-
```
247-
248-
If the job has only one workflow (most common), you can omit the `workflows` section entirely.
215+
**Multiple Workflows**: Most jobs have a single workflow, but consider defining multiple workflows when different parts need to happen at different points in time—for example, an analysis workflow that produces a report for human review, then a separate execution workflow to act on approved items. Other examples: `provision` + `teardown` for environment management, or `gather_data` + `finalize_report` for phased work. If the job needs multiple workflows, define them in a `workflows` section in job.yml.
249216

250217
### Step 3: Validate the Workflow
251218

.deepwork/jobs/deepwork_jobs/steps/define.md

Lines changed: 1 addition & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -192,40 +192,7 @@ When defining steps, identify any that require specialized tools:
192192

193193
**Browser Automation**: If any step involves web scraping, form filling, interactive browsing, UI testing, or research requiring website visits, ask the user what browser tools they have available. For Claude Code users, **Claude in Chrome** (Anthropic's browser extension) has been tested with DeepWork and is recommended for new users. Don't assume a default—confirm the tool before designing browser-dependent steps.
194194

195-
### Step 2.5: Consider Multiple Workflows
196-
197-
A job can define **multiple workflows** when different parts of the work need to happen at different points in time. Most jobs have a single workflow, but consider multiple workflows when:
198-
199-
- **Human review/approval gates**: Some steps produce output that needs human review before proceeding. Split into separate workflows so users can run the second part after review.
200-
- **Setup/teardown patterns**: Provisioning resources and later destroying them are distinct operations.
201-
- **Phased execution**: Steps that naturally happen days or weeks apart.
202-
203-
**Examples:**
204-
205-
| Job | Workflows | Reason |
206-
|-----|-----------|--------|
207-
| Twitter Ad Campaign | `analyze_and_propose``setup_approved_ads` | Human reviews proposed ads before setup |
208-
| Customer Environment | `provision``teardown` | Distinct operations at different times |
209-
| Quarterly Report | `gather_data``finalize_report` | Data gathering happens throughout quarter |
210-
211-
**Format:**
212-
213-
```yaml
214-
workflows:
215-
- name: analyze_and_propose
216-
summary: "Analyze trends and propose ad content"
217-
steps:
218-
- analyze_trends
219-
- generate_proposals
220-
- build_report
221-
222-
- name: setup_approved_ads
223-
summary: "Create approved ads on platform"
224-
steps:
225-
- setup_ads
226-
```
227-
228-
If the job has only one workflow (most common), you can omit the `workflows` section entirely.
195+
**Multiple Workflows**: Most jobs have a single workflow, but consider defining multiple workflows when different parts need to happen at different points in time—for example, an analysis workflow that produces a report for human review, then a separate execution workflow to act on approved items. Other examples: `provision` + `teardown` for environment management, or `gather_data` + `finalize_report` for phased work. If the job needs multiple workflows, define them in a `workflows` section in job.yml.
229196

230197
### Step 3: Validate the Workflow
231198

.gemini/skills/deepwork_jobs/define.toml

Lines changed: 1 addition & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -212,40 +212,7 @@ When defining steps, identify any that require specialized tools:
212212
213213
**Browser Automation**: If any step involves web scraping, form filling, interactive browsing, UI testing, or research requiring website visits, ask the user what browser tools they have available. For Claude Code users, **Claude in Chrome** (Anthropic's browser extension) has been tested with DeepWork and is recommended for new users. Don't assume a default—confirm the tool before designing browser-dependent steps.
214214
215-
### Step 2.5: Consider Multiple Workflows
216-
217-
A job can define **multiple workflows** when different parts of the work need to happen at different points in time. Most jobs have a single workflow, but consider multiple workflows when:
218-
219-
- **Human review/approval gates**: Some steps produce output that needs human review before proceeding. Split into separate workflows so users can run the second part after review.
220-
- **Setup/teardown patterns**: Provisioning resources and later destroying them are distinct operations.
221-
- **Phased execution**: Steps that naturally happen days or weeks apart.
222-
223-
**Examples:**
224-
225-
| Job | Workflows | Reason |
226-
|-----|-----------|--------|
227-
| Twitter Ad Campaign | `analyze_and_propose` → `setup_approved_ads` | Human reviews proposed ads before setup |
228-
| Customer Environment | `provision` → `teardown` | Distinct operations at different times |
229-
| Quarterly Report | `gather_data` → `finalize_report` | Data gathering happens throughout quarter |
230-
231-
**Format:**
232-
233-
```yaml
234-
workflows:
235-
- name: analyze_and_propose
236-
summary: "Analyze trends and propose ad content"
237-
steps:
238-
- analyze_trends
239-
- generate_proposals
240-
- build_report
241-
242-
- name: setup_approved_ads
243-
summary: "Create approved ads on platform"
244-
steps:
245-
- setup_ads
246-
```
247-
248-
If the job has only one workflow (most common), you can omit the `workflows` section entirely.
215+
**Multiple Workflows**: Most jobs have a single workflow, but consider defining multiple workflows when different parts need to happen at different points in time—for example, an analysis workflow that produces a report for human review, then a separate execution workflow to act on approved items. Other examples: `provision` + `teardown` for environment management, or `gather_data` + `finalize_report` for phased work. If the job needs multiple workflows, define them in a `workflows` section in job.yml.
249216
250217
### Step 3: Validate the Workflow
251218

src/deepwork/standard_jobs/deepwork_jobs/steps/define.md

Lines changed: 1 addition & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -192,40 +192,7 @@ When defining steps, identify any that require specialized tools:
192192

193193
**Browser Automation**: If any step involves web scraping, form filling, interactive browsing, UI testing, or research requiring website visits, ask the user what browser tools they have available. For Claude Code users, **Claude in Chrome** (Anthropic's browser extension) has been tested with DeepWork and is recommended for new users. Don't assume a default—confirm the tool before designing browser-dependent steps.
194194

195-
### Step 2.5: Consider Multiple Workflows
196-
197-
A job can define **multiple workflows** when different parts of the work need to happen at different points in time. Most jobs have a single workflow, but consider multiple workflows when:
198-
199-
- **Human review/approval gates**: Some steps produce output that needs human review before proceeding. Split into separate workflows so users can run the second part after review.
200-
- **Setup/teardown patterns**: Provisioning resources and later destroying them are distinct operations.
201-
- **Phased execution**: Steps that naturally happen days or weeks apart.
202-
203-
**Examples:**
204-
205-
| Job | Workflows | Reason |
206-
|-----|-----------|--------|
207-
| Twitter Ad Campaign | `analyze_and_propose``setup_approved_ads` | Human reviews proposed ads before setup |
208-
| Customer Environment | `provision``teardown` | Distinct operations at different times |
209-
| Quarterly Report | `gather_data``finalize_report` | Data gathering happens throughout quarter |
210-
211-
**Format:**
212-
213-
```yaml
214-
workflows:
215-
- name: analyze_and_propose
216-
summary: "Analyze trends and propose ad content"
217-
steps:
218-
- analyze_trends
219-
- generate_proposals
220-
- build_report
221-
222-
- name: setup_approved_ads
223-
summary: "Create approved ads on platform"
224-
steps:
225-
- setup_ads
226-
```
227-
228-
If the job has only one workflow (most common), you can omit the `workflows` section entirely.
195+
**Multiple Workflows**: Most jobs have a single workflow, but consider defining multiple workflows when different parts need to happen at different points in time—for example, an analysis workflow that produces a report for human review, then a separate execution workflow to act on approved items. Other examples: `provision` + `teardown` for environment management, or `gather_data` + `finalize_report` for phased work. If the job needs multiple workflows, define them in a `workflows` section in job.yml.
229196

230197
### Step 3: Validate the Workflow
231198

0 commit comments

Comments
 (0)