- If changes needed: "Sync now (recommended)", "Archive without syncing"
- If already synced: "Archive now", "Sync anyway", "Cancel"
- If user chooses sync, execute `/opsx-sync` logic. Proceed to archive regardless of choice.
+ If user chooses sync, use Task tool (subagent_type: "general-purpose", prompt: "Use Skill tool to invoke openspec-sync-specs for change '<name>'. Delta spec analysis: <include the analyzed delta spec summary>"). Proceed to archive regardless of choice.
5. **Perform the archive**
- Don't block archive on warnings - just inform and confirm
- Preserve .openspec.yaml when moving to archive (it moves with the directory)
- Show clear summary of what happened
-- If sync is requested, use /opsx-sync approach (agent-driven)
+- If sync is requested, use the Skill tool to invoke `openspec-sync-specs` (agent-driven)
- If delta specs exist, always run the sync assessment and show the combined summary before prompting
```
## No Changes to Archive
-No active changes found. Use `/opsx-new` to create a new change.
+No active changes found. Create a new change to get started.
```
**Guardrails**
Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
-**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.
+**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 and create a change proposal. You MAY create OpenSpec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.
**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.
Think freely. When insights crystallize, you might offer:
-- "This feels solid enough to start a change. Want me to create one?"
- → Can transition to `/opsx-new` or `/opsx-ff`
+- "This feels solid enough to start a change. Want me to create a proposal?"
- Or keep exploring - no pressure to formalize
### When a change exists
There's no required ending. Discovery might:
-- **Flow into action**: "Ready to start? `/opsx-new` or `/opsx-ff`"
+- **Flow into a proposal**: "Ready to start? I can create a change proposal."
- **Result in artifact updates**: "Updated design.md with these decisions"
- **Just provide clarity**: User has what they need, moves on
- **Continue later**: "We can pick this up anytime"
- Follow the `instruction` field from `openspec instructions` for each artifact type
- The schema defines what each artifact should contain - follow it
- Read dependency artifacts for context before creating new ones
-- Use the `template` as a starting point, filling in based on context
+- Use `template` as the structure for your output file - fill in its sections
+- **IMPORTANT**: `context` and `rules` are constraints for YOU, not content for the file
+ - Do NOT copy `<context>`, `<rules>`, `<project_context>` blocks into the artifact
+ - These guide what you write, but should never appear in the output
**Guardrails**
## Preflight
-Before starting, check if OpenSpec is initialized:
+Before starting, check if the OpenSpec CLI is installed:
```bash
-openspec status --json 2>&1 || echo "NOT_INITIALIZED"
+# Unix/macOS
+openspec --version 2>&1 || echo "CLI_NOT_INSTALLED"
+# Windows (PowerShell)
+# if (Get-Command openspec -ErrorAction SilentlyContinue) { openspec --version } else { echo "CLI_NOT_INSTALLED" }
```
-**If not initialized:**
+**If CLI not installed:**
-> OpenSpec isn't set up in this project yet. Run `openspec init` first, then come back to `/opsx-onboard`.
+> OpenSpec CLI is not installed. Install it first, then come back to `/opsx-onboard`.
-Stop here if not initialized.
+Stop here if not installed.
---
Also check recent git activity:
```bash
+# Unix/macOS
git log --oneline -10 2>/dev/null || echo "No git history"
+# Windows (PowerShell)
+# git log --oneline -10 2>$null; if ($LASTEXITCODE -ne 0) { echo "No git history" }
```
### Present Suggestions
**DO:** Create the spec file:
```bash
+# Unix/macOS
mkdir -p openspec/changes/<name>/specs/<capability-name>
+# Windows (PowerShell)
+# New-Item -ItemType Directory -Force -Path "openspec/changes/<name>/specs/<capability-name>"
```
Draft the spec content:
## Command Reference
+**Core workflow:**
+
| Command | What it does |
|---------|--------------|
+| `/opsx-propose` | Create a change and generate all artifacts |
| `/opsx-explore` | Think through problems before/during work |
-| `/opsx-new` | Start a new change, step through artifacts |
-| `/opsx-ff` | Fast-forward: create all artifacts at once |
-| `/opsx-continue` | Continue working on an existing change |
| `/opsx-apply` | Implement tasks from a change |
-| `/opsx-verify` | Verify implementation matches artifacts |
| `/opsx-archive` | Archive a completed change |
+**Additional commands:**
+
+| Command | What it does |
+|---------|--------------|
+| `/opsx-new` | Start a new change, step through artifacts one at a time |
+| `/opsx-continue` | Continue working on an existing change |
+| `/opsx-ff` | Fast-forward: create all artifacts at once |
+| `/opsx-verify` | Verify implementation matches artifacts |
+
---
## What's Next?
-Try `/opsx-new` or `/opsx-ff` on something you actually want to build. You've got the rhythm now!
+Try `/opsx-propose` on something you actually want to build. You've got the rhythm now!
```
---
```
## OpenSpec Quick Reference
+**Core workflow:**
+
| Command | What it does |
|---------|--------------|
+| `/opsx-propose <name>` | Create a change and generate all artifacts |
| `/opsx-explore` | Think through problems (no code changes) |
+| `/opsx-apply <name>` | Implement tasks |
+| `/opsx-archive <name>` | Archive when done |
+
+**Additional commands:**
+
+| Command | What it does |
+|---------|--------------|
| `/opsx-new <name>` | Start a new change, step by step |
-| `/opsx-ff <name>` | Fast-forward: all artifacts at once |
| `/opsx-continue <name>` | Continue an existing change |
-| `/opsx-apply <name>` | Implement tasks |
+| `/opsx-ff <name>` | Fast-forward: all artifacts at once |
| `/opsx-verify <name>` | Verify implementation |
-| `/opsx-archive <name>` | Archive when done |
-Try `/opsx-new` to start your first change, or `/opsx-ff` if you want to move fast.
+Try `/opsx-propose` to start your first change.
```
Exit gracefully.
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Implement tasks from an OpenSpec change.
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Archive a completed change in the experimental workflow.
- If changes needed: "Sync now (recommended)", "Archive without syncing"
- If already synced: "Archive now", "Sync anyway", "Cancel"
- If user chooses sync, execute /opsx-sync logic (use the openspec-sync-specs skill). Proceed to archive regardless of choice.
+ If user chooses sync, use Task tool (subagent_type: "general-purpose", prompt: "Use Skill tool to invoke openspec-sync-specs for change '<name>'. Delta spec analysis: <include the analyzed delta spec summary>"). Proceed to archive regardless of choice.
5. **Perform the archive**
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Archive multiple completed changes in a single operation.
```
## No Changes to Archive
-No active changes found. Use `/opsx-new` to create a new change.
+No active changes found. Create a new change to get started.
```
**Guardrails**
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Continue working on a change by creating the next artifact.
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
-**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.
+**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 and create a change proposal. You MAY create OpenSpec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.
**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.
Think freely. When insights crystallize, you might offer:
-- "This feels solid enough to start a change. Want me to create one?"
- → Can transition to `/opsx-new` or `/opsx-ff`
+- "This feels solid enough to start a change. Want me to create a proposal?"
- Or keep exploring - no pressure to formalize
### When a change exists
There's no required ending. Discovery might:
-- **Flow into action**: "Ready to start? /opsx-new or /opsx-ff"
+- **Flow into a proposal**: "Ready to start? I can create a change proposal."
- **Result in artifact updates**: "Updated design.md with these decisions"
- **Just provide clarity**: User has what they need, moves on
- **Continue later**: "We can pick this up anytime"
**Open questions**: [if any remain]
**Next steps** (if ready):
-- Create a change: /opsx-new <name>
-- Fast-forward to tasks: /opsx-ff <name>
+- Create a change proposal
- Keep exploring: just keep talking
```
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Fast-forward through artifact creation - generate everything needed to start implementation in one go.
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Start a new change using the experimental artifact-driven approach.
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
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.
## Preflight
-Before starting, check if OpenSpec is initialized:
+Before starting, check if the OpenSpec CLI is installed:
```bash
-openspec status --json 2>&1 || echo "NOT_INITIALIZED"
+# Unix/macOS
+openspec --version 2>&1 || echo "CLI_NOT_INSTALLED"
+# Windows (PowerShell)
+# if (Get-Command openspec -ErrorAction SilentlyContinue) { openspec --version } else { echo "CLI_NOT_INSTALLED" }
```
-**If not initialized:**
+**If CLI not installed:**
-> OpenSpec isn't set up in this project yet. Run `openspec init` first, then come back to `/opsx-onboard`.
+> OpenSpec CLI is not installed. Install it first, then come back to `/opsx-onboard`.
-Stop here if not initialized.
+Stop here if not installed.
---
Also check recent git activity:
```bash
+# Unix/macOS
git log --oneline -10 2>/dev/null || echo "No git history"
+# Windows (PowerShell)
+# git log --oneline -10 2>$null; if ($LASTEXITCODE -ne 0) { echo "No git history" }
```
### Present Suggestions
**DO:** Create the spec file:
```bash
+# Unix/macOS
mkdir -p openspec/changes/<name>/specs/<capability-name>
+# Windows (PowerShell)
+# New-Item -ItemType Directory -Force -Path "openspec/changes/<name>/specs/<capability-name>"
```
Draft the spec content:
## Command Reference
+**Core workflow:**
+
| Command | What it does |
|---------|--------------|
+| `/opsx-propose` | Create a change and generate all artifacts |
| `/opsx-explore` | Think through problems before/during work |
-| `/opsx-new` | Start a new change, step through artifacts |
-| `/opsx-ff` | Fast-forward: create all artifacts at once |
-| `/opsx-continue` | Continue working on an existing change |
| `/opsx-apply` | Implement tasks from a change |
-| `/opsx-verify` | Verify implementation matches artifacts |
| `/opsx-archive` | Archive a completed change |
+**Additional commands:**
+
+| Command | What it does |
+|---------|--------------|
+| `/opsx-new` | Start a new change, step through artifacts one at a time |
+| `/opsx-continue` | Continue working on an existing change |
+| `/opsx-ff` | Fast-forward: create all artifacts at once |
+| `/opsx-verify` | Verify implementation matches artifacts |
+
---
## What's Next?
-Try `/opsx-new` or `/opsx-ff` on something you actually want to build. You've got the rhythm now!
+Try `/opsx-propose` on something you actually want to build. You've got the rhythm now!
```
---
```
## OpenSpec Quick Reference
+**Core workflow:**
+
| Command | What it does |
|---------|--------------|
+| `/opsx-propose <name>` | Create a change and generate all artifacts |
| `/opsx-explore` | Think through problems (no code changes) |
+| `/opsx-apply <name>` | Implement tasks |
+| `/opsx-archive <name>` | Archive when done |
+
+**Additional commands:**
+
+| Command | What it does |
+|---------|--------------|
| `/opsx-new <name>` | Start a new change, step by step |
-| `/opsx-ff <name>` | Fast-forward: all artifacts at once |
| `/opsx-continue <name>` | Continue an existing change |
-| `/opsx-apply <name>` | Implement tasks |
+| `/opsx-ff <name>` | Fast-forward: all artifacts at once |
| `/opsx-verify <name>` | Verify implementation |
-| `/opsx-archive <name>` | Archive when done |
-Try `/opsx-new` to start your first change, or `/opsx-ff` if you want to move fast.
+Try `/opsx-propose` to start your first change.
```
Exit gracefully.
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Sync delta specs from a change to main specs.
metadata:
author: openspec
version: '1.0'
- generatedBy: '1.1.1'
+ generatedBy: '1.2.0'
---
Verify that an implementation matches the change artifacts (specs, tasks, design).
repositories / e-mobility-charging-stations-simulator.git / commitdiff
