specweave 0.10.1 → 0.11.0

package/plugins/specweave/skills/plugin-installer/SKILL.md

@@ -1,21 +1,36 @@
 ---
 name: plugin-installer
-description: Proactive just-in-time plugin installation. Auto-detects when specialized plugins are needed (docs-preview, frontend, kubernetes, ML, payments, testing, etc.) and installs them automatically before use. Activates for preview docs, Docusaurus, React, Next.js, K8s, Kubernetes, Helm, TensorFlow, PyTorch, ML model, Stripe, billing, payment, Playwright, E2E testing, Figma, design system, ADO, Azure DevOps, infrastructure, Prometheus, Grafana, monitoring, Node.js, Python backend, REST API, cloud deployment, diagram, Mermaid, C4, architecture diagram.
+description: DEPRECATED - This skill is no longer needed. All plugins are now installed automatically during specweave init. This skill remains for backward compatibility but should NOT activate.
 ---
 
-# Plugin Installer - Proactive Just-in-Time Plugin Installation
+# Plugin Installer - DEPRECATED
 
-**Purpose**: Automatically detect when specialized SpecWeave plugins are needed and install them just-in-time, BEFORE attempting to use their features.
+**Status**: ⚠️ **DEPRECATED** - Do not use this skill
 
-**When to Activate**: Whenever user requests functionality that requires a specific plugin (e.g., "preview docs", "deploy to K8s", "add React component", "train ML model", etc.)
+**Reason**: As of v0.11.0+, ALL SpecWeave plugins (19+) are automatically installed during `specweave init`. There is no need for just-in-time plugin installation anymore.
+
+**What Changed**:
+- ❌ Old: Selective plugin loading with just-in-time installation
+- ✅ New: All plugins installed upfront during init
+
+**If you see this skill activating**, it means you're using an old SpecWeave installation. Run `specweave init` again to get all plugins installed automatically.
 
 ---
 
-## 🚨 CRITICAL: The Plugin Installation Gap
+## For Contributors: Why This Was Deprecated
 
-**The Problem**: Users request features that require plugins (e.g., "preview docs locally"), but those plugins are NOT installed. Claude tries to use plugin features anyway, which fails silently or produces incomplete results.
+**The Problem with Just-in-Time Installation**:
+- Added complexity to the workflow
+- Users had to wait for installations mid-work
+- Network issues could block work unexpectedly
+- Detection logic was fragile (keyword matching)
 
-**The Solution**: This skill proactively detects plugin requirements, checks if plugins are installed, and auto-installs them BEFORE attempting to use their features.
+**The Solution - Install Everything Upfront**:
+- All 19+ plugins installed during `specweave init`
+- Takes ~30 seconds upfront but saves time later
+- All capabilities available immediately
+- No network dependencies during work
+- Simpler, more predictable user experience
 
 ---
 

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

@@ -23,6 +23,8 @@ context: |
 - API authentication and rate limiting
 - Error handling and retry strategies
 
+**Default Behavior**: **Bidirectional sync** (two-way) - Synchronizes changes in both directions automatically
+
 ---
 
 ## 🚨 CRITICAL: Concept Mapping (MANDATORY)

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

@@ -1,49 +1,142 @@
 ---
 name: specweave-ado:sync
-description: Sync SpecWeave increment progress with Azure DevOps work item
+description: Bidirectional sync between SpecWeave increment and Azure DevOps work item (two-way sync by default)
 ---
 
 # Sync ADO Work Item Command
 
-**Usage**: `/specweave-ado:sync <increment-id>`
+**Usage**: `/specweave-ado:sync <increment-id> [options]`
 
-**Purpose**: Update ADO work item with current increment progress
+**Purpose**: Bidirectional synchronization between SpecWeave increment and Azure DevOps work item
+
+**Default**: Two-way sync (bidirectional)
 
 ---
 
-## Command Behavior
+## Options
+
+- `--direction <mode>`: Sync direction (default: `bidirectional`)
+  - `bidirectional`: 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)
+/specweave-ado:sync 0005
+
+# Push only (one-way to ADO)
+/specweave-ado:sync 0005 --direction to-ado
+
+# Pull only (one-way from ADO)
+/specweave-ado:sync 0005 --direction from-ado
+```
+
+---
 
-When user runs this command, invoke `ado-manager` agent to:
+## Command Behavior
 
+When user runs this command, invoke `ado-manager` agent to perform bidirectional sync:
+
+### Phase 1: Pull FROM ADO (default behavior)
+1. Fetch work item state from ADO API
+2. Detect changes in ADO:
+   - State changes (New → Active → Resolved → Closed)
+   - Priority changes
+   - Iteration/sprint changes
+   - Comments from team members
+   - Field updates
+3. Apply ADO changes to SpecWeave increment:
+   - Update increment status to match ADO state
+   - Update priority in metadata
+   - Import team comments to increment notes
+   - Update iteration tracking
+
+### Phase 2: Push TO ADO (default behavior)
 1. Read tasks.md from increment
 2. Calculate completion percentage
 3. Identify recently completed tasks
 4. Format progress update comment
 5. POST comment to ADO work item
 6. Update work item state if needed (New → Active → Resolved)
+7. Update custom fields (completion %, current task, etc.)
 
 **Agent Invocation**:
 ```
 Use Task tool with subagent_type: "ado-manager"
 
-Prompt: "Sync progress for increment 0005-payment-integration to ADO.
+Prompt: "Bidirectional sync for increment 0005-payment-integration with ADO.
 
-Steps:
+Phase 1 - Pull FROM ADO:
+1. Fetch work item #12345 from ADO API
+2. Detect changes: state, priority, iteration, comments
+3. Apply ADO changes to increment metadata
+4. Import team comments to increment notes
+
+Phase 2 - Push TO ADO:
 1. Read .specweave/increments/0005/tasks.md
 2. Calculate: X/Y tasks complete (Z%)
 3. Identify: Recently completed tasks
 4. Format comment with progress update
 5. Load work item ID from increment-metadata.json
 6. POST comment to ADO API
-7. Display: Sync confirmation"
+7. Update work item state/fields
+
+Display: Bidirectional sync summary"
 ```
 
 ---
 
 ## Example Output
 
+### Bidirectional Sync (Default)
+
+```
+🔄 Bidirectional sync for increment 0005...
+
+✓ Azure DevOps work item: #12345
+✓ Sync direction: bidirectional (two-way)
+
+Detecting changes (both directions)...
+
+FROM ADO:
+✓ Work item state changed: Active → Resolved
+✓ Iteration updated: Sprint 23 → Sprint 24
+✓ Priority changed: 2 → 1
+✓ 3 new comments from team
+
+FROM SpecWeave:
+✓ 2 new tasks completed (T-005, T-006)
+✓ Progress: 40% → 60% (6/10 tasks)
+✓ Current task: T-007
+
+Syncing TO ADO...
+✓ Posted progress comment (ID: 98765)
+✓ Updated completion: 60%
+✓ Updated current task field: T-007
+
+Syncing FROM ADO...
+✓ Updated increment status: active → completed
+✓ Updated priority: P2 → P1
+✓ Updated iteration tracking: Sprint 24
+✓ Imported 3 team comments to increment notes
+
+✅ Bidirectional Sync Complete!
+
+   SpecWeave ↔ ADO synchronized
+   • Pushed: Progress (60%), 2 task updates
+   • Pulled: State (Resolved), priority (P1), iteration, 3 comments
+
+ADO Work Item: https://dev.azure.com/myorg/MyProject/_workitems/edit/12345
+Last synced: just now
+Next sync: Automatic (hook-based) or manual when ready
+```
+
+### One-Way Sync (to-ado)
+
 ```
-✅ Synced to ADO Epic #12345
+✅ Pushed to ADO Work Item #12345
 
 Progress: 60% complete (6/10 tasks)
 

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

@@ -1,16 +1,20 @@
 ---
 name: ado-sync
-description: Bidirectional synchronization between SpecWeave increments and Azure DevOps work items. Creates work items from increments, tracks progress via comments, updates increment status from work item state, and closes work items when increments complete. Activates for: Azure DevOps, ADO, work items, project management, sync to ADO, ADO integration, TFS integration.
+description: Bidirectional synchronization between SpecWeave increments and Azure DevOps work items (two-way sync by default). Creates work items from increments, tracks progress via comments, updates increment status from work item state, syncs changes in both directions automatically. Activates for: Azure DevOps, ADO, work items, project management, sync to ADO, ADO integration, TFS integration, bidirectional ADO sync.
 ---
 
 # Azure DevOps Sync Skill
 
 **Purpose**: Seamlessly sync SpecWeave increments with Azure DevOps work items for unified project tracking.
 
+**Default Behavior**: **Bidirectional (two-way) sync** - Changes in either system are automatically synchronized
+
 **Capabilities**:
+- Bidirectional sync: SpecWeave ↔ ADO (default)
 - Create ADO work items from increments
-- Sync task progress → ADO comments  
-- Update increment status from ADO state
+- Sync task progress → ADO comments
+- Update increment status ← ADO state changes
+- Pull ADO comments and field updates → SpecWeave
 - Close work items when increments complete
 - Support for Epics, Features, User Stories
 

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

@@ -6,23 +6,33 @@
 
 **Tools**: Read, Write, Edit, Bash (GitHub CLI)
 
+**Default Behavior**: **Bidirectional sync** (two-way) - Synchronizes changes in both directions automatically
+
 ---
 
 ## Capabilities
 
 As the GitHub Manager agent, I specialize in:
 
-### 1. Issue Management
+### 1. Bidirectional 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
+- **Smart Merging**: Merge changes from both directions intelligently
+- **Change Detection**: Track what changed in both systems since last sync
+
+### 2. Issue Management
 - **Create Issues**: Generate well-formatted GitHub issues from increment specs
-- **Update Issues**: Sync progress, add comments, update labels
+- **Update Issues**: Sync progress, add comments, update labels (bidirectional)
 - **Close Issues**: Close issues with completion summaries
 - **Link Issues**: Connect related issues, PRs, and increments
 - **Bulk Operations**: Batch create/update/close issues
 
-### 2. Progress Tracking
+### 3. Progress Tracking
 - **Task Checklists**: Generate and update task checklists in issues
 - **Progress Comments**: Post detailed task completion comments
-- **Status Updates**: Real-time sync of increment status to GitHub
+- **Status Updates**: Bidirectional 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

@@ -26,32 +26,64 @@ 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`)
+- `--direction`: Sync direction (`to-github`, `from-github`, `bidirectional` - **default: bidirectional**)
 - `--all`: Sync all active increments
 
 ### Safety Options
 - `--dry-run`: Preview changes without applying
 - `--skip-rate-check`: Skip rate limit validation (not recommended)
 
+## Sync Direction
+
+**Default: Bidirectional** (two-way sync)
+
+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) |
+| `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?**
+- ✅ Keep both systems synchronized automatically
+- ✅ GitHub status changes update SpecWeave (closed issue → completed increment)
+- ✅ SpecWeave task completion updates GitHub (task done → checklist updated)
+- ✅ Team members can work in either tool
+- ✅ No data loss from changes in either system
+
+**Override if needed:**
+```bash
+# Push only (one-way to GitHub)
+/specweave-github:sync 0004 --direction to-github
+
+# Pull only (one-way from GitHub)
+/specweave-github:sync 0004 --direction from-github
+```
+
 ## Examples
 
 ```bash
-# Interactive sync (select profile + time range)
+# Interactive bidirectional sync (default - two-way)
 /specweave-github:sync 0004
 
-# Use specific profile
+# Use specific profile (still bidirectional by default)
 /specweave-github:sync 0004 --profile specweave-dev
 
-# Specify time range
+# Specify time range (bidirectional)
 /specweave-github:sync 0004 --time-range 1M
 
-# Full sync with all options
+# Full bidirectional sync with all options
 /specweave-github:sync 0004 --profile main --time-range 1M --tasks --labels
 
+# One-way sync examples (override default)
+/specweave-github:sync 0004 --direction to-github     # Push only
+/specweave-github:sync 0004 --direction from-github   # Pull only
+
 # Dry run to preview changes
 /specweave-github:sync 0004 --dry-run
 
-# Force sync all increments
+# Force sync all increments (bidirectional)
 /specweave-github:sync --all --force
 ```
 
@@ -151,35 +183,52 @@ Continue with sync? [Y/n]:
 If confirmed, sync proceeds with progress updates:
 
 ```
-🔄 Syncing increment 0004 to GitHub...
+🔄 Bidirectional 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)
 
 Fetching increment state...
 ✓ Increment loaded: 0004-plugin-architecture
 ✓ GitHub issue: #130
 ✓ Last synced: 30 minutes ago
 
-Detecting changes...
+Detecting changes (both directions)...
+
+FROM GitHub:
+✓ Issue status changed: open → closed
+✓ Label added: ready-for-release
+✓ 2 new comments from team
+
+FROM SpecWeave:
 ✓ 3 new tasks completed (T-005, T-006, T-007)
 ✓ Progress: 4/48 → 7/48 (15%)
 ✓ Current task: T-008
 
-Syncing to GitHub...
+Syncing TO GitHub...
 ✓ Posted progress comment (ID: 1234567)
 ✓ Updated task checklist (7 tasks marked complete)
 ✓ Updated labels: +in-progress
 ✓ Metadata updated
 
+Syncing FROM GitHub...
+✓ Updated increment status: active → completed
+✓ Applied label: ready-for-release
+✓ Imported 2 team comments to increment notes
+
 Rate limit after sync: 4,570/5,000 (91% available)
 
-✅ Sync Complete!
+✅ Bidirectional Sync Complete!
+
+   SpecWeave ↔ GitHub synchronized
+   • Pushed: 3 task updates, progress comment
+   • Pulled: Status change, label, 2 comments
 
 GitHub Issue: https://github.com/anton-abyzov/specweave/issues/130
 Last synced: just now
-Next sync: Use /specweave-github:sync 0004 when ready
+Next sync: Automatic (hook-based) or manual when ready
 ```
 
 ## Key Features

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

@@ -1,12 +1,14 @@
 ---
 name: github-sync
-description: Bidirectional synchronization between SpecWeave increments and GitHub Issues. Creates issues from increments, tracks progress via comments, updates increment status from issue state, and closes issues when increments complete. Activates for GitHub sync, issue creation, increment tracking, GitHub integration, issue management, sync to GitHub.
+description: Bidirectional synchronization between SpecWeave increments and GitHub Issues (two-way sync by default). Creates issues from increments, tracks progress via comments, updates increment status from issue state, syncs changes in both directions automatically. Activates for GitHub sync, issue creation, increment tracking, GitHub integration, issue management, sync to GitHub, bidirectional sync.
 ---
 
 # GitHub Sync - Bidirectional Increment ↔ Issue Synchronization
 
 **Purpose**: Seamlessly synchronize SpecWeave increments with GitHub Issues for team visibility and project management.
 
+**Default Behavior**: **Bidirectional (two-way) sync** - Changes in either system are automatically synchronized
+
 **When to Use**:
 - Creating new increments (auto-create GitHub issue)
 - Syncing increment progress to GitHub (comments with task completion %)

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

@@ -6,31 +6,41 @@
 
 **Tools**: Read, Write, Edit, Bash (curl for Jira API)
 
+**Default Behavior**: **Bidirectional sync** (two-way) - Synchronizes changes in both directions automatically
+
 ---
 
 ## Capabilities
 
 As the Jira Manager agent, I specialize in:
 
-### 1. Epic Management
+### 1. Bidirectional Synchronization (Default)
+- **Two-Way Sync**: Keep SpecWeave and Jira synchronized automatically
+  - **FROM Jira**: Pull status changes, priority updates, sprint assignments, comments
+  - **TO Jira**: Push task completion, progress updates, story points, metadata
+- **Conflict Resolution**: Detect and resolve conflicts between systems
+- **Smart Merging**: Merge changes from both directions intelligently
+- **Change Detection**: Track what changed in both systems since last sync
+
+### 2. Epic Management
 - **Create Epics**: Generate Jira Epics from SpecWeave increments
-- **Update Epics**: Sync progress, update status, add comments
+- **Update Epics**: Bidirectional sync of progress, status, comments
 - **Close Epics**: Close epics with completion summaries
 - **Link Epics**: Connect related epics, stories, and tasks
 - **Custom Fields**: Handle custom fields, labels, versions
 
-### 2. Story & Task Management
+### 3. Story & Task Management
 - **Create Stories**: Map SpecWeave specs to Jira Stories (PRD or RFC)
 - **Create Tasks**: Map SpecWeave tasks to Jira Tasks
-- **Update Status**: Real-time sync of task completion
+- **Update Status**: Bidirectional sync of task completion
 - **Subtasks**: Handle Jira subtasks and dependencies
 - **Bulk Operations**: Batch create/update stories and tasks
 
-### 3. Progress Tracking
-- **Sprint Progress**: Track epic progress within sprints
+### 4. Progress Tracking
+- **Sprint Progress**: Track epic progress within sprints (bidirectional)
 - **Story Points**: Calculate and update story points
-- **Status Updates**: Sync status changes bidirectionally
-- **Comments**: Post task completion comments
+- **Status Updates**: Bidirectional sync of status changes
+- **Comments**: Post task completion comments and import Jira comments
 - **Time Tracking**: Track estimated vs actual time
 
 ### 4. Jira API Operations

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

@@ -11,39 +11,60 @@ You are a Jira synchronization expert. Help the user sync between Jira and SpecW
 
 ### Epic-Level Operations
 
-**1. Import Jira Epic as SpecWeave Increment**
+**1. Bidirectional Sync (Default - Recommended)**
 ```
-/specweave:sync-jira import SCRUM-123
+/specweave-jira:sync 0003                    # Two-way sync (default)
+/specweave-jira:sync 0003 --direction bidirectional  # Explicit
 ```
 
-**2. Sync existing linked Increment with Jira**
+**2. Import Jira Epic as SpecWeave Increment**
 ```
-/specweave:sync-jira sync 0003
+/specweave-jira:sync import SCRUM-123        # One-time pull
+/specweave-jira:sync SCRUM-123 --direction from-jira  # Same as import
 ```
 
 **3. Export SpecWeave Increment to Jira**
 ```
-/specweave:sync-jira export 0001
+/specweave-jira:sync export 0001             # One-time push
+/specweave-jira:sync 0001 --direction to-jira  # Same as export
 ```
 
+### Sync Direction Options
+
+**Default: `bidirectional`** (two-way sync - recommended)
+
+- `--direction bidirectional`: SpecWeave ↔ Jira (default)
+  - Pull changes FROM Jira (status, priority, comments)
+  - Push changes TO Jira (tasks, progress, metadata)
+
+- `--direction to-jira`: SpecWeave → Jira only
+  - Push increment progress to Jira
+  - Don't pull Jira changes back
+  - Same as `export` operation
+
+- `--direction from-jira`: Jira → SpecWeave only
+  - Pull Jira issue updates
+  - Don't push SpecWeave changes
+  - Same as `import` operation
+
 ### Granular Item Operations
 
 **4. Add specific Story/Bug/Task to existing Increment**
 ```
-/specweave:sync-jira add SCRUM-1 to 0003
-/specweave:sync-jira add SCRUM-1              # Adds to current increment
+/specweave-jira:sync add SCRUM-1 to 0003
+/specweave-jira:sync add SCRUM-1              # Adds to current increment
 ```
 
 **5. Create Increment from specific items (cherry-pick)**
 ```
-/specweave:sync-jira create "User Authentication" from SCRUM-1 SCRUM-5 SCRUM-7
-/specweave:sync-jira create "Bug Fixes Sprint 1" from SCRUM-10 SCRUM-15 SCRUM-20
+/specweave-jira:sync create "User Authentication" from SCRUM-1 SCRUM-5 SCRUM-7
+/specweave-jira:sync create "Bug Fixes Sprint 1" from SCRUM-10 SCRUM-15 SCRUM-20
 ```
 
 **6. Show sync status**
 ```
-/specweave:sync-jira status
-/specweave:sync-jira status 0003              # Status of specific increment
+/specweave-jira:sync status
+/specweave-jira:sync status 0003              # Status of specific increment
 ```
 
 ## Your Task
@@ -154,19 +175,39 @@ When the user runs this command:
   | Task  | SCRUM-7  | Setup provider  |
   ```
 
-### Example 5: Sync Existing Increment
-**User**: `/specweave:sync-jira sync 0003`
+### Example 5: Bidirectional Sync (Default)
+**User**: `/specweave-jira:sync 0003`
 **You**:
 - Read increment 0003
 - Find linked Jira items (from spec.md frontmatter.work_items)
 - Fetch current state from Jira
-- Detect changes (status, priority, description)
-- Show conflicts if any
-- Apply sync bidirectionally
-- Display: "✅ Synced 0003 | Updated: 2 items | SCRUM-1 → in-progress, SCRUM-10 → completed"
+
+**Detect changes (both directions)**:
+- FROM Jira: Status changes, priority updates, comments
+- FROM SpecWeave: Task completion, progress updates
+
+**Show bidirectional sync summary**:
+```
+✅ Bidirectional Sync Complete: 0003 ↔ Jira
+
+FROM Jira:
+  • SCRUM-1: Status changed to In Progress
+  • SCRUM-10: Priority raised to P1
+
+FROM SpecWeave:
+  • 3 tasks completed (T-005, T-006, T-007)
+  • Progress: 60% → 75%
+
+Conflicts: None
+```
+
+**Handle conflicts if any**:
+- Show both versions (Jira vs SpecWeave)
+- Ask user which to keep or how to merge
+- Apply resolution bidirectionally
 
 ### Example 6: Status Overview
-**User**: `/specweave:sync-jira status`
+**User**: `/specweave-jira:sync status`
 **You**:
 - Scan all increments for Jira metadata
 - Show table:
@@ -188,10 +229,12 @@ When the user runs this command:
 
 ## Related Commands
 
-- `/specweave:sync-github` - Sync to GitHub issues
+- `/specweave-github:sync` - Sync to GitHub issues (also bidirectional 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.
+
 **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/jira-sync/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jira-sync
-description: Sync SpecWeave increments with JIRA epics/stories. Activates for JIRA sync, create JIRA issue, import from JIRA, sync to JIRA. Coordinates with specweave-jira-mapper agent.
+description: Bidirectional sync between SpecWeave increments and JIRA epics/stories (two-way sync by default). Activates for JIRA sync, create JIRA issue, import from JIRA, sync to JIRA, bidirectional JIRA sync. Coordinates with specweave-jira-mapper agent.
 allowed-tools: Read, Write, Edit, Task, Bash
 ---
 
@@ -8,11 +8,13 @@ allowed-tools: Read, Write, Edit, Task, Bash
 
 Coordinates JIRA synchronization by delegating to `specweave-jira-mapper` agent.
 
+**Default Behavior**: **Bidirectional (two-way) sync** - Changes synchronized in both directions automatically
+
 ## Responsibilities
 
-1. Detect sync requests (export, import, bidirectional)
+1. Detect sync requests (bidirectional by default, or export/import if specified)
 2. Validate prerequisites (JIRA credentials, increment structure)
-3. Invoke `specweave-jira-mapper` agent
+3. Invoke `specweave-jira-mapper` agent with sync direction
 4. Handle errors gracefully
 
 ---