specweave 0.28.22 → 0.28.24

package/plugins/specweave-ado/commands/specweave-ado-sync.md

@@ -1,29 +1,29 @@
 ---
 name: specweave-ado:sync
-description: Bidirectional sync between SpecWeave increment and Azure DevOps work item (two-way sync by default)
+description: Two-way sync between SpecWeave increment and Azure DevOps work item (push & pull by default)
 ---
 
 # Sync ADO Work Item Command
 
 **Usage**: `/specweave-ado:sync <increment-id> [options]`
 
-**Purpose**: Bidirectional synchronization between SpecWeave increment and Azure DevOps work item
+**Purpose**: Two-way synchronization between SpecWeave increment and Azure DevOps work item
 
-**Default**: Two-way sync (bidirectional)
+**Default**: Two-way sync (push & pull)
 
 ---
 
 ## Options
 
-- `--direction <mode>`: Sync direction (default: `bidirectional`)
-  - `bidirectional`: SpecWeave ↔ ADO (default - recommended)
+- `--direction <mode>`: Sync direction (default: `two-way`)
+  - `two-way`: SpecWeave ↔ ADO (default - recommended)
   - `to-ado`: SpecWeave → ADO only (push progress)
   - `from-ado`: ADO → SpecWeave only (pull updates)
 
 ## Examples
 
 ```bash
-# Bidirectional sync (default - two-way)
+# Two-way sync (default - both directions)
 /specweave-ado:sync 0005
 
 # Push only (one-way to ADO)
@@ -37,7 +37,7 @@ description: Bidirectional sync between SpecWeave increment and Azure DevOps wor
 
 ## Command Behavior
 
-When user runs this command, invoke `ado-manager` agent to perform bidirectional sync:
+When user runs this command, invoke `ado-manager` agent to perform two-way sync:
 
 ### Phase 1: Pull FROM ADO (default behavior)
 1. Fetch work item state from ADO API
@@ -66,7 +66,7 @@ When user runs this command, invoke `ado-manager` agent to perform bidirectional
 ```
 Use Task tool with subagent_type: "specweave-ado:ado-manager:ado-manager"
 
-Prompt: "Bidirectional sync for increment 0005-payment-integration with ADO.
+Prompt: "Two-way sync for increment 0005-payment-integration with ADO.
 
 Phase 1 - Pull FROM ADO:
 1. Fetch work item #12345 from ADO API
@@ -83,20 +83,20 @@ Phase 2 - Push TO ADO:
 6. POST comment to ADO API
 7. Update work item state/fields
 
-Display: Bidirectional sync summary"
+Display: Two-way sync summary"
 ```
 
 ---
 
 ## Example Output
 
-### Bidirectional Sync (Default)
+### Two-way Sync (Default)
 
 ```
-🔄 Bidirectional sync for increment 0005...
+🔄 Two-way sync for increment 0005...
 
 ✓ Azure DevOps work item: #12345
-✓ Sync direction: bidirectional (two-way)
+✓ Sync direction: Two-way (push & pull)
 
 Detecting changes (both directions)...
 

package/plugins/specweave-github/agents/github-manager/AGENT.md

@@ -38,7 +38,7 @@ GitHub issues MUST use living docs format:
 
 **Tools**: Read, Write, Edit, Bash (GitHub CLI)
 
-**Default Behavior**: **Bidirectional sync** (two-way) - Synchronizes changes in both directions automatically
+**Default Behavior**: **Two-way sync** (push & pull) - Synchronizes changes in both directions automatically
 
 ---
 
@@ -69,8 +69,8 @@ Task({
 
 As the GitHub Manager agent, I specialize in:
 
-### 1. Bidirectional Synchronization (Default)
-- **Two-Way Sync**: Keep SpecWeave and GitHub synchronized automatically
+### 1. Two-way Synchronization (Default)
+- **Two-way Sync**: Keep SpecWeave and GitHub synchronized automatically
   - **FROM GitHub**: Pull status changes, labels, comments, state updates
   - **TO GitHub**: Push task completion, progress updates, metadata
 - **Conflict Resolution**: Detect and resolve conflicts between systems
@@ -79,7 +79,7 @@ As the GitHub Manager agent, I specialize in:
 
 ### 2. Issue Management
 - **Create Issues**: Generate well-formatted GitHub issues from increment specs
-- **Update Issues**: Sync progress, add comments, update labels (bidirectional)
+- **Update Issues**: Sync progress, add comments, update labels (two-way)
 - **Close Issues**: Close issues with completion summaries
 - **Link Issues**: Connect related issues, PRs, and increments
 - **Bulk Operations**: Batch create/update/close issues
@@ -87,7 +87,7 @@ As the GitHub Manager agent, I specialize in:
 ### 3. Progress Tracking
 - **Task Checklists**: Generate and update task checklists in issues
 - **Progress Comments**: Post detailed task completion comments
-- **Status Updates**: Bidirectional sync of increment status ↔ GitHub issue state
+- **Status Updates**: Two-way sync of increment status ↔ GitHub issue state
 - **Time Tracking**: Track estimated vs actual time per task
 - **Milestone Progress**: Update milestone completion percentages
 

package/plugins/specweave-github/commands/specweave-github-sync.md

@@ -83,7 +83,7 @@ Synchronize the current state of a SpecWeave increment with its GitHub issue acr
 - `--comment`: Post progress comment (default)
 - `--labels`: Update issue labels based on status
 - `--force`: Force sync even if up-to-date
-- `--direction`: Sync direction (`to-github`, `from-github`, `bidirectional` - **default: bidirectional**)
+- `--direction`: Sync direction (`to-github`, `from-github`, `two-way` - **default: two-way**)
 - `--all`: Sync all active increments
 
 ### Safety Options
@@ -92,17 +92,17 @@ Synchronize the current state of a SpecWeave increment with its GitHub issue acr
 
 ## Sync Direction
 
-**Default: Bidirectional** (two-way sync)
+**Default: Two-way** (both directions)
 
 SpecWeave syncs changes in **both directions** by default:
 
 | Direction | What It Does | Use When |
 |-----------|-------------|----------|
-| **`bidirectional`** (default) | SpecWeave ↔ GitHub<br>• Pull changes FROM GitHub (status, labels, comments)<br>• Push changes TO GitHub (tasks, progress, metadata) | **Always** (recommended for keeping both systems in sync) |
+| **`two-way`** (default) | SpecWeave ↔ GitHub<br>• Pull changes FROM GitHub (status, labels, comments)<br>• Push changes TO GitHub (tasks, progress, metadata) | **Always** (recommended for keeping both systems in sync) |
 | `to-github` | SpecWeave → GitHub only<br>• Push increment progress to GitHub<br>• Don't pull GitHub changes back | Read-only GitHub usage, or when GitHub is downstream |
 | `from-github` | GitHub → SpecWeave only<br>• Pull GitHub issue updates<br>• Don't push SpecWeave changes | Importing GitHub issues, or when SpecWeave is downstream |
 
-**Why Bidirectional?**
+**Why Two-way?**
 - ✅ Keep both systems synchronized automatically
 - ✅ GitHub status changes update SpecWeave (closed issue → completed increment)
 - ✅ SpecWeave task completion updates GitHub (task done → checklist updated)
@@ -121,16 +121,16 @@ SpecWeave syncs changes in **both directions** by default:
 ## Examples
 
 ```bash
-# Interactive bidirectional sync (default - two-way)
+# Interactive two-way sync (default - both directions)
 /specweave-github:sync 0004
 
-# Use specific profile (still bidirectional by default)
+# Use specific profile (still two-way by default)
 /specweave-github:sync 0004 --profile specweave-dev
 
-# Specify time range (bidirectional)
+# Specify time range (two-way)
 /specweave-github:sync 0004 --time-range 1M
 
-# Full bidirectional sync with all options
+# Full two-way sync with all options
 /specweave-github:sync 0004 --profile main --time-range 1M --tasks --labels
 
 # One-way sync examples (override default)
@@ -140,7 +140,7 @@ SpecWeave syncs changes in **both directions** by default:
 # Dry run to preview changes
 /specweave-github:sync 0004 --dry-run
 
-# Force sync all increments (bidirectional)
+# Force sync all increments (two-way)
 /specweave-github:sync --all --force
 ```
 
@@ -240,12 +240,12 @@ Continue with sync? [Y/n]:
 If confirmed, sync proceeds with progress updates:
 
 ```
-🔄 Bidirectional sync for increment 0004...
+🔄 Two-way sync for increment 0004...
 
 ✓ Profile loaded: specweave-dev
 ✓ GitHub repository: anton-abyzov/specweave
 ✓ Rate limit check: PASSED (4,850/5,000 remaining)
-✓ Sync direction: bidirectional (two-way)
+✓ Sync direction: Two-way (push & pull)
 
 Fetching increment state...
 ✓ Increment loaded: 0004-plugin-architecture
@@ -277,7 +277,7 @@ Syncing FROM GitHub...
 
 Rate limit after sync: 4,570/5,000 (91% available)
 
-✅ Bidirectional Sync Complete!
+✅ Two-way Sync Complete!
 
    SpecWeave ↔ GitHub synchronized
    • Pushed: 3 task updates, progress comment

package/plugins/specweave-github/commands/specweave-github-update-user-story.md

@@ -111,7 +111,7 @@ Progress: 3/6 tasks complete (50%)
 **Related Commands**:
 - `/specweave-github:sync-epic FS-031` - Sync entire epic (all user stories)
 - `/specweave-github:create-issue 0031` - Create issue for increment
-- `/specweave-github:sync 0031` - Bidirectional sync for increment
+- `/specweave-github:sync 0031` - Two-way sync for increment
 
 ---
 

package/plugins/specweave-github/skills/github-sync/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: github-sync
-description: Bidirectional synchronization between SpecWeave specs and GitHub Projects (two-way sync by default). Activates ONLY when user asks questions about GitHub integration or needs help configuring GitHub sync. Does NOT activate for slash commands. For syncing, use /specweave-github:sync-spec command instead.
+description: Two-way synchronization between SpecWeave specs and GitHub Projects (push & pull by default). Activates ONLY when user asks questions about GitHub integration or needs help configuring GitHub sync. Does NOT activate for slash commands. For syncing, use /specweave-github:sync-spec command instead.
 ---
 
-# GitHub Sync - Bidirectional Spec ↔ Project Synchronization
+# GitHub Sync - Two-way Spec ↔ Project Synchronization
 
 **Purpose**: Seamlessly synchronize SpecWeave specs with GitHub Projects for team visibility and project management.
 
-**Default Behavior**: **Bidirectional (two-way) sync** - Changes in either system are automatically synchronized
+**Default Behavior**: **Two-way sync** (push & pull) - Changes in either system are automatically synchronized
 
 **⚠️ IMPORTANT**: This skill provides HELP and GUIDANCE about GitHub sync. For actual syncing, users should use the `/specweave-github:sync-spec` command directly. This skill should NOT auto-activate when the command is being invoked.
 
@@ -203,7 +203,7 @@ Configure GitHub sync in `.specweave/config.json`:
       "specweave-github": {
         "repo": "owner/repo",
         "autoSyncSpecs": true,
-        "syncDirection": "bidirectional",
+        "syncDirection": "two-way",
         "defaultLabels": ["specweave", "spec"],
         "syncFrequency": "on-change"
       }

package/plugins/specweave-jira/commands/specweave-jira-sync.md

@@ -1,6 +1,6 @@
 ---
 name: specweave-jira:sync
-description: Sync SpecWeave increments with JIRA epics/stories. Supports import, export, bidirectional sync, and granular item operations
+description: Sync SpecWeave increments with JIRA epics/stories. Supports import, export, two-way sync, and granular item operations
 ---
 
 # Sync Jira Command
@@ -11,10 +11,10 @@ You are a Jira synchronization expert. Help the user sync between Jira and SpecW
 
 ### Epic-Level Operations
 
-**1. Bidirectional Sync (Default - Recommended)**
+**1. Two-way Sync (Default - Recommended)**
 ```
 /specweave-jira:sync 0003                    # Two-way sync (default)
-/specweave-jira:sync 0003 --direction bidirectional  # Explicit
+/specweave-jira:sync 0003 --direction two-way  # Explicit
 ```
 
 **2. Import Jira Epic as SpecWeave Increment**
@@ -31,9 +31,9 @@ You are a Jira synchronization expert. Help the user sync between Jira and SpecW
 
 ### Sync Direction Options
 
-**Default: `bidirectional`** (two-way sync - recommended)
+**Default: `two-way`** (both directions - recommended)
 
-- `--direction bidirectional`: SpecWeave ↔ Jira (default)
+- `--direction two-way`: SpecWeave ↔ Jira (default)
   - Pull changes FROM Jira (status, priority, comments)
   - Push changes TO Jira (tasks, progress, metadata)
 
@@ -175,7 +175,7 @@ When the user runs this command:
   | Task  | SCRUM-7  | Setup provider  |
   ```
 
-### Example 5: Bidirectional Sync (Default)
+### Example 5: Two-way Sync (Default)
 **User**: `/specweave-jira:sync 0003`
 **You**:
 - Read increment 0003
@@ -186,9 +186,9 @@ When the user runs this command:
 - FROM Jira: Status changes, priority updates, comments
 - FROM SpecWeave: Task completion, progress updates
 
-**Show bidirectional sync summary**:
+**Show two-way sync summary**:
 ```
-✅ Bidirectional Sync Complete: 0003 ↔ Jira
+✅ Two-way Sync Complete: 0003 ↔ Jira
 
 FROM Jira:
   • SCRUM-1: Status changed to In Progress
@@ -204,7 +204,7 @@ Conflicts: None
 **Handle conflicts if any**:
 - Show both versions (Jira vs SpecWeave)
 - Ask user which to keep or how to merge
-- Apply resolution bidirectionally
+- Apply resolution in both directions
 
 ### Example 6: Status Overview
 **User**: `/specweave-jira:sync status`
@@ -229,12 +229,12 @@ Conflicts: None
 
 ## Related Commands
 
-- `/specweave-github:sync` - Sync to GitHub issues (also bidirectional by default)
+- `/specweave-github:sync` - Sync to GitHub issues (also two-way by default)
 - `/specweave:increment` - Create new increment
 - `/specweave:validate` - Validate increment quality
 
 ---
 
-**Bidirectional by Default**: All sync operations are two-way unless you explicitly specify `--direction to-jira` or `--direction from-jira`. This keeps both systems synchronized automatically.
+**Two-way by Default**: All sync operations are two-way unless you explicitly specify `--direction to-jira` or `--direction from-jira`. This keeps both systems synchronized automatically.
 
 **Granular Control**: Unlike simple epic import/export, this command supports cherry-picking individual stories, bugs, and tasks for maximum flexibility.

package/plugins/specweave-jira/skills/specweave-jira-mapper/SKILL.md

@@ -328,7 +328,7 @@ JIRA Epic: PROJ-123
    ```yaml
    jira:
      last_sync: "2025-10-26T16:30:00Z"
-     sync_direction: "bidirectional"
+     sync_direction: "two-way"
      conflicts_resolved: 2
    ```
 
@@ -336,7 +336,7 @@ JIRA Epic: PROJ-123
 ```
 ✅ Synced with JIRA!
 
-Direction: Bidirectional
+Direction: Two-way
 Changes Applied:
   - SpecWeave → JIRA: 3 updates
   - JIRA → SpecWeave: 5 updates