specfact-cli 0.25.2__tar.gz → 0.26.0__tar.gz

{specfact_cli-0.25.2 → specfact_cli-0.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.25.2
+Version: 0.26.0
 Summary: Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts. Automate legacy code documentation and prevent modernization regressions.
 Project-URL: Homepage, https://github.com/nold-ai/specfact-cli
 Project-URL: Repository, https://github.com/nold-ai/specfact-cli.git
@@ -223,6 +223,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.11
+Requires-Dist: azure-identity>=1.17.1
 Requires-Dist: beartype>=0.22.4
 Requires-Dist: crosshair-tool>=0.0.97
 Requires-Dist: gitpython>=3.1.45
@@ -237,6 +238,7 @@ Requires-Dist: opentelemetry-sdk>=1.27.0
 Requires-Dist: pydantic>=2.12.3
 Requires-Dist: python-dotenv>=1.2.1
 Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: requests>=2.32.3
 Requires-Dist: rich<13.6.0,>=13.5.2
 Requires-Dist: ruamel-yaml>=0.18.16
 Requires-Dist: ruff>=0.14.2
@@ -446,8 +448,11 @@ specfact validate sidecar run my-project /path/to/repo
 - **Role-based workflows** - Product Owners, Architects, Developers work in parallel
 - **Markdown-based** - No YAML editing required
 - **Agile/scrum ready** - DoR checklists, story points, dependencies
+- **Backlog standardization** 🆕 - Template-driven refinement with persona/framework filtering
+- **Sprint/iteration filtering** 🆕 - Filter by sprint, release, iteration for agile workflows
 
-👉 **[Agile/Scrum Workflows](docs/guides/agile-scrum-workflows.md)** - Team collaboration guide
+👉 **[Agile/Scrum Workflows](docs/guides/agile-scrum-workflows.md)** - Team collaboration guide  
+👉 **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 - Standardize backlog items with templates
 
 ### 🔌 Integrations
 
@@ -455,9 +460,11 @@ specfact validate sidecar run my-project /path/to/repo
 - **GitHub Actions** - Automated quality gates
 - **AI IDEs** - Generate prompts for fixing gaps
 - **DevOps tools** - Sync with GitHub Issues, Linear, Jira
+- **Backlog Refinement** 🆕 - AI-assisted template-driven refinement for standardizing work items
 - **Spec-Kit, OpenSpec, Specmatic** - Works with your existing tools
 
-👉 **[Integrations Overview](docs/guides/integrations-overview.md)** - All integration options
+👉 **[Integrations Overview](docs/guides/integrations-overview.md)** - All integration options  
+👉 **[Backlog Refinement Guide](docs/guides/backlog-refinement.md)** 🆕 **NEW** - Template-driven backlog standardization
 
 ---
 
@@ -523,6 +530,7 @@ specfact validate sidecar run my-project /path/to/repo
 - **[OpenSpec Journey](docs/guides/openspec-journey.md)** - OpenSpec integration
 - **[Specmatic Integration](docs/guides/specmatic-integration.md)** - API contract testing
 - **[DevOps Adapter Integration](docs/guides/devops-adapter-integration.md)** - GitHub Issues, Linear, Jira
+- **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 **NEW** - AI-assisted template-driven backlog standardization
 
 👉 **[Full Documentation Index](docs/README.md)** - Browse all documentation  
 👉 **[Online Documentation](https://docs.specfact.io/)** - Complete documentation site

{specfact_cli-0.25.2 → specfact_cli-0.26.0}/README.md

@@ -171,8 +171,11 @@ specfact validate sidecar run my-project /path/to/repo
 - **Role-based workflows** - Product Owners, Architects, Developers work in parallel
 - **Markdown-based** - No YAML editing required
 - **Agile/scrum ready** - DoR checklists, story points, dependencies
+- **Backlog standardization** 🆕 - Template-driven refinement with persona/framework filtering
+- **Sprint/iteration filtering** 🆕 - Filter by sprint, release, iteration for agile workflows
 
-👉 **[Agile/Scrum Workflows](docs/guides/agile-scrum-workflows.md)** - Team collaboration guide
+👉 **[Agile/Scrum Workflows](docs/guides/agile-scrum-workflows.md)** - Team collaboration guide  
+👉 **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 - Standardize backlog items with templates
 
 ### 🔌 Integrations
 
@@ -180,9 +183,11 @@ specfact validate sidecar run my-project /path/to/repo
 - **GitHub Actions** - Automated quality gates
 - **AI IDEs** - Generate prompts for fixing gaps
 - **DevOps tools** - Sync with GitHub Issues, Linear, Jira
+- **Backlog Refinement** 🆕 - AI-assisted template-driven refinement for standardizing work items
 - **Spec-Kit, OpenSpec, Specmatic** - Works with your existing tools
 
-👉 **[Integrations Overview](docs/guides/integrations-overview.md)** - All integration options
+👉 **[Integrations Overview](docs/guides/integrations-overview.md)** - All integration options  
+👉 **[Backlog Refinement Guide](docs/guides/backlog-refinement.md)** 🆕 **NEW** - Template-driven backlog standardization
 
 ---
 
@@ -248,6 +253,7 @@ specfact validate sidecar run my-project /path/to/repo
 - **[OpenSpec Journey](docs/guides/openspec-journey.md)** - OpenSpec integration
 - **[Specmatic Integration](docs/guides/specmatic-integration.md)** - API contract testing
 - **[DevOps Adapter Integration](docs/guides/devops-adapter-integration.md)** - GitHub Issues, Linear, Jira
+- **[Backlog Refinement](docs/guides/backlog-refinement.md)** 🆕 **NEW** - AI-assisted template-driven backlog standardization
 
 👉 **[Full Documentation Index](docs/README.md)** - Browse all documentation  
 👉 **[Online Documentation](https://docs.specfact.io/)** - Complete documentation site

{specfact_cli-0.25.2 → specfact_cli-0.26.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.25.2"
+version = "0.26.0"
 description = "Brownfield-first CLI: Reverse engineer legacy Python → specs → enforced contracts. Automate legacy code documentation and prevent modernization regressions."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -31,6 +31,8 @@ dependencies = [
     "python-dotenv>=1.2.1",
     "typing-extensions>=4.15.0",
     "PyYAML>=6.0.3",
+    "requests>=2.32.3",
+    "azure-identity>=1.17.1",
     
     # CLI framework
     "typer>=0.20.0",

{specfact_cli-0.25.2 → specfact_cli-0.26.0}/resources/prompts/specfact.06-sync.md

@@ -36,9 +36,24 @@ Synchronize artifacts from external tools (Spec-Kit, Linear, Jira) with SpecFact
 
 ### Advanced/Configuration
 
-- `--adapter TYPE` - Adapter type (speckit, generic-markdown). Default: auto-detect
+- `--adapter TYPE` - Adapter type (speckit, generic-markdown, openspec, github, ado). Default: auto-detect
 - `--interval SECONDS` - Watch interval in seconds. Default: 5 (range: 1+)
 
+**GitHub Adapter Options (for backlog sync):**
+
+- `--repo-owner OWNER` - GitHub repository owner (required for GitHub backlog sync)
+- `--repo-name NAME` - GitHub repository name (required for GitHub backlog sync)
+- `--github-token TOKEN` - GitHub API token (optional, uses GITHUB_TOKEN env var or gh CLI if not provided)
+- `--use-gh-cli/--no-gh-cli` - Use GitHub CLI (`gh auth token`) to get token automatically (default: True)
+
+**Azure DevOps Adapter Options (for backlog sync):**
+
+- `--ado-org ORG` - Azure DevOps organization (required for ADO backlog sync)
+- `--ado-project PROJECT` - Azure DevOps project (required for ADO backlog sync)
+- `--ado-base-url URL` - Azure DevOps base URL (optional, defaults to <https://dev.azure.com>). Use for Azure DevOps Server (on-prem)
+- `--ado-token TOKEN` - Azure DevOps PAT (optional, uses AZURE_DEVOPS_TOKEN env var if not provided)
+- `--ado-work-item-type TYPE` - Azure DevOps work item type (optional, derived from process template if not provided)
+
 ## Workflow
 
 ### Step 1: Parse Arguments
@@ -50,7 +65,15 @@ Synchronize artifacts from external tools (Spec-Kit, Linear, Jira) with SpecFact
 ### Step 2: Execute CLI
 
 ```bash
-specfact sync bridge --adapter <adapter> --repo <path> [--bidirectional] [--bundle <name>] [--overwrite] [--watch] [--interval <seconds>]
+# Spec-Kit adapter (default)
+specfact sync bridge --adapter speckit --repo <path> [--bidirectional] [--bundle <name>] [--overwrite] [--watch] [--interval <seconds>]
+
+# GitHub adapter (for backlog sync)
+specfact sync bridge --adapter github --repo <path> --repo-owner <owner> --repo-name <name> [--bidirectional] [--bundle <name>] [--github-token <token>] [--use-gh-cli]
+
+# Azure DevOps adapter (for backlog sync)
+specfact sync bridge --adapter ado --repo <path> --ado-org <org> --ado-project <project> [--bidirectional] [--bundle <name>] [--ado-token <token>] [--ado-base-url <url>]
+
 # --bundle defaults to active plan if not specified
 ```
 
@@ -143,16 +166,35 @@ Conflicts Resolved: 2
 
 ```text
 ✗ Unsupported adapter: invalid-adapter
-Supported adapters: speckit, generic-markdown
+Supported adapters: speckit, generic-markdown, openspec, github, ado
+```
+
+### Error (Missing Required Parameters)
+
+```text
+✗ GitHub adapter requires both --repo-owner and --repo-name options
+Example: specfact sync bridge --adapter github --repo-owner 'nold-ai' --repo-name 'specfact-cli' --bidirectional
+```
+
+```text
+✗ Azure DevOps adapter requires both --ado-org and --ado-project options
+Example: specfact sync bridge --adapter ado --ado-org 'my-org' --ado-project 'my-project' --bidirectional
 ```
 
 ## Common Patterns
 
 ```bash
+# Spec-Kit adapter
 /specfact.06-sync --adapter speckit --repo . --bidirectional
 /specfact.06-sync --adapter speckit --repo . --bundle legacy-api
 /specfact.06-sync --adapter speckit --repo . --watch --interval 5
 /specfact.06-sync --repo . --bidirectional  # Auto-detect adapter
+
+# GitHub adapter (backlog sync)
+/specfact.06-sync --adapter github --repo . --repo-owner nold-ai --repo-name specfact-cli --bidirectional
+
+# Azure DevOps adapter (backlog sync)
+/specfact.06-sync --adapter ado --repo . --ado-org my-org --ado-project my-project --bidirectional
 ```
 
 ## Context

specfact_cli-0.26.0/resources/prompts/specfact.backlog-refine.md

@@ -0,0 +1,239 @@
+---
+description: "Refine backlog items using template-driven AI assistance"
+---
+
+# SpecFact Backlog Refinement Command
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Refine backlog items from DevOps tools (GitHub Issues, Azure DevOps, etc.) into structured, template-compliant work items using AI-assisted refinement with template detection and validation.
+
+**When to use:** Standardizing backlog items, enforcing corporate templates (user stories, defects, spikes, enablers), preparing items for sprint planning.
+
+**Quick:** `/specfact.backlog-refine --adapter github --labels feature,enhancement` or `/specfact.backlog-refine --adapter ado --sprint "Sprint 1"`
+
+## Parameters
+
+### Required
+
+- `ADAPTER` - Backlog adapter name (github, ado, etc.)
+
+### Adapter Configuration (Required for GitHub/ADO)
+
+**GitHub Adapter:**
+
+- `--repo-owner OWNER` - GitHub repository owner (required for GitHub adapter)
+- `--repo-name NAME` - GitHub repository name (required for GitHub adapter)
+- `--github-token TOKEN` - GitHub API token (optional, uses GITHUB_TOKEN env var or gh CLI if not provided)
+
+**Azure DevOps Adapter:**
+
+- `--ado-org ORG` - Azure DevOps organization (required for ADO adapter)
+- `--ado-project PROJECT` - Azure DevOps project (required for ADO adapter)
+- `--ado-token TOKEN` - Azure DevOps PAT (optional, uses AZURE_DEVOPS_TOKEN env var if not provided)
+
+### Filters
+
+- `--labels LABELS` or `--tags TAGS` - Filter by labels/tags (comma-separated, e.g., "feature,enhancement")
+- `--state STATE` - Filter by state (open, closed, etc.)
+- `--assignee USERNAME` - Filter by assignee username
+- `--iteration PATH` - Filter by iteration path (ADO format: "Project\\Sprint 1")
+- `--sprint SPRINT` - Filter by sprint identifier
+- `--release RELEASE` - Filter by release identifier
+- `--persona PERSONA` - Filter templates by persona (product-owner, architect, developer)
+- `--framework FRAMEWORK` - Filter templates by framework (agile, scrum, safe, kanban)
+
+### Template Selection
+
+- `--template TEMPLATE_ID` or `-t TEMPLATE_ID` - Target template ID (default: auto-detect)
+- `--auto-accept-high-confidence` - Auto-accept refinements with confidence >= 0.85
+
+### Preview and Writeback
+
+- `--preview` / `--no-preview` - Preview mode: show what will be written without updating backlog (default: --preview)
+- `--write` - Write mode: explicitly opt-in to update remote backlog (requires --write flag)
+
+### Definition of Ready (DoR)
+
+- `--check-dor` - Check Definition of Ready (DoR) rules before refinement (loads from `.specfact/dor.yaml`)
+
+### OpenSpec Integration
+
+- `--bundle BUNDLE` or `-b BUNDLE` - OpenSpec bundle path to import refined items
+- `--auto-bundle` - Auto-import refined items to OpenSpec bundle
+- `--openspec-comment` - Add OpenSpec change proposal reference as comment (preserves original body)
+
+### Generic Search
+
+- `--search QUERY` or `-s QUERY` - Search query using provider-specific syntax (e.g., GitHub: "is:open label:feature")
+
+## Workflow
+
+### Step 1: Execute CLI Command
+
+Execute the SpecFact CLI command with user-provided arguments:
+
+```bash
+specfact backlog refine $ADAPTER \
+  [--labels LABELS] [--state STATE] [--assignee USERNAME] \
+  [--iteration PATH] [--sprint SPRINT] [--release RELEASE] \
+  [--persona PERSONA] [--framework FRAMEWORK] \
+  [--template TEMPLATE_ID] [--auto-accept-high-confidence] \
+  [--preview] [--write] \
+  [--bundle BUNDLE] [--auto-bundle] \
+  [--search QUERY]
+```
+
+**Capture CLI output**:
+
+- List of backlog items found
+- Template detection results for each item
+- Refinement prompts for IDE AI copilot
+- Validation results
+- Preview of what will be written (if --preview)
+- Writeback confirmation (if --write)
+
+### Step 2: Process Refinement Prompts (If Items Need Refinement)
+
+**When CLI generates refinement prompts**:
+
+1. **For each item needing refinement**:
+   - CLI displays a refinement prompt
+   - Copy the prompt and execute it in your IDE AI copilot
+   - Get refined content from AI copilot response
+   - Paste refined content back to CLI when prompted
+
+2. **CLI validation**:
+   - CLI validates refined content against template requirements
+   - CLI provides confidence score
+   - CLI shows preview of changes (original vs refined)
+
+3. **User confirmation**:
+   - Review preview (fields that will be updated vs preserved)
+   - Accept or reject refinement
+   - If accepted and --write flag set, CLI updates remote backlog
+
+### Step 3: Present Results
+
+Display refinement results:
+
+- Number of items refined
+- Number of items skipped
+- Template matches found
+- Confidence scores
+- Preview status (if --preview)
+- Writeback status (if --write)
+
+## CLI Enforcement
+
+**CRITICAL**: Always use SpecFact CLI commands. See [CLI Enforcement Rules](./shared/cli-enforcement.md) for details.
+
+**Rules**:
+
+- Execute CLI first - never modify backlog items directly
+- Use refinement prompts generated by CLI
+- Validate refined content through CLI
+- Use --preview flag by default for safety
+- Use --write flag only when ready to update backlog
+
+## Field Preservation Policy
+
+**Fields that will be UPDATED**:
+
+- `title`: Updated if changed during refinement
+- `body_markdown`: Updated with refined content
+
+**Fields that will be PRESERVED** (not modified):
+
+- `assignees`: Preserved
+- `tags`: Preserved
+- `state`: Preserved
+- `priority`: Preserved (if present in provider_fields)
+- `due_date`: Preserved (if present in provider_fields)
+- `story_points`: Preserved (if present in provider_fields)
+- `sprint`: Preserved (if present)
+- `release`: Preserved (if present)
+- All other metadata: Preserved in provider_fields
+
+**OpenSpec Comment Integration**:
+
+- When `--openspec-comment` is used, a structured comment is added to the backlog item
+- The comment includes: Change ID, template used, confidence score, refinement timestamp
+- Original body is preserved; comment provides OpenSpec reference for cross-sync
+
+## Architecture Note
+
+SpecFact CLI follows a CLI-first architecture:
+
+- SpecFact CLI generates prompts/instructions for IDE AI copilots
+- IDE AI copilots execute those instructions using their native LLM
+- IDE AI copilots feed results back to SpecFact CLI
+- SpecFact CLI validates and processes the results
+- SpecFact CLI does NOT directly invoke LLM APIs
+
+## Expected Output
+
+### Success (Preview Mode)
+
+```text
+✓ Refinement completed (Preview Mode)
+
+Found 5 backlog items
+Refined: 3
+Skipped: 2
+
+Preview mode: Refinement will NOT be written to backlog
+Use --write flag to explicitly opt-in to writeback
+```
+
+### Success (Write Mode)
+
+```text
+✓ Refinement completed and written to backlog
+
+Found 5 backlog items
+Refined: 3
+Skipped: 2
+
+Items updated in remote backlog:
+  - #123: User Story Template Applied
+  - #124: Defect Template Applied
+  - #125: Spike Template Applied
+```
+
+## Common Patterns
+
+```bash
+# Refine GitHub issues with feature label (requires repo-owner and repo-name)
+/specfact.backlog-refine --adapter github --repo-owner nold-ai --repo-name specfact-cli --labels feature
+
+# Refine ADO work items in specific sprint (requires ado-org and ado-project)
+/specfact.backlog-refine --adapter ado --ado-org my-org --ado-project my-project --sprint "Sprint 1"
+
+# Refine with Scrum framework and Product Owner persona
+/specfact.backlog-refine --adapter github --repo-owner nold-ai --repo-name specfact-cli --framework scrum --persona product-owner
+
+# Preview refinement without writing
+/specfact.backlog-refine --adapter github --repo-owner nold-ai --repo-name specfact-cli --preview
+
+# Write refinement to backlog with OpenSpec comment (explicit opt-in)
+/specfact.backlog-refine --adapter github --repo-owner nold-ai --repo-name specfact-cli --write --openspec-comment
+
+# Check Definition of Ready before refinement
+/specfact.backlog-refine --adapter github --repo-owner nold-ai --repo-name specfact-cli --check-dor --labels feature
+
+# Refine and import to OpenSpec bundle
+/specfact.backlog-refine --adapter github --repo-owner nold-ai --repo-name specfact-cli --bundle my-project --auto-bundle --state open
+```
+
+## Context
+
+{ARGS}

{specfact_cli-0.25.2 → specfact_cli-0.26.0}/resources/prompts/specfact.sync-backlog.md

@@ -65,11 +65,22 @@ Sync OpenSpec change proposals to DevOps backlog tools (GitHub Issues, ADO, Line
 ### Advanced/Configuration
 
 - `--adapter TYPE` - DevOps adapter type (github, ado, linear, jira). Default: github
-- `--repo-owner OWNER` - Repository owner (for GitHub/ADO). Optional, can use bridge config
-- `--repo-name NAME` - Repository name (for GitHub/ADO). Optional, can use bridge config
+
+**GitHub Adapter Options:**
+
+- `--repo-owner OWNER` - Repository owner (for GitHub adapter). Optional, can use bridge config
+- `--repo-name NAME` - Repository name (for GitHub adapter). Optional, can use bridge config
 - `--github-token TOKEN` - GitHub API token (optional, uses GITHUB_TOKEN env var or gh CLI if not provided)
 - `--use-gh-cli/--no-gh-cli` - Use GitHub CLI (`gh auth token`) to get token automatically (default: True). Useful in enterprise environments where PAT creation is restricted
 
+**Azure DevOps Adapter Options:**
+
+- `--ado-org ORG` - Azure DevOps organization (required for ADO adapter)
+- `--ado-project PROJECT` - Azure DevOps project (required for ADO adapter)
+- `--ado-base-url URL` - Azure DevOps base URL (optional, defaults to <https://dev.azure.com>). Use for Azure DevOps Server (on-prem)
+- `--ado-token TOKEN` - Azure DevOps PAT (optional, uses AZURE_DEVOPS_TOKEN env var if not provided). Requires Work Items (Read & Write) permissions
+- `--ado-work-item-type TYPE` - Azure DevOps work item type (optional, derived from process template if not provided). Examples: 'User Story', 'Product Backlog Item', 'Bug'
+
 ## Workflow
 
 ### Step 1: Parse Arguments
@@ -114,24 +125,41 @@ Sync OpenSpec change proposals to DevOps backlog tools (GitHub Issues, ADO, Line
 **For non-sanitized proposals** (direct export):
 
 ```bash
+# GitHub adapter
 specfact sync bridge --adapter github --mode export-only --repo <openspec-path> \
   --no-sanitize --change-ids <id1,id2> \
   [--code-repo <source-code-path>] \
   [--track-code-changes] [--add-progress-comment] \
   [--target-repo <owner/repo>] [--repo-owner <owner>] [--repo-name <name>] \
   [--github-token <token>] [--use-gh-cli]
+
+# Azure DevOps adapter
+specfact sync bridge --adapter ado --mode export-only --repo <openspec-path> \
+  --no-sanitize --change-ids <id1,id2> \
+  [--code-repo <source-code-path>] \
+  [--track-code-changes] [--add-progress-comment] \
+  --ado-org <org> --ado-project <project> \
+  [--ado-token <token>] [--ado-base-url <url>] [--ado-work-item-type <type>]
 ```
 
 **For sanitized proposals** (requires LLM review):
 
 ```bash
-# Step 3a: Export to temporary file for LLM review
+# Step 3a: Export to temporary file for LLM review (GitHub)
 specfact sync bridge --adapter github --mode export-only --repo <openspec-path> \
   --sanitize --change-ids <id1,id2> \
   [--code-repo <source-code-path>] \
   --export-to-tmp --tmp-file /tmp/specfact-proposal-<change-id>.md \
   [--target-repo <owner/repo>] [--repo-owner <owner>] [--repo-name <name>] \
   [--github-token <token>] [--use-gh-cli]
+
+# Step 3a: Export to temporary file for LLM review (ADO)
+specfact sync bridge --adapter ado --mode export-only --repo <openspec-path> \
+  --sanitize --change-ids <id1,id2> \
+  [--code-repo <source-code-path>] \
+  --export-to-tmp --tmp-file /tmp/specfact-proposal-<change-id>.md \
+  --ado-org <org> --ado-project <project> \
+  [--ado-token <token>] [--ado-base-url <url>]
 ```
 
 **Note**: When `--code-repo` is provided, code change detection uses that repository. Otherwise, code changes are detected in the OpenSpec repository (`--repo`).
@@ -173,12 +201,19 @@ specfact sync bridge --adapter github --mode export-only --repo <openspec-path>
 **For sanitized proposals** (after LLM review):
 
 ```bash
-# Step 5a: Import sanitized content from temporary file
+# Step 5a: Import sanitized content from temporary file (GitHub)
 specfact sync bridge --adapter github --mode export-only --repo <path> \
   --import-from-tmp --tmp-file /tmp/specfact-proposal-<change-id>-sanitized.md \
   --change-ids <id1,id2> \
   [--target-repo <owner/repo>] [--repo-owner <owner>] [--repo-name <name>] \
   [--github-token <token>] [--use-gh-cli]
+
+# Step 5a: Import sanitized content from temporary file (ADO)
+specfact sync bridge --adapter ado --mode export-only --repo <path> \
+  --import-from-tmp --tmp-file /tmp/specfact-proposal-<change-id>-sanitized.md \
+  --change-ids <id1,id2> \
+  --ado-org <org> --ado-project <project> \
+  [--ado-token <token>] [--ado-base-url <url>]
 ```
 
 **For non-sanitized proposals** (already exported in Step 3):
@@ -244,11 +279,17 @@ When in copilot mode, follow this workflow:
 **What to do**:
 
 ```bash
-# For each sanitized proposal, export to temp file
+# For each sanitized proposal, export to temp file (GitHub)
 specfact sync bridge --adapter github --mode export-only --repo <openspec-path> \
   --change-ids <change-id> --export-to-tmp --tmp-file /tmp/specfact-proposal-<change-id>.md \
   [--code-repo <source-code-path>] \
-  [other options]
+  [--repo-owner <owner>] [--repo-name <name>] [--github-token <token>] [--use-gh-cli]
+
+# For each sanitized proposal, export to temp file (ADO)
+specfact sync bridge --adapter ado --mode export-only --repo <openspec-path> \
+  --change-ids <change-id> --export-to-tmp --tmp-file /tmp/specfact-proposal-<change-id>.md \
+  [--code-repo <source-code-path>] \
+  --ado-org <org> --ado-project <project> [--ado-token <token>] [--ado-base-url <url>]
 ```
 
 **Capture**:
@@ -315,12 +356,19 @@ specfact sync bridge --adapter github --mode export-only --repo <openspec-path>
 **What to do**:
 
 ```bash
-# Export non-sanitized proposals directly
+# Export non-sanitized proposals directly (GitHub)
 specfact sync bridge --adapter github --mode export-only --repo <openspec-path> \
   --change-ids <id1,id2> --no-sanitize \
   [--code-repo <source-code-path>] \
   [--track-code-changes] [--add-progress-comment] \
-  [other options]
+  [--repo-owner <owner>] [--repo-name <name>] [--github-token <token>] [--use-gh-cli]
+
+# Export non-sanitized proposals directly (ADO)
+specfact sync bridge --adapter ado --mode export-only --repo <openspec-path> \
+  --change-ids <id1,id2> --no-sanitize \
+  [--code-repo <source-code-path>] \
+  [--track-code-changes] [--add-progress-comment] \
+  --ado-org <org> --ado-project <project> [--ado-token <token>] [--ado-base-url <url>]
 ```
 
 **Result**: Issues created directly without LLM review
@@ -334,12 +382,19 @@ specfact sync bridge --adapter github --mode export-only --repo <openspec-path>
 **What to do**:
 
 ```bash
-# For each approved sanitized proposal, import from temp file and create issue
+# For each approved sanitized proposal, import from temp file and create issue (GitHub)
 specfact sync bridge --adapter github --mode export-only --repo <openspec-path> \
   --change-ids <change-id> --import-from-tmp --tmp-file /tmp/specfact-proposal-<change-id>-sanitized.md \
   [--code-repo <source-code-path>] \
   [--track-code-changes] [--add-progress-comment] \
-  [other options]
+  [--repo-owner <owner>] [--repo-name <name>] [--github-token <token>] [--use-gh-cli]
+
+# For each approved sanitized proposal, import from temp file and create work item (ADO)
+specfact sync bridge --adapter ado --mode export-only --repo <openspec-path> \
+  --change-ids <change-id> --import-from-tmp --tmp-file /tmp/specfact-proposal-<change-id>-sanitized.md \
+  [--code-repo <source-code-path>] \
+  [--track-code-changes] [--add-progress-comment] \
+  --ado-org <org> --ado-project <project> [--ado-token <token>] [--ado-base-url <url>]
 ```
 
 **Result**: Issues created with sanitized content
@@ -461,9 +516,12 @@ Competitive analysis and internal strategy sections removed
 # Auto-detect sanitization (filters based on repo setup)
 /specfact.sync-backlog --adapter github
 
-# Explicit repository configuration
+# Explicit repository configuration (GitHub)
 /specfact.sync-backlog --adapter github --repo-owner nold-ai --repo-name specfact-cli-internal
 
+# Azure DevOps adapter (requires org and project)
+/specfact.sync-backlog --adapter ado --ado-org my-org --ado-project my-project
+
 # Use GitHub CLI for token (enterprise-friendly)
 /specfact.sync-backlog --adapter github --use-gh-cli
 ```

specfact_cli-0.26.0/resources/templates/backlog/defaults/defect_v1.yaml

@@ -0,0 +1,22 @@
+template_id: defect_v1
+name: Defect
+description: Standard defect/bug template with reproduction steps and expected behavior
+scope: corporate
+required_sections:
+  - Description
+  - Steps to Reproduce
+  - Expected Behavior
+  - Actual Behavior
+optional_sections:
+  - Environment
+  - Screenshots
+  - Related Issues
+body_patterns:
+  steps_to_reproduce: "[Ss]teps? to [Rr]eproduce"
+  expected_behavior: "[Ee]xpected [Bb]ehavior"
+  actual_behavior: "[Aa]ctual [Bb]ehavior"
+title_patterns:
+  - "^.*[Bb]ug.*$"
+  - "^.*[Dd]efect.*$"
+  - "^.*[Ii]ssue.*$"
+schema_ref: openspec/templates/defect_v1/

specfact_cli-0.26.0/resources/templates/backlog/defaults/enabler_v1.yaml

@@ -0,0 +1,21 @@
+template_id: enabler_v1
+name: Enabler
+description: Enabler work template for infrastructure and technical improvements
+scope: corporate
+required_sections:
+  - Objective
+  - Technical Approach
+  - Success Criteria
+optional_sections:
+  - Dependencies
+  - Risks
+  - Timeline
+body_patterns:
+  objective: "[Oo]bjective"
+  technical_approach: "[Tt]echnical [Aa]pproach"
+  success_criteria: "[Ss]uccess [Cc]riteria"
+title_patterns:
+  - "^.*[Ee]nabler.*$"
+  - "^.*[Ii]nfrastructure.*$"
+  - "^.*[Tt]echnical [Dd]ebt.*$"
+schema_ref: openspec/templates/enabler_v1/

specfact_cli-0.26.0/resources/templates/backlog/defaults/spike_v1.yaml

@@ -0,0 +1,20 @@
+template_id: spike_v1
+name: Spike
+description: Research spike template for investigating technical feasibility
+scope: corporate
+required_sections:
+  - Research Question
+  - Investigation Approach
+  - Findings
+optional_sections:
+  - Recommendations
+  - Time Box
+  - Related Work
+body_patterns:
+  research_question: "[Rr]esearch [Qq]uestion"
+  investigation_approach: "[Ii]nvestigation [Aa]pproach"
+  findings: "[Ff]indings"
+title_patterns:
+  - "^.*[Ss]pike.*$"
+  - "^.*[Rr]esearch.*$"
+schema_ref: openspec/templates/spike_v1/