From cbfb276edd91d79cfad9a907f6ed841098ef27a9 Mon Sep 17 00:00:00 2001 From: Howard Date: Thu, 7 May 2026 10:58:36 +0800 Subject: [PATCH 1/2] docs(opsx): fix /opsx:sync description and add detailed documentation - Changed description from 'Sync delta specs to main' to 'Merge delta specs into main specs' - Added detailed Usage section for /opsx:sync command - Now consistent with commands.md and migration-guide.md - Improves documentation completeness and clarity --- docs/opsx.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/opsx.md b/docs/opsx.md index bebe0a51d..1252e3324 100644 --- a/docs/opsx.md +++ b/docs/opsx.md @@ -164,7 +164,7 @@ rules: | `/opsx:ff` | Fast-forward planning artifacts (expanded workflow) | | `/opsx:apply` | Implement tasks, updating artifacts as needed | | `/opsx:verify` | Validate implementation against artifacts (expanded workflow) | -| `/opsx:sync` | Sync delta specs to main (default workflow, optional) | +| `/opsx:sync` | Merge delta specs into main specs (optional) | | `/opsx:archive` | Archive when done | | `/opsx:bulk-archive` | Archive multiple completed changes (expanded workflow) | | `/opsx:onboard` | Guided walkthrough of an end-to-end change (expanded workflow) | @@ -208,6 +208,22 @@ Creates all planning artifacts at once. Use when you have a clear picture of wha ``` Works through tasks, checking them off as you go. If you're juggling multiple changes, you can run `/opsx:apply `; otherwise it should infer from the conversation and prompt you to choose if it can't tell. +### Sync delta specs +``` +/opsx:sync +``` +Merges delta specs from the current change into main specs. Optional—archive will prompt to sync if needed. + +**What it does:** +- Reads delta specs from change folder +- Merges changes into main `openspec/specs/` directory +- Does not archive the change (remains active) + +**When to use:** +- You want to update main specs before archiving +- Multiple changes need to see each other's specs +- You're iterating on specs and want to test integration + ### Finish up ``` /opsx:archive # Move to archive when done (prompts to sync specs if needed) From 555eb742678390e6c88eb5b64e20b4a71f5cf912 Mon Sep 17 00:00:00 2001 From: Howard Date: Thu, 7 May 2026 11:24:08 +0800 Subject: [PATCH 2/2] docs(opsx): add language identifier to fenced code block Fix markdownlint MD040 warning --- docs/opsx.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/opsx.md b/docs/opsx.md index 1252e3324..b44e30b18 100644 --- a/docs/opsx.md +++ b/docs/opsx.md @@ -209,7 +209,7 @@ Creates all planning artifacts at once. Use when you have a clear picture of wha Works through tasks, checking them off as you go. If you're juggling multiple changes, you can run `/opsx:apply `; otherwise it should infer from the conversation and prompt you to choose if it can't tell. ### Sync delta specs -``` +```text /opsx:sync ``` Merges delta specs from the current change into main specs. Optional—archive will prompt to sync if needed.