Skip to content

Commit fe8ff35

Browse files
committed
refactor: Simplify clone_remote_job instructions
- Remove redundant description text about installing jobs - Simplify Step 6 to just review .claude/skills instead of verbose reload instructions - Remove Available Commands section from output format - Update Next Steps to include workflow kick-off instructions
1 parent 536385f commit fe8ff35

File tree

16 files changed

+46
-110
lines changed

16 files changed

+46
-110
lines changed

.claude/skills/deepwork_jobs.clone_remote_job/SKILL.md

Lines changed: 9 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -100,20 +100,14 @@ After applying customizations:
100100
- Document any customizations made
101101
- Add notes about how this job fits into the project workflow
102102

103-
### Step 6: Sync and Test
103+
### Step 6: Sync and Review
104104

105105
1. **Run deepwork sync**
106106
```bash
107107
deepwork sync
108108
```
109109

110-
2. **Verify the job is available**
111-
- Check that slash commands are generated in `.claude/commands/`
112-
- Test that the job appears in command completion
113-
114-
3. **Relay reload instructions**
115-
- If skills were regenerated, tell the user to reload their environment
116-
- For Claude Code: "Type 'exit' then run 'claude --resume'"
110+
2. **Review the new skills** in `.claude/skills/` to make sure they make sense
117111

118112
## Output Format
119113

@@ -129,12 +123,8 @@ After completing the installation and customization:
129123
### Customizations Applied
130124
- [List of customizations made]
131125
132-
### Available Commands
133-
- /<job_name>.<step1> - <description>
134-
- /<job_name>.<step2> - <description>
135-
...
136-
137126
### Next Steps
127+
- [Instructions on how to kick off the main job workflow, e.g., "Run /<job_name> to start"]
138128
- [Any remaining setup or first-use guidance]
139129
```
140130

@@ -145,7 +135,7 @@ After completing the installation and customization:
145135
- All required placeholders replaced with project-specific values
146136
- README updated to remove/update customization instructions
147137
- `deepwork sync` run successfully
148-
- User informed of available slash commands
138+
- User informed how to kick off the job workflow
149139
- When all criteria are met, include `<promise>✓ Quality Criteria Met</promise>`
150140

151141
## Example Dialog
@@ -198,15 +188,9 @@ Now let me sync the job to generate slash commands.
198188
- Replaced `[docs_folder]` with `docs` in job.yml, constitution.md, plan.md
199189
- Updated readme to remove customization instructions
200190

201-
### Available Commands
202-
- /spec_driven_development.constitution - Establish project governance principles
203-
- /spec_driven_development.specify - Create feature specification
204-
- /spec_driven_development.clarify - Clarify specification details
205-
- /spec_driven_development.plan - Generate technical plan
206-
- /spec_driven_development.tasks - Generate task breakdown
207-
- /spec_driven_development.implement - Execute implementation
208-
209-
To use the new commands, type 'exit' then run 'claude --resume'.
191+
### Next Steps
192+
- Run `/spec_driven_development` to start the workflow
193+
- Type 'exit' then run 'claude --resume' to load the new skills
210194

211195
<promise>✓ Quality Criteria Met</promise>
212196
```
@@ -215,7 +199,7 @@ To use the new commands, type 'exit' then run 'claude --resume'.
215199
### Job Context
216200
217201
Core commands for managing DeepWork jobs. These commands help you define new multi-step
218-
workflows, install pre-built jobs from remote repositories, and learn from running them.
202+
workflows and learn from running them.
219203
220204
The `new_job` workflow guides you through defining and implementing a new job by
221205
asking structured questions about your workflow, understanding each step's inputs and outputs,
@@ -267,7 +251,7 @@ Use a sub-agent (Haiku model) to review your work against these criteria:
267251
4. **Placeholders Replaced**: Were all required placeholders replaced with project-specific values?
268252
5. **README Updated**: Was the readme updated to remove/update customization instructions?
269253
6. **Sync Complete**: Has `deepwork sync` been run successfully?
270-
7. **Commands Available**: Are the new slash commands accessible to the user?
254+
7. **Workflow Instructions**: Was the user informed how to kick off the job workflow?
271255
**Review Process**:
272256
1. Once you believe your work is complete, spawn a sub-agent using Haiku to review your work against the quality criteria above
273257
2. The sub-agent should examine your outputs and verify each criterion is met

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -417,7 +417,7 @@ After creating the file:
417417
### Job Context
418418

419419
Core commands for managing DeepWork jobs. These commands help you define new multi-step
420-
workflows, install pre-built jobs from remote repositories, and learn from running them.
420+
workflows and learn from running them.
421421

422422
The `new_job` workflow guides you through defining and implementing a new job by
423423
asking structured questions about your workflow, understanding each step's inputs and outputs,

.claude/skills/deepwork_jobs.implement/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -262,7 +262,7 @@ Before marking this step complete, ensure:
262262
### Job Context
263263

264264
Core commands for managing DeepWork jobs. These commands help you define new multi-step
265-
workflows, install pre-built jobs from remote repositories, and learn from running them.
265+
workflows and learn from running them.
266266

267267
The `new_job` workflow guides you through defining and implementing a new job by
268268
asking structured questions about your workflow, understanding each step's inputs and outputs,

.claude/skills/deepwork_jobs.learn/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -375,7 +375,7 @@ Updated job instructions and created AGENTS.md with bespoke learnings. To get th
375375
### Job Context
376376
377377
Core commands for managing DeepWork jobs. These commands help you define new multi-step
378-
workflows, install pre-built jobs from remote repositories, and learn from running them.
378+
workflows and learn from running them.
379379
380380
The `new_job` workflow guides you through defining and implementing a new job by
381381
asking structured questions about your workflow, understanding each step's inputs and outputs,

.claude/skills/deepwork_jobs.review_job_spec/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -232,7 +232,7 @@ The validated `job.yml` file at `.deepwork/jobs/[job_name]/job.yml` that passes
232232
### Job Context
233233

234234
Core commands for managing DeepWork jobs. These commands help you define new multi-step
235-
workflows, install pre-built jobs from remote repositories, and learn from running them.
235+
workflows and learn from running them.
236236

237237
The `new_job` workflow guides you through defining and implementing a new job by
238238
asking structured questions about your workflow, understanding each step's inputs and outputs,

.claude/skills/deepwork_jobs/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Creates and manages multi-step AI workflows. Use when defining, implementing, or
1010
> **CRITICAL**: Always invoke steps using the Skill tool. Never copy/paste step instructions directly.
1111
1212
Core commands for managing DeepWork jobs. These commands help you define new multi-step
13-
workflows, install pre-built jobs from remote repositories, and learn from running them.
13+
workflows and learn from running them.
1414

1515
The `new_job` workflow guides you through defining and implementing a new job by
1616
asking structured questions about your workflow, understanding each step's inputs and outputs,

.deepwork/jobs/deepwork_jobs/job.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ version: "1.1.0"
33
summary: "Creates and manages multi-step AI workflows. Use when defining, implementing, or improving DeepWork jobs."
44
description: |
55
Core commands for managing DeepWork jobs. These commands help you define new multi-step
6-
workflows, install pre-built jobs from remote repositories, and learn from running them.
6+
workflows and learn from running them.
77
88
The `new_job` workflow guides you through defining and implementing a new job by
99
asking structured questions about your workflow, understanding each step's inputs and outputs,
@@ -157,4 +157,4 @@ steps:
157157
- "**Placeholders Replaced**: Were all required placeholders replaced with project-specific values?"
158158
- "**README Updated**: Was the readme updated to remove/update customization instructions?"
159159
- "**Sync Complete**: Has `deepwork sync` been run successfully?"
160-
- "**Commands Available**: Are the new slash commands accessible to the user?"
160+
- "**Workflow Instructions**: Was the user informed how to kick off the job workflow?"

.deepwork/jobs/deepwork_jobs/steps/clone_remote_job.md

Lines changed: 7 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -85,20 +85,14 @@ After applying customizations:
8585
- Document any customizations made
8686
- Add notes about how this job fits into the project workflow
8787

88-
### Step 6: Sync and Test
88+
### Step 6: Sync and Review
8989

9090
1. **Run deepwork sync**
9191
```bash
9292
deepwork sync
9393
```
9494

95-
2. **Verify the job is available**
96-
- Check that slash commands are generated in `.claude/commands/`
97-
- Test that the job appears in command completion
98-
99-
3. **Relay reload instructions**
100-
- If skills were regenerated, tell the user to reload their environment
101-
- For Claude Code: "Type 'exit' then run 'claude --resume'"
95+
2. **Review the new skills** in `.claude/skills/` to make sure they make sense
10296

10397
## Output Format
10498

@@ -114,12 +108,8 @@ After completing the installation and customization:
114108
### Customizations Applied
115109
- [List of customizations made]
116110
117-
### Available Commands
118-
- /<job_name>.<step1> - <description>
119-
- /<job_name>.<step2> - <description>
120-
...
121-
122111
### Next Steps
112+
- [Instructions on how to kick off the main job workflow, e.g., "Run /<job_name> to start"]
123113
- [Any remaining setup or first-use guidance]
124114
```
125115

@@ -130,7 +120,7 @@ After completing the installation and customization:
130120
- All required placeholders replaced with project-specific values
131121
- README updated to remove/update customization instructions
132122
- `deepwork sync` run successfully
133-
- User informed of available slash commands
123+
- User informed how to kick off the job workflow
134124
- When all criteria are met, include `<promise>✓ Quality Criteria Met</promise>`
135125

136126
## Example Dialog
@@ -183,15 +173,9 @@ Now let me sync the job to generate slash commands.
183173
- Replaced `[docs_folder]` with `docs` in job.yml, constitution.md, plan.md
184174
- Updated readme to remove customization instructions
185175
186-
### Available Commands
187-
- /spec_driven_development.constitution - Establish project governance principles
188-
- /spec_driven_development.specify - Create feature specification
189-
- /spec_driven_development.clarify - Clarify specification details
190-
- /spec_driven_development.plan - Generate technical plan
191-
- /spec_driven_development.tasks - Generate task breakdown
192-
- /spec_driven_development.implement - Execute implementation
193-
194-
To use the new commands, type 'exit' then run 'claude --resume'.
176+
### Next Steps
177+
- Run `/spec_driven_development` to start the workflow
178+
- Type 'exit' then run 'claude --resume' to load the new skills
195179
196180
<promise>✓ Quality Criteria Met</promise>
197181
```

.gemini/skills/deepwork_jobs/clone_remote_job.toml

Lines changed: 9 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -105,20 +105,14 @@ After applying customizations:
105105
- Document any customizations made
106106
- Add notes about how this job fits into the project workflow
107107
108-
### Step 6: Sync and Test
108+
### Step 6: Sync and Review
109109
110110
1. **Run deepwork sync**
111111
```bash
112112
deepwork sync
113113
```
114114
115-
2. **Verify the job is available**
116-
- Check that slash commands are generated in `.claude/commands/`
117-
- Test that the job appears in command completion
118-
119-
3. **Relay reload instructions**
120-
- If skills were regenerated, tell the user to reload their environment
121-
- For Claude Code: "Type 'exit' then run 'claude --resume'"
115+
2. **Review the new skills** in `.claude/skills/` to make sure they make sense
122116
123117
## Output Format
124118
@@ -134,12 +128,8 @@ After completing the installation and customization:
134128
### Customizations Applied
135129
- [List of customizations made]
136130
137-
### Available Commands
138-
- /<job_name>.<step1> - <description>
139-
- /<job_name>.<step2> - <description>
140-
...
141-
142131
### Next Steps
132+
- [Instructions on how to kick off the main job workflow, e.g., "Run /<job_name> to start"]
143133
- [Any remaining setup or first-use guidance]
144134
```
145135
@@ -150,7 +140,7 @@ After completing the installation and customization:
150140
- All required placeholders replaced with project-specific values
151141
- README updated to remove/update customization instructions
152142
- `deepwork sync` run successfully
153-
- User informed of available slash commands
143+
- User informed how to kick off the job workflow
154144
- When all criteria are met, include `<promise>✓ Quality Criteria Met</promise>`
155145
156146
## Example Dialog
@@ -203,15 +193,9 @@ Now let me sync the job to generate slash commands.
203193
- Replaced `[docs_folder]` with `docs` in job.yml, constitution.md, plan.md
204194
- Updated readme to remove customization instructions
205195
206-
### Available Commands
207-
- /spec_driven_development.constitution - Establish project governance principles
208-
- /spec_driven_development.specify - Create feature specification
209-
- /spec_driven_development.clarify - Clarify specification details
210-
- /spec_driven_development.plan - Generate technical plan
211-
- /spec_driven_development.tasks - Generate task breakdown
212-
- /spec_driven_development.implement - Execute implementation
213-
214-
To use the new commands, type 'exit' then run 'claude --resume'.
196+
### Next Steps
197+
- Run `/spec_driven_development` to start the workflow
198+
- Type 'exit' then run 'claude --resume' to load the new skills
215199
216200
<promise>✓ Quality Criteria Met</promise>
217201
```
@@ -220,7 +204,7 @@ To use the new commands, type 'exit' then run 'claude --resume'.
220204
### Job Context
221205
222206
Core commands for managing DeepWork jobs. These commands help you define new multi-step
223-
workflows, install pre-built jobs from remote repositories, and learn from running them.
207+
workflows and learn from running them.
224208
225209
The `new_job` workflow guides you through defining and implementing a new job by
226210
asking structured questions about your workflow, understanding each step's inputs and outputs,
@@ -263,7 +247,7 @@ Use branch format: `deepwork/deepwork_jobs-[instance]-YYYYMMDD`
263247
4. **Placeholders Replaced**: Were all required placeholders replaced with project-specific values?
264248
5. **README Updated**: Was the readme updated to remove/update customization instructions?
265249
6. **Sync Complete**: Has `deepwork sync` been run successfully?
266-
7. **Commands Available**: Are the new slash commands accessible to the user?
250+
7. **Workflow Instructions**: Was the user informed how to kick off the job workflow?
267251
## On Completion
268252
269253
1. Verify outputs are created

.gemini/skills/deepwork_jobs/define.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -420,7 +420,7 @@ After creating the file:
420420
### Job Context
421421
422422
Core commands for managing DeepWork jobs. These commands help you define new multi-step
423-
workflows, install pre-built jobs from remote repositories, and learn from running them.
423+
workflows and learn from running them.
424424
425425
The `new_job` workflow guides you through defining and implementing a new job by
426426
asking structured questions about your workflow, understanding each step's inputs and outputs,

0 commit comments

Comments
 (0)