Skip to content
This project is under active development and subject to breaking changes. See the changelog for release notes.

Changelog

  • Renamed Compliance Criteria / Compliance Cases to Conformance Criteria / Conformance Cases in the feature spec template (consumers must run sdd-init.sh update-all to pick it up; existing specs keep the old heading until owners rename it)
  • Replaced ✅ / ❌ / ⚠️ symbols in the ADR template evaluation table with meets / partially meets / fails text values
  • Added template provenance and a manifest.lock to sdd-init.sh: each managed file carries a one-line provenance header and .github/devsquad/manifest.lock records plugin_version, template_sha, and written_at per file
  • Added update-all --dry-run to preview changes without writing, and timestamped .pre-<version>-<unix>.bak backups before overwriting
  • Added version-parity.yml workflow that fails a PR if the two plugin.json files and marketplace.json disagree on the plugin version
  • Added two CHANGELOG categories (Breaking / Migration Required, Template changes (consumer action required)) so compatibility impact is explicit per release
  • Fixed work item state transitions skipped during implement: work-item-workflow Phase 1 (assignee + Active) is now a precondition, names the exact MCP calls (github/issue_write with assignees, ado/wit_update_work_item with System.AssignedTo), and stops on assignment failure; devsquad.implement.finalize enforces an explicit state machine (Active on start, Resolved on PR open, Closed on merge)
  • Fixed harness learnings rarely captured automatically: implement.execute, implement.verify, review.code, and implement.finalize now have a Learning Capture Checkpoint with concrete numeric triggers (2+ correction attempts, REGRESSION/COVERAGE_GAP verdicts, Major/Critical findings, contradicted human PR feedback) and a [Y]/[N]/[E] prompt with [Y] as default
  • Fixed PR bodies silently failing to auto-close issues: pull-request skill now lists the recognized closing keywords (close/closes/closed/fix/fixes/fixed/resolve/resolves/resolved), distinguishes resolved (Closes) from referenced (Refs), covers the spike PR case, and adds a pre-flight check that verifies a closing keyword exists for every resolved work item before creating the PR
  • Fixed version drift: marketplace.json was at 0.11.0 while both plugin.json files were at 0.11.1; bumped to match
  • Fixed accidental pushes to integration branch: added integration branch guard to git-commit skill (checks before committing), pull-request skill (guards all push paths including PR creation), and copilot-instructions.md (framework-level rule). The agent now asks the user whether to create a feature branch when on main, master, or develop.
  • Added skills: test-discipline, deep-clarification, domain-glossary, triage-workflow
  • Added devsquad.triage agent for issue intake and bug reproduction
  • Added LSP server detection hook with .memory/lsp-status.md seeding
  • Added pattern anchoring, context budget awareness, and spec conformance check to implement agents
  • Added prompt injection guard in debugging-recovery
  • Added documentation style rules to copilot-instructions.md for universal coverage
  • Added platform-aware PR creation (GitHub vs Azure DevOps) in pull-request skill
  • Wired ADO repo MCP tools into implement, finalize, review, and refine agents
  • Added conductor routing for artifact management (branch/push/PR without delegating to implement)
  • Made failure capture mandatory in debugging-recovery (previously conditional)
  • Fixed stale tool references: memory renamed to vscode/memory, removed execute/testFailure
  • Added harness-learnings skill: agents capture codebase-specific patterns (correction loops, test prerequisites, review findings) in .memory/harness-learnings.md with confidence scoring and two-tier maturation (local capture, then promotion to permanent controls). See ADR-0013
  • Added hook output contract for postToolUse validation hooks: structured JSON with decision, reason, instructions, files, severity fields for agent self-correction
  • Updated lint-markdown.sh and validate-work-item-tags.sh to emit structured JSON with actionable fix instructions
  • Wired harness-learnings consult/capture into implement.execute, implement.verify, review.code, refine.health, implement.finalize, and debugging-recovery
  • Added spec amendment during implementation: implement agent flags spec/ADR drift and proposes a scoped amendment; developer confirms, rejects, or defers. See the concept doc
  • devsquad.refine is now invocable mid-implementation via the [AMEND] prompt prefix for scoped spec/ADR edits
  • Renamed Usage Scenarios tab Feature-first to Scope-stable; iterative scenario is now the first tab (breaking for anyone automating against tab labels)
  • Updated spec authoring guidance: specs describe the smallest vertical slice that delivers user-visible value and are treated as living artifacts that can be amended mid-flight; affects what devsquad.specify produces
  • Known limitations (v1): whole-feature task regeneration after amendment, design artifacts (plan.md, data-model.md, contracts/) flagged but not auto-updated on high-impact amendments, no multi-developer concurrency guard, no strict mode for regulated contexts
  • Fixed MCP config format: renamed servers to mcpServers in plugin .mcp.json after Copilot CLI dropped .vscode/mcp.json support
  • Updated CLI install docs with the new two-step marketplace install flow and deprecated the direct install method
  • Added debugging-recovery skill with stop-the-line rule, 6-step triage checklist, error-specific decision trees, and untrusted error output safety principle
  • Added anti-rationalization tables (“Common Rationalizations”) to 6 skills: security-review, quality-gate, git-commit, adr-workflow, pull-request, engineering-practices
  • Added Red Flags sections to security-review, quality-gate, and git-commit for self-monitoring
  • Added source verification protocol to implement.execute for non-Microsoft stacks with UNVERIFIED: labels
  • Added scope discipline output format to implement.execute (“Changes made”, “Not touched”, “Potential concerns”)
  • Enhanced Prove-It bug fix flow with correct-reason failure verification and full suite regression check
  • Added save-point protocol: commit after each passing task group, revert on failure
  • Standardized 4-tier review severity labels (Critical/Major/Minor/Suggestion) across review agents
  • Added Chesterton’s Fence rule to devsquad.review.code
  • Replaced local Azure DevOps MCP server (npx @azure-devops/mcp@next) with the remote HTTP server (https://mcp.dev.azure.com/)
  • Authentication now uses Microsoft Entra ID (OAuth); PAT-based auth removed
  • Toolsets (wit, work, search, repos) declared via X-MCP-Toolsets header
  • Removed ado_org prompt input; no local Node.js or npx required
  • Removed duplicated docs/framework/ content fully covered by the docs-site; only ADRs and images are kept
  • Consolidated README into a concise landing page that links to the docs-site for details
  • Updated stale docs/framework/ references in agents, plugin README, CONTRIBUTING, and sync script to point to docs-site URLs
  • Added active development banner to all docs-site pages
  • Added nested sub-agent architecture support around coordinator and worker patterns for devsquad.plan, devsquad.implement, devsquad.review, and devsquad.refine
  • Added 14 worker agent files with user-invocable: false and minimal tool sets
  • Added ADR 0012 and marked ADR 0011 as superseded
  • Updated public prerequisites to require VS Code 1.113.0+ and chat.subagents.allowInvocationsFromSubagents for nested workflows
  • Updated architecture diagrams to show coordinator nodes, worker topology, and parallel execution
  • Replaced ~45K embedded template content with a deterministic shell script for file operations
  • Reduced agent file sizes significantly
  • Converted worker sub-agents to skills to comply with GitHub Copilot’s one-level sub-agent nesting limit (ADR 0011)
  • Affected: security-review, init-config, init-docs, init-scaffold
  • Standalone agent files preserved for direct invocation
  • Added migration specification support for infrastructure migrations
  • Migration types: lift-and-shift, rehost, replatform
  • devsquad.specify now handles both feature and migration specs
  • New instructions: migration-specs.instructions.md, migration-tasks.instructions.md
  • Introduced Tool Extensions (preview) for injecting MCP server tools into plugin agents via YAML patches
  • ADR 0010 documents the overlay generation approach
  • sessionStart hook detects unsynced extensions
  • Added diagram-design skill for architecture diagram guidance
  • Split monolithic architecture diagram into focused diagrams
  • Mermaid and Draw.io tool selection guidance
  • Renamed all sdd.* agents to devsquad.*
  • Restructured as self-contained plugin for VS Code
  • Plugin marketplace registration
  • Initial release
  • 16 agents, 13 skills, 5 MCP servers, 7 templates (restructured to 13 user-visible agents + internal workers in subsequent releases)
  • Core framework: Conductor pattern, Socratic AI, Spec-Driven Development
  • GitHub Issues and Azure DevOps integration
  • Lifecycle hooks for auto-detection