@dccxx/auggiegw 1.0.26 → 1.0.28
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.augment/commands/compact.md +73 -0
- package/.augment/skills/compact/SKILL.md +73 -0
- package/{.opencode/command/opsx-apply.md → .claude/commands/opsx/apply.md} +7 -4
- package/{.opencode/command/opsx-archive.md → .claude/commands/opsx/archive.md} +6 -3
- package/{.opencode/command/opsx-bulk-archive.md → .claude/commands/opsx/bulk-archive.md} +4 -1
- package/{.opencode/command/opsx-continue.md → .claude/commands/opsx/continue.md} +6 -3
- package/{.opencode/command/opsx-explore.md → .claude/commands/opsx/explore.md} +8 -5
- package/{.opencode/command/opsx-ff.md → .claude/commands/opsx/ff.md} +5 -2
- package/{.opencode/command/opsx-new.md → .claude/commands/opsx/new.md} +6 -3
- package/{.opencode/command/opsx-onboard.md → .claude/commands/opsx/onboard.md} +24 -21
- package/{.opencode/command/opsx-sync.md → .claude/commands/opsx/sync.md} +4 -1
- package/{.opencode/command/opsx-verify.md → .claude/commands/opsx/verify.md} +4 -1
- package/{.opencode → .claude}/skills/openspec-apply-change/SKILL.md +1 -1
- package/{.opencode → .claude}/skills/openspec-archive-change/SKILL.md +1 -1
- package/{.opencode → .claude}/skills/openspec-bulk-archive-change/SKILL.md +1 -1
- package/{.opencode → .claude}/skills/openspec-explore/SKILL.md +6 -6
- package/{.opencode → .claude}/skills/openspec-ff-change/SKILL.md +1 -1
- package/{.opencode → .claude}/skills/openspec-onboard/SKILL.md +21 -21
- package/CLAUDE.md +6 -4
- package/dist/cli.js +263 -45
- package/justfile +3 -0
- package/openspec/changes/add-dual-prompt-save/.openspec.yaml +2 -0
- package/openspec/changes/add-dual-prompt-save/design.md +85 -0
- package/openspec/changes/add-dual-prompt-save/proposal.md +32 -0
- package/openspec/changes/add-dual-prompt-save/specs/dual-prompt-save/spec.md +59 -0
- package/openspec/changes/add-dual-prompt-save/specs/skill-directory-structure/spec.md +26 -0
- package/openspec/changes/add-dual-prompt-save/tasks.md +52 -0
- package/openspec/changes/archive/2026-02-05-commands-to-skills-migration/.openspec.yaml +2 -0
- package/openspec/changes/archive/2026-02-05-commands-to-skills-migration/design.md +85 -0
- package/openspec/changes/archive/2026-02-05-commands-to-skills-migration/proposal.md +35 -0
- package/openspec/changes/archive/2026-02-05-commands-to-skills-migration/specs/skill-directory-structure/spec.md +62 -0
- package/openspec/changes/archive/2026-02-05-commands-to-skills-migration/tasks.md +36 -0
- package/openspec/changes/archive/2026-02-05-fetch-prompts-interactive/.openspec.yaml +2 -0
- package/openspec/changes/archive/2026-02-05-fetch-prompts-interactive/design.md +68 -0
- package/openspec/changes/archive/2026-02-05-fetch-prompts-interactive/proposal.md +36 -0
- package/openspec/changes/archive/2026-02-05-fetch-prompts-interactive/specs/fetch-prompts-interactive/spec.md +93 -0
- package/openspec/changes/archive/2026-02-05-fetch-prompts-interactive/tasks.md +40 -0
- package/openspec/specs/skill-directory-structure/spec.md +62 -0
- package/package.json +1 -1
- /package/{.opencode → .claude}/skills/openspec-continue-change/SKILL.md +0 -0
- /package/{.opencode → .claude}/skills/openspec-new-change/SKILL.md +0 -0
- /package/{.opencode → .claude}/skills/openspec-sync-specs/SKILL.md +0 -0
- /package/{.opencode → .claude}/skills/openspec-verify-change/SKILL.md +0 -0
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: /compact
|
|
3
|
+
type: "manual"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Your task is to create a detailed summary of the conversation so far, paying close attention to the user's explicit requests and your previous actions.
|
|
7
|
+
This summary should be thorough in capturing technical details, code patterns, and architectural decisions that would be essential for continuing development work without losing context.
|
|
8
|
+
|
|
9
|
+
Before providing your final summary, write an **Analysis** section to organize your thoughts and ensure you've covered all necessary points. In your analysis process:
|
|
10
|
+
|
|
11
|
+
1. Chronologically analyze each message and section of the conversation. For each section thoroughly identify:
|
|
12
|
+
- The user's explicit requests and intents
|
|
13
|
+
- Your approach to addressing the user's requests
|
|
14
|
+
- Key decisions, technical concepts and code patterns
|
|
15
|
+
- Specific details like file names, full code snippets, function signatures, file edits, etc
|
|
16
|
+
2. Double-check for technical accuracy and completeness, addressing each required element thoroughly.
|
|
17
|
+
|
|
18
|
+
Your summary should include the following sections:
|
|
19
|
+
|
|
20
|
+
1. Primary Request and Intent: Capture all of the user's explicit requests and intents in detail
|
|
21
|
+
2. Key Technical Concepts: List all important technical concepts, technologies, and frameworks discussed.
|
|
22
|
+
3. Files and Code Sections: Enumerate specific files and code sections examined, modified, or created. Pay special attention to the most recent messages and include full code snippets where applicable and include a summary of why this file read or edit is important.
|
|
23
|
+
4. Problem Solving: Document problems solved and any ongoing troubleshooting efforts.
|
|
24
|
+
5. Pending Tasks: Outline any pending tasks that you have explicitly been asked to work on.
|
|
25
|
+
6. Current Work: Describe in detail precisely what was being worked on immediately before this summary request, paying special attention to the most recent messages from both user and assistant. Include file names and code snippets where applicable.
|
|
26
|
+
7. Optional Next Step: List the next step that you will take that is related to the most recent work you were doing. IMPORTANT: ensure that this step is DIRECTLY in line with the user's explicit requests, and the task you were working on immediately before this summary request. If your last task was concluded, then only list next steps if they are explicitly in line with the users request. Do not start on tangential requests without confirming with the user first.
|
|
27
|
+
8. If there is a next step, include direct quotes from the most recent conversation showing exactly what task you were working on and where you left off. This should be verbatim to ensure there's no drift in task interpretation.
|
|
28
|
+
|
|
29
|
+
Here's an example of how your output should be structured:
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Example
|
|
34
|
+
|
|
35
|
+
### Analysis
|
|
36
|
+
[Your thought process, ensuring all points are covered thoroughly and accurately]
|
|
37
|
+
|
|
38
|
+
### Summary
|
|
39
|
+
|
|
40
|
+
**1. Primary Request and Intent:**
|
|
41
|
+
[Detailed description]
|
|
42
|
+
|
|
43
|
+
**2. Key Technical Concepts:**
|
|
44
|
+
- [Concept 1]
|
|
45
|
+
- [Concept 2]
|
|
46
|
+
- [...]
|
|
47
|
+
|
|
48
|
+
**3. Files and Code Sections:**
|
|
49
|
+
- [File Name 1]
|
|
50
|
+
- [Summary of why this file is important]
|
|
51
|
+
- [Summary of the changes made to this file, if any]
|
|
52
|
+
- [Important Code Snippet]
|
|
53
|
+
- [File Name 2]
|
|
54
|
+
- [Important Code Snippet]
|
|
55
|
+
- [...]
|
|
56
|
+
|
|
57
|
+
**4. Problem Solving:**
|
|
58
|
+
[Description of solved problems and ongoing troubleshooting]
|
|
59
|
+
|
|
60
|
+
**5. Pending Tasks:**
|
|
61
|
+
- [Task 1]
|
|
62
|
+
- [Task 2]
|
|
63
|
+
- [...]
|
|
64
|
+
|
|
65
|
+
**6. Current Work:**
|
|
66
|
+
[Precise description of current work]
|
|
67
|
+
|
|
68
|
+
**7. Optional Next Step:**
|
|
69
|
+
[Optional Next step to take]
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
Please provide your summary based on the conversation so far, following this structure and ensuring precision and thoroughness in your response.
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: /compact
|
|
3
|
+
type: "manual"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Your task is to create a detailed summary of the conversation so far, paying close attention to the user's explicit requests and your previous actions.
|
|
7
|
+
This summary should be thorough in capturing technical details, code patterns, and architectural decisions that would be essential for continuing development work without losing context.
|
|
8
|
+
|
|
9
|
+
Before providing your final summary, write an **Analysis** section to organize your thoughts and ensure you've covered all necessary points. In your analysis process:
|
|
10
|
+
|
|
11
|
+
1. Chronologically analyze each message and section of the conversation. For each section thoroughly identify:
|
|
12
|
+
- The user's explicit requests and intents
|
|
13
|
+
- Your approach to addressing the user's requests
|
|
14
|
+
- Key decisions, technical concepts and code patterns
|
|
15
|
+
- Specific details like file names, full code snippets, function signatures, file edits, etc
|
|
16
|
+
2. Double-check for technical accuracy and completeness, addressing each required element thoroughly.
|
|
17
|
+
|
|
18
|
+
Your summary should include the following sections:
|
|
19
|
+
|
|
20
|
+
1. Primary Request and Intent: Capture all of the user's explicit requests and intents in detail
|
|
21
|
+
2. Key Technical Concepts: List all important technical concepts, technologies, and frameworks discussed.
|
|
22
|
+
3. Files and Code Sections: Enumerate specific files and code sections examined, modified, or created. Pay special attention to the most recent messages and include full code snippets where applicable and include a summary of why this file read or edit is important.
|
|
23
|
+
4. Problem Solving: Document problems solved and any ongoing troubleshooting efforts.
|
|
24
|
+
5. Pending Tasks: Outline any pending tasks that you have explicitly been asked to work on.
|
|
25
|
+
6. Current Work: Describe in detail precisely what was being worked on immediately before this summary request, paying special attention to the most recent messages from both user and assistant. Include file names and code snippets where applicable.
|
|
26
|
+
7. Optional Next Step: List the next step that you will take that is related to the most recent work you were doing. IMPORTANT: ensure that this step is DIRECTLY in line with the user's explicit requests, and the task you were working on immediately before this summary request. If your last task was concluded, then only list next steps if they are explicitly in line with the users request. Do not start on tangential requests without confirming with the user first.
|
|
27
|
+
8. If there is a next step, include direct quotes from the most recent conversation showing exactly what task you were working on and where you left off. This should be verbatim to ensure there's no drift in task interpretation.
|
|
28
|
+
|
|
29
|
+
Here's an example of how your output should be structured:
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Example
|
|
34
|
+
|
|
35
|
+
### Analysis
|
|
36
|
+
[Your thought process, ensuring all points are covered thoroughly and accurately]
|
|
37
|
+
|
|
38
|
+
### Summary
|
|
39
|
+
|
|
40
|
+
**1. Primary Request and Intent:**
|
|
41
|
+
[Detailed description]
|
|
42
|
+
|
|
43
|
+
**2. Key Technical Concepts:**
|
|
44
|
+
- [Concept 1]
|
|
45
|
+
- [Concept 2]
|
|
46
|
+
- [...]
|
|
47
|
+
|
|
48
|
+
**3. Files and Code Sections:**
|
|
49
|
+
- [File Name 1]
|
|
50
|
+
- [Summary of why this file is important]
|
|
51
|
+
- [Summary of the changes made to this file, if any]
|
|
52
|
+
- [Important Code Snippet]
|
|
53
|
+
- [File Name 2]
|
|
54
|
+
- [Important Code Snippet]
|
|
55
|
+
- [...]
|
|
56
|
+
|
|
57
|
+
**4. Problem Solving:**
|
|
58
|
+
[Description of solved problems and ongoing troubleshooting]
|
|
59
|
+
|
|
60
|
+
**5. Pending Tasks:**
|
|
61
|
+
- [Task 1]
|
|
62
|
+
- [Task 2]
|
|
63
|
+
- [...]
|
|
64
|
+
|
|
65
|
+
**6. Current Work:**
|
|
66
|
+
[Precise description of current work]
|
|
67
|
+
|
|
68
|
+
**7. Optional Next Step:**
|
|
69
|
+
[Optional Next step to take]
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
Please provide your summary based on the conversation so far, following this structure and ensuring precision and thoroughness in your response.
|
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: Apply"
|
|
2
3
|
description: Implement tasks from an OpenSpec change (Experimental)
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, artifacts, experimental]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Implement tasks from an OpenSpec change.
|
|
6
9
|
|
|
7
|
-
**Input**: Optionally specify a change name (e.g., `/opsx
|
|
10
|
+
**Input**: Optionally specify a change name (e.g., `/opsx:apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
|
8
11
|
|
|
9
12
|
**Steps**
|
|
10
13
|
|
|
@@ -15,7 +18,7 @@ Implement tasks from an OpenSpec change.
|
|
|
15
18
|
- Auto-select if only one active change exists
|
|
16
19
|
- If ambiguous, run `openspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select
|
|
17
20
|
|
|
18
|
-
Always announce: "Using change: <name>" and how to override (e.g., `/opsx
|
|
21
|
+
Always announce: "Using change: <name>" and how to override (e.g., `/opsx:apply <other>`).
|
|
19
22
|
|
|
20
23
|
2. **Check status to understand the schema**
|
|
21
24
|
```bash
|
|
@@ -38,7 +41,7 @@ Implement tasks from an OpenSpec change.
|
|
|
38
41
|
- Dynamic instruction based on current state
|
|
39
42
|
|
|
40
43
|
**Handle states:**
|
|
41
|
-
- If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx
|
|
44
|
+
- If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx:continue`
|
|
42
45
|
- If `state: "all_done"`: congratulate, suggest archive
|
|
43
46
|
- Otherwise: proceed to implementation
|
|
44
47
|
|
|
@@ -108,7 +111,7 @@ Working on task 4/7: <task description>
|
|
|
108
111
|
- [x] Task 2
|
|
109
112
|
...
|
|
110
113
|
|
|
111
|
-
All tasks complete! You can archive this change with `/opsx
|
|
114
|
+
All tasks complete! You can archive this change with `/opsx:archive`.
|
|
112
115
|
```
|
|
113
116
|
|
|
114
117
|
**Output On Pause (Issue Encountered)**
|
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: Archive"
|
|
2
3
|
description: Archive a completed change in the experimental workflow
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, archive, experimental]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Archive a completed change in the experimental workflow.
|
|
6
9
|
|
|
7
|
-
**Input**: Optionally specify a change name after `/opsx
|
|
10
|
+
**Input**: Optionally specify a change name after `/opsx:archive` (e.g., `/opsx:archive add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
|
8
11
|
|
|
9
12
|
**Steps**
|
|
10
13
|
|
|
@@ -56,7 +59,7 @@ Archive a completed change in the experimental workflow.
|
|
|
56
59
|
- If changes needed: "Sync now (recommended)", "Archive without syncing"
|
|
57
60
|
- If already synced: "Archive now", "Sync anyway", "Cancel"
|
|
58
61
|
|
|
59
|
-
If user chooses sync, execute `/opsx
|
|
62
|
+
If user chooses sync, execute `/opsx:sync` logic. Proceed to archive regardless of choice.
|
|
60
63
|
|
|
61
64
|
5. **Perform the archive**
|
|
62
65
|
|
|
@@ -150,5 +153,5 @@ Target archive directory already exists.
|
|
|
150
153
|
- Don't block archive on warnings - just inform and confirm
|
|
151
154
|
- Preserve .openspec.yaml when moving to archive (it moves with the directory)
|
|
152
155
|
- Show clear summary of what happened
|
|
153
|
-
- If sync is requested, use /opsx
|
|
156
|
+
- If sync is requested, use /opsx:sync approach (agent-driven)
|
|
154
157
|
- If delta specs exist, always run the sync assessment and show the combined summary before prompting
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: Bulk Archive"
|
|
2
3
|
description: Archive multiple completed changes at once
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, archive, experimental, bulk]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Archive multiple completed changes in a single operation.
|
|
@@ -222,7 +225,7 @@ Failed K changes:
|
|
|
222
225
|
```
|
|
223
226
|
## No Changes to Archive
|
|
224
227
|
|
|
225
|
-
No active changes found. Use `/opsx
|
|
228
|
+
No active changes found. Use `/opsx:new` to create a new change.
|
|
226
229
|
```
|
|
227
230
|
|
|
228
231
|
**Guardrails**
|
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: Continue"
|
|
2
3
|
description: Continue working on a change - create the next artifact (Experimental)
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, artifacts, experimental]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Continue working on a change by creating the next artifact.
|
|
6
9
|
|
|
7
|
-
**Input**: Optionally specify a change name after `/opsx
|
|
10
|
+
**Input**: Optionally specify a change name after `/opsx:continue` (e.g., `/opsx:continue add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
|
8
11
|
|
|
9
12
|
**Steps**
|
|
10
13
|
|
|
@@ -38,7 +41,7 @@ Continue working on a change by creating the next artifact.
|
|
|
38
41
|
**If all artifacts are complete (`isComplete: true`)**:
|
|
39
42
|
- Congratulate the user
|
|
40
43
|
- Show final status including the schema used
|
|
41
|
-
- Suggest: "All artifacts created! You can now implement this change with `/opsx
|
|
44
|
+
- Suggest: "All artifacts created! You can now implement this change with `/opsx:apply` or archive it with `/opsx:archive`."
|
|
42
45
|
- STOP
|
|
43
46
|
|
|
44
47
|
---
|
|
@@ -82,7 +85,7 @@ After each invocation, show:
|
|
|
82
85
|
- Schema workflow being used
|
|
83
86
|
- Current progress (N/M complete)
|
|
84
87
|
- What artifacts are now unlocked
|
|
85
|
-
- Prompt: "Run `/opsx
|
|
88
|
+
- Prompt: "Run `/opsx:continue` to create the next artifact"
|
|
86
89
|
|
|
87
90
|
**Artifact Creation Guidelines**
|
|
88
91
|
|
|
@@ -1,14 +1,17 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
2
|
+
name: "OPSX: Explore"
|
|
3
|
+
description: "Enter explore mode - think through ideas, investigate problems, clarify requirements"
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, explore, experimental, thinking]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
|
|
6
9
|
|
|
7
|
-
**IMPORTANT: Explore mode is for thinking, not implementing.** You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first (e.g., start a change with `/opsx
|
|
10
|
+
**IMPORTANT: Explore mode is for thinking, not implementing.** You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first (e.g., start a change with `/opsx:new` or `/opsx:ff`). You MAY create OpenSpec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.
|
|
8
11
|
|
|
9
12
|
**This is a stance, not a workflow.** There are no fixed steps, no required sequence, no mandatory outputs. You're a thinking partner helping the user explore.
|
|
10
13
|
|
|
11
|
-
**Input**: The argument after `/opsx
|
|
14
|
+
**Input**: The argument after `/opsx:explore` is whatever the user wants to think about. Could be:
|
|
12
15
|
- A vague idea: "real-time collaboration"
|
|
13
16
|
- A specific problem: "the auth system is getting unwieldy"
|
|
14
17
|
- A change name: "add-dark-mode" (to explore in context of that change)
|
|
@@ -98,7 +101,7 @@ If the user mentioned a specific change name, read its artifacts for context.
|
|
|
98
101
|
Think freely. When insights crystallize, you might offer:
|
|
99
102
|
|
|
100
103
|
- "This feels solid enough to start a change. Want me to create one?"
|
|
101
|
-
→ Can transition to `/opsx
|
|
104
|
+
→ Can transition to `/opsx:new` or `/opsx:ff`
|
|
102
105
|
- Or keep exploring - no pressure to formalize
|
|
103
106
|
|
|
104
107
|
### When a change exists
|
|
@@ -150,7 +153,7 @@ If the user mentions a change or you detect one is relevant:
|
|
|
150
153
|
|
|
151
154
|
There's no required ending. Discovery might:
|
|
152
155
|
|
|
153
|
-
- **Flow into action**: "Ready to start? `/opsx
|
|
156
|
+
- **Flow into action**: "Ready to start? `/opsx:new` or `/opsx:ff`"
|
|
154
157
|
- **Result in artifact updates**: "Updated design.md with these decisions"
|
|
155
158
|
- **Just provide clarity**: User has what they need, moves on
|
|
156
159
|
- **Continue later**: "We can pick this up anytime"
|
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: Fast Forward"
|
|
2
3
|
description: Create a change and generate all artifacts needed for implementation in one go
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, artifacts, experimental]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Fast-forward through artifact creation - generate everything needed to start implementation.
|
|
6
9
|
|
|
7
|
-
**Input**: The argument after `/opsx
|
|
10
|
+
**Input**: The argument after `/opsx:ff` is the change name (kebab-case), OR a description of what the user wants to build.
|
|
8
11
|
|
|
9
12
|
**Steps**
|
|
10
13
|
|
|
@@ -74,7 +77,7 @@ After completing all artifacts, summarize:
|
|
|
74
77
|
- Change name and location
|
|
75
78
|
- List of artifacts created with brief descriptions
|
|
76
79
|
- What's ready: "All artifacts created! Ready for implementation."
|
|
77
|
-
- Prompt: "Run `/opsx
|
|
80
|
+
- Prompt: "Run `/opsx:apply` to start implementing."
|
|
78
81
|
|
|
79
82
|
**Artifact Creation Guidelines**
|
|
80
83
|
|
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: New"
|
|
2
3
|
description: Start a new change using the experimental artifact workflow (OPSX)
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, artifacts, experimental]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Start a new change using the experimental artifact-driven approach.
|
|
6
9
|
|
|
7
|
-
**Input**: The argument after `/opsx
|
|
10
|
+
**Input**: The argument after `/opsx:new` is the change name (kebab-case), OR a description of what the user wants to build.
|
|
8
11
|
|
|
9
12
|
**Steps**
|
|
10
13
|
|
|
@@ -56,11 +59,11 @@ After completing the steps, summarize:
|
|
|
56
59
|
- Schema/workflow being used and its artifact sequence
|
|
57
60
|
- Current status (0/N artifacts complete)
|
|
58
61
|
- The template for the first artifact
|
|
59
|
-
- Prompt: "Ready to create the first artifact? Run `/opsx
|
|
62
|
+
- Prompt: "Ready to create the first artifact? Run `/opsx:continue` or just describe what this change is about and I'll draft it."
|
|
60
63
|
|
|
61
64
|
**Guardrails**
|
|
62
65
|
- Do NOT create any artifacts yet - just show the instructions
|
|
63
66
|
- Do NOT advance beyond showing the first artifact template
|
|
64
67
|
- If the name is invalid (not kebab-case), ask for a valid name
|
|
65
|
-
- If a change with that name already exists, suggest using `/opsx
|
|
68
|
+
- If a change with that name already exists, suggest using `/opsx:continue` instead
|
|
66
69
|
- Pass --schema if using a non-default workflow
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: Onboard"
|
|
2
3
|
description: Guided onboarding - walk through a complete OpenSpec workflow cycle with narration
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, onboarding, tutorial, learning]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Guide the user through their first complete OpenSpec workflow cycle. This is a teaching experience—you'll do real work in their codebase while explaining each step.
|
|
@@ -15,7 +18,7 @@ openspec status --json 2>&1 || echo "NOT_INITIALIZED"
|
|
|
15
18
|
```
|
|
16
19
|
|
|
17
20
|
**If not initialized:**
|
|
18
|
-
> OpenSpec isn't set up in this project yet. Run `openspec init` first, then come back to `/opsx
|
|
21
|
+
> OpenSpec isn't set up in this project yet. Run `openspec init` first, then come back to `/opsx:onboard`.
|
|
19
22
|
|
|
20
23
|
Stop here if not initialized.
|
|
21
24
|
|
|
@@ -139,7 +142,7 @@ Spend 1-2 minutes investigating the relevant code:
|
|
|
139
142
|
│ [Optional: ASCII diagram if helpful] │
|
|
140
143
|
└─────────────────────────────────────────┘
|
|
141
144
|
|
|
142
|
-
Explore mode (`/opsx
|
|
145
|
+
Explore mode (`/opsx:explore`) is for this kind of thinking—investigating before implementing. You can use it anytime you need to think through a problem.
|
|
143
146
|
|
|
144
147
|
Now let's create a change to hold our work.
|
|
145
148
|
```
|
|
@@ -452,19 +455,19 @@ This same rhythm works for any size change—a small fix or a major feature.
|
|
|
452
455
|
|
|
453
456
|
| Command | What it does |
|
|
454
457
|
|---------|--------------|
|
|
455
|
-
| `/opsx
|
|
456
|
-
| `/opsx
|
|
457
|
-
| `/opsx
|
|
458
|
-
| `/opsx
|
|
459
|
-
| `/opsx
|
|
460
|
-
| `/opsx
|
|
461
|
-
| `/opsx
|
|
458
|
+
| `/opsx:explore` | Think through problems before/during work |
|
|
459
|
+
| `/opsx:new` | Start a new change, step through artifacts |
|
|
460
|
+
| `/opsx:ff` | Fast-forward: create all artifacts at once |
|
|
461
|
+
| `/opsx:continue` | Continue working on an existing change |
|
|
462
|
+
| `/opsx:apply` | Implement tasks from a change |
|
|
463
|
+
| `/opsx:verify` | Verify implementation matches artifacts |
|
|
464
|
+
| `/opsx:archive` | Archive a completed change |
|
|
462
465
|
|
|
463
466
|
---
|
|
464
467
|
|
|
465
468
|
## What's Next?
|
|
466
469
|
|
|
467
|
-
Try `/opsx
|
|
470
|
+
Try `/opsx:new` or `/opsx:ff` on something you actually want to build. You've got the rhythm now!
|
|
468
471
|
```
|
|
469
472
|
|
|
470
473
|
---
|
|
@@ -479,8 +482,8 @@ If the user says they need to stop, want to pause, or seem disengaged:
|
|
|
479
482
|
No problem! Your change is saved at `openspec/changes/<name>/`.
|
|
480
483
|
|
|
481
484
|
To pick up where we left off later:
|
|
482
|
-
- `/opsx
|
|
483
|
-
- `/opsx
|
|
485
|
+
- `/opsx:continue <name>` - Resume artifact creation
|
|
486
|
+
- `/opsx:apply <name>` - Jump to implementation (if tasks exist)
|
|
484
487
|
|
|
485
488
|
The work won't be lost. Come back whenever you're ready.
|
|
486
489
|
```
|
|
@@ -496,15 +499,15 @@ If the user says they just want to see the commands or skip the tutorial:
|
|
|
496
499
|
|
|
497
500
|
| Command | What it does |
|
|
498
501
|
|---------|--------------|
|
|
499
|
-
| `/opsx
|
|
500
|
-
| `/opsx
|
|
501
|
-
| `/opsx
|
|
502
|
-
| `/opsx
|
|
503
|
-
| `/opsx
|
|
504
|
-
| `/opsx
|
|
505
|
-
| `/opsx
|
|
506
|
-
|
|
507
|
-
Try `/opsx
|
|
502
|
+
| `/opsx:explore` | Think through problems (no code changes) |
|
|
503
|
+
| `/opsx:new <name>` | Start a new change, step by step |
|
|
504
|
+
| `/opsx:ff <name>` | Fast-forward: all artifacts at once |
|
|
505
|
+
| `/opsx:continue <name>` | Continue an existing change |
|
|
506
|
+
| `/opsx:apply <name>` | Implement tasks |
|
|
507
|
+
| `/opsx:verify <name>` | Verify implementation |
|
|
508
|
+
| `/opsx:archive <name>` | Archive when done |
|
|
509
|
+
|
|
510
|
+
Try `/opsx:new` to start your first change, or `/opsx:ff` if you want to move fast.
|
|
508
511
|
```
|
|
509
512
|
|
|
510
513
|
Exit gracefully.
|
|
@@ -1,12 +1,15 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: Sync"
|
|
2
3
|
description: Sync delta specs from a change to main specs
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, specs, experimental]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Sync delta specs from a change to main specs.
|
|
6
9
|
|
|
7
10
|
This is an **agent-driven** operation - you will read delta specs and directly edit main specs to apply the changes. This allows intelligent merging (e.g., adding a scenario without copying the entire requirement).
|
|
8
11
|
|
|
9
|
-
**Input**: Optionally specify a change name after `/opsx
|
|
12
|
+
**Input**: Optionally specify a change name after `/opsx:sync` (e.g., `/opsx:sync add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
|
10
13
|
|
|
11
14
|
**Steps**
|
|
12
15
|
|
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
---
|
|
2
|
+
name: "OPSX: Verify"
|
|
2
3
|
description: Verify implementation matches change artifacts before archiving
|
|
4
|
+
category: Workflow
|
|
5
|
+
tags: [workflow, verify, experimental]
|
|
3
6
|
---
|
|
4
7
|
|
|
5
8
|
Verify that an implementation matches the change artifacts (specs, tasks, design).
|
|
6
9
|
|
|
7
|
-
**Input**: Optionally specify a change name after `/opsx
|
|
10
|
+
**Input**: Optionally specify a change name after `/opsx:verify` (e.g., `/opsx:verify add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
|
8
11
|
|
|
9
12
|
**Steps**
|
|
10
13
|
|
|
@@ -22,7 +22,7 @@ Implement tasks from an OpenSpec change.
|
|
|
22
22
|
- Auto-select if only one active change exists
|
|
23
23
|
- If ambiguous, run `openspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select
|
|
24
24
|
|
|
25
|
-
Always announce: "Using change: <name>" and how to override (e.g., `/opsx
|
|
25
|
+
Always announce: "Using change: <name>" and how to override (e.g., `/opsx:apply <other>`).
|
|
26
26
|
|
|
27
27
|
2. **Check status to understand the schema**
|
|
28
28
|
```bash
|
|
@@ -63,7 +63,7 @@ Archive a completed change in the experimental workflow.
|
|
|
63
63
|
- If changes needed: "Sync now (recommended)", "Archive without syncing"
|
|
64
64
|
- If already synced: "Archive now", "Sync anyway", "Cancel"
|
|
65
65
|
|
|
66
|
-
If user chooses sync, execute /opsx
|
|
66
|
+
If user chooses sync, execute /opsx:sync logic (use the openspec-sync-specs skill). Proceed to archive regardless of choice.
|
|
67
67
|
|
|
68
68
|
5. **Perform the archive**
|
|
69
69
|
|
|
@@ -11,7 +11,7 @@ metadata:
|
|
|
11
11
|
|
|
12
12
|
Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
|
|
13
13
|
|
|
14
|
-
**IMPORTANT: Explore mode is for thinking, not implementing.** You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first (e.g., start a change with `/opsx
|
|
14
|
+
**IMPORTANT: Explore mode is for thinking, not implementing.** You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first (e.g., start a change with `/opsx:new` or `/opsx:ff`). You MAY create OpenSpec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.
|
|
15
15
|
|
|
16
16
|
**This is a stance, not a workflow.** There are no fixed steps, no required sequence, no mandatory outputs. You're a thinking partner helping the user explore.
|
|
17
17
|
|
|
@@ -96,7 +96,7 @@ This tells you:
|
|
|
96
96
|
Think freely. When insights crystallize, you might offer:
|
|
97
97
|
|
|
98
98
|
- "This feels solid enough to start a change. Want me to create one?"
|
|
99
|
-
→ Can transition to `/opsx
|
|
99
|
+
→ Can transition to `/opsx:new` or `/opsx:ff`
|
|
100
100
|
- Or keep exploring - no pressure to formalize
|
|
101
101
|
|
|
102
102
|
### When a change exists
|
|
@@ -202,7 +202,7 @@ You: [reads codebase]
|
|
|
202
202
|
|
|
203
203
|
**User is stuck mid-implementation:**
|
|
204
204
|
```
|
|
205
|
-
User: /opsx
|
|
205
|
+
User: /opsx:explore add-auth-system
|
|
206
206
|
The OAuth integration is more complex than expected
|
|
207
207
|
|
|
208
208
|
You: [reads change artifacts]
|
|
@@ -252,7 +252,7 @@ You: That changes everything.
|
|
|
252
252
|
|
|
253
253
|
There's no required ending. Discovery might:
|
|
254
254
|
|
|
255
|
-
- **Flow into action**: "Ready to start? /opsx
|
|
255
|
+
- **Flow into action**: "Ready to start? /opsx:new or /opsx:ff"
|
|
256
256
|
- **Result in artifact updates**: "Updated design.md with these decisions"
|
|
257
257
|
- **Just provide clarity**: User has what they need, moves on
|
|
258
258
|
- **Continue later**: "We can pick this up anytime"
|
|
@@ -269,8 +269,8 @@ When it feels like things are crystallizing, you might summarize:
|
|
|
269
269
|
**Open questions**: [if any remain]
|
|
270
270
|
|
|
271
271
|
**Next steps** (if ready):
|
|
272
|
-
- Create a change: /opsx
|
|
273
|
-
- Fast-forward to tasks: /opsx
|
|
272
|
+
- Create a change: /opsx:new <name>
|
|
273
|
+
- Fast-forward to tasks: /opsx:ff <name>
|
|
274
274
|
- Keep exploring: just keep talking
|
|
275
275
|
```
|
|
276
276
|
|
|
@@ -81,7 +81,7 @@ After completing all artifacts, summarize:
|
|
|
81
81
|
- Change name and location
|
|
82
82
|
- List of artifacts created with brief descriptions
|
|
83
83
|
- What's ready: "All artifacts created! Ready for implementation."
|
|
84
|
-
- Prompt: "Run `/opsx
|
|
84
|
+
- Prompt: "Run `/opsx:apply` or ask me to implement to start working on the tasks."
|
|
85
85
|
|
|
86
86
|
**Artifact Creation Guidelines**
|
|
87
87
|
|