Track `/speckit.converge` outputs in Copilot integration manifest by Copilot · Pull Request #3003 · github/spec-kit

Copilot · 2026-06-16T15:12:09Z

The review comment flagged that the Copilot integration manifest did not include the new converge command artifacts, so /speckit.converge would not be tracked as an installed managed command. This updates the manifest to include the missing converge agent/prompt entries.

Manifest alignment for Copilot-managed files
- Updated .specify/integrations/copilot.manifest.json to include:
  - .github/agents/speckit.converge.agent.md
  - .github/prompts/speckit.converge.prompt.md
- Added the corresponding content hashes so converge is managed consistently with existing core commands.
Scope
- No code-path changes; this is limited to manifest metadata for integration state tracking.

{
  "files": {
    ".github/agents/speckit.converge.agent.md": "c4737bbfcfc51420f438d8d3ae62b0d00997a0cac31f5402d93c69141bd48a80",
    ".github/prompts/speckit.converge.prompt.md": "8e37fe6d8b6ce130fcc011b995edd3e412d825c0f46abd1a7706451f2049d571"
  }
}

Dogfood the converge feature through Spec Kit's own workflow: - spec.md, plan.md, tasks.md, research, data-model, contracts, quickstart - requirements checklist for the feature - ratified constitution v1.0.0 (.specify/memory) - Specify project scaffolding (.specify/, .github agent + prompt files) Defines a built-in /speckit.converge command that assesses spec/plan/tasks against the codebase and appends remaining work as new tasks (no git, no change tracking, append-only). Implementation not yet started. Excludes unrelated working-tree changes to agents.py, extensions.py, test_extensions.py, catalog.community.json, and README.md.

Add the built-in converge command that assesses the codebase against a feature's spec.md, plan.md, and tasks.md and appends remaining unbuilt work as new traceable tasks to tasks.md (append-only; no git, no change tracking). - templates/commands/converge.md: full command body (load artifacts, assess code, classify findings missing/partial/contradicts/unrequested, append '## Phase N — Convergence' tasks with source-ref + gap-type, read-only guardrails, converged branch, handoff, before/after_converge hooks) - Register converge as a core command across all enumeration sites (SKILL_DESCRIPTIONS, _FALLBACK_CORE_COMMAND_NAMES, ARGUMENT_HINTS, and the integration test command lists incl. copilot/generic file inventories) - init.py Next Steps panel + README Core Commands table - tasks.md: T001-T024 complete (T025 manual quickstart pending) Full suite green: 2343 passed.

All six quickstart scenarios validated (GitHub Copilot agent, macOS/zsh): S1 gap->appended traceable task, S2 implement+re-converge, S3 converged leaves tasks.md unchanged, S4 read-only boundaries, S5 missing-prereq stop, S6 cross- integration install (copilot + windsurf). Automated suite: 2343 passed.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

This PR updates Spec Kit’s core command set to include a new /speckit.converge command across templates, integrations, docs, and tests, and attempts to align Copilot integration state tracking (manifest) with the new command artifacts.

Changes:

Added the converge command template and registered converge across command enumerations, onboarding guidance, README, and integration tests.
Added a full feature spec/plan/research/contracts/quickstart set for the converge command under specs/001-converge-command/.
Updated Spec Kit “project state”/bundled workflow + extension artifacts under .specify/, including Copilot integration manifest tracking updates.

Show a summary per file

File	Description
tests/integrations/test_integration_generic.py	Adds `converge` to expected command inventories.
tests/integrations/test_integration_copilot.py	Updates Copilot integration expectations to include `converge`.
tests/integrations/test_integration_base_yaml.py	Adds `converge` to YAML integration expected command stems.
tests/integrations/test_integration_base_toml.py	Adds `converge` to TOML integration expected command stems.
tests/integrations/test_integration_base_skills.py	Adds `converge` to skills integration expected command sets.
tests/integrations/test_integration_base_markdown.py	Adds `converge` to Markdown integration expected command stems.
templates/commands/converge.md	Introduces the new converge command template.
src/specify_cli/integrations/claude/init.py	Adds a Claude argument hint entry for `converge`.
src/specify_cli/extensions.py	Adds `converge` to fallback core command name list.
src/specify_cli/commands/init.py	Adds `converge` to post-init “Next Steps” output.
src/specify_cli/init.py	Adds `converge` to skill/command description registry.
specs/001-converge-command/spec.md	New feature specification for `/speckit.converge`.
specs/001-converge-command/research.md	New research decisions for converge design.
specs/001-converge-command/quickstart.md	New manual validation guide for converge.
specs/001-converge-command/plan.md	New implementation plan for converge rollout.
specs/001-converge-command/data-model.md	New conceptual data model for converge findings/tasks.
specs/001-converge-command/contracts/tasks-output.md	New contract for append-only `tasks.md` output format.
specs/001-converge-command/contracts/hooks.md	New contract for converge lifecycle hooks.
specs/001-converge-command/contracts/command-interface.md	New contract for converge invocation and behavior.
specs/001-converge-command/checklists/requirements.md	New spec quality checklist for converge.
README.md	Adds `/speckit.converge` to the core commands table.
.specify/workflows/workflow-registry.json	Adds/records bundled workflow registry state.
.specify/workflows/speckit/workflow.yml	Adds/records bundled “Full SDD Cycle” workflow definition.
.specify/templates/tasks-template.md	Adds/records tasks template content in `.specify/templates/`.
.specify/templates/spec-template.md	Adds/records spec template content in `.specify/templates/`.
.specify/templates/plan-template.md	Adds/records plan template content in `.specify/templates/`.
.specify/templates/constitution-template.md	Adds/records constitution template content in `.specify/templates/`.
.specify/templates/checklist-template.md	Adds/records checklist template content in `.specify/templates/`.
.specify/scripts/bash/setup-tasks.sh	Adds/records tasks setup helper script.
.specify/scripts/bash/setup-plan.sh	Adds/records plan setup helper script.
.specify/scripts/bash/create-new-feature.sh	Adds/records feature creation script.
.specify/scripts/bash/check-prerequisites.sh	Adds/records prerequisite/path discovery script.
.specify/memory/constitution.md	Adds/records a ratified Spec Kit constitution.
.specify/integrations/speckit.manifest.json	Adds/records manifest of managed `speckit` integration files.
.specify/integrations/copilot.manifest.json	Updates Copilot integration manifest to include converge artifacts.
.specify/integration.json	Adds/records integration state (copilot) for this workspace.
.specify/init-options.json	Adds/records init options state for this workspace.
.specify/feature.json	Adds/records active feature directory state.
.specify/extensions/bug/README.md	Adds bundled “bug triage workflow” extension docs.
.specify/extensions/bug/extension.yml	Adds bundled “bug triage workflow” extension manifest.
.specify/extensions/bug/commands/speckit.bug.test.md	Adds bug extension command template (test).
.specify/extensions/bug/commands/speckit.bug.fix.md	Adds bug extension command template (fix).
.specify/extensions/bug/commands/speckit.bug.assess.md	Adds bug extension command template (assess).
.specify/extensions/agent-context/scripts/powershell/update-agent-context.ps1	Adds/updates PowerShell context updater script.
.specify/extensions/agent-context/scripts/bash/update-agent-context.sh	Adds/updates Bash context updater script.
.specify/extensions/agent-context/README.md	Adds bundled agent-context extension docs.
.specify/extensions/agent-context/extension.yml	Adds bundled agent-context extension manifest.
.specify/extensions/agent-context/commands/speckit.agent-context.update.md	Adds agent-context extension command template.
.specify/extensions/agent-context/agent-context-config.yml	Adds agent-context extension configuration.
.specify/extensions/.registry	Adds/records extension registry state.
.specify/extensions.yml	Adds/records enabled extensions + hook configuration.
.specify/bugs/integration-key-cli-check/test.md	Adds/records bug workflow output artifact (test report).
.specify/bugs/integration-key-cli-check/fix.md	Adds/records bug workflow output artifact (fix report).
.specify/bugs/integration-key-cli-check/assessment.md	Adds/records bug workflow output artifact (assessment report).
.github/prompts/speckit.taskstoissues.prompt.md	Copilot prompt stub for taskstoissues agent.
.github/prompts/speckit.tasks.prompt.md	Copilot prompt stub for tasks agent.
.github/prompts/speckit.specify.prompt.md	Copilot prompt stub for specify agent.
.github/prompts/speckit.plan.prompt.md	Copilot prompt stub for plan agent.
.github/prompts/speckit.implement.prompt.md	Copilot prompt stub for implement agent.
.github/prompts/speckit.constitution.prompt.md	Copilot prompt stub for constitution agent.
.github/prompts/speckit.clarify.prompt.md	Copilot prompt stub for clarify agent.
.github/prompts/speckit.checklist.prompt.md	Copilot prompt stub for checklist agent.
.github/prompts/speckit.bug.test.prompt.md	Copilot prompt stub for bug.test agent.
.github/prompts/speckit.bug.fix.prompt.md	Copilot prompt stub for bug.fix agent.
.github/prompts/speckit.bug.assess.prompt.md	Copilot prompt stub for bug.assess agent.
.github/prompts/speckit.analyze.prompt.md	Copilot prompt stub for analyze agent.
.github/prompts/speckit.agent-context.update.prompt.md	Copilot prompt stub for agent-context.update agent.
.github/copilot-instructions.md	Adds/updates managed Spec Kit context block for Copilot.
.github/agents/speckit.taskstoissues.agent.md	Copilot agent command content for taskstoissues.
.github/agents/speckit.tasks.agent.md	Copilot agent command content for tasks.
.github/agents/speckit.plan.agent.md	Copilot agent command content for plan.
.github/agents/speckit.implement.agent.md	Copilot agent command content for implement.
.github/agents/speckit.constitution.agent.md	Copilot agent command content for constitution.
.github/agents/speckit.bug.test.agent.md	Copilot agent command content for bug.test.
.github/agents/speckit.bug.fix.agent.md	Copilot agent command content for bug.fix.
.github/agents/speckit.bug.assess.agent.md	Copilot agent command content for bug.assess.
.github/agents/speckit.analyze.agent.md	Copilot agent command content for analyze.
.github/agents/speckit.agent-context.update.agent.md	Copilot agent command content for agent-context.update.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Files reviewed: 83/83 changed files
Comments generated: 5

+    ".github/agents/speckit.tasks.agent.md": "6998de540ae9564c729062ca0a3d493c3902e4647514e4d1011e6680c4c9f0c9",
+    ".github/agents/speckit.taskstoissues.agent.md": "6fb1d3f1b6668282d41f45127faa427a93d8fdd88215d1c2c5c8ee3185037e7e",
+    ".github/agents/speckit.converge.agent.md": "c4737bbfcfc51420f438d8d3ae62b0d00997a0cac31f5402d93c69141bd48a80",
+    ".github/prompts/speckit.analyze.prompt.md": "bb93dbbafa96d07b7cd07fc7061d8adb0c6b26cb772a52d0dce263b1ca2b9b77",


+    ".github/prompts/speckit.specify.prompt.md": "7b2cc4dc6462da1c96df46bac4f60e53baba3097f4b24ac3f9b684194458aa98",
+    ".github/prompts/speckit.tasks.prompt.md": "88fc57c289f99d5e9d35c255f3e2683f73ecb0a5155dcb4d886f82f52b11841f",
+    ".github/prompts/speckit.taskstoissues.prompt.md": "2f9636d4f312a1470f000747cb62677fec0655d8b4e2357fa4fbf238965fa66d",
+    ".github/prompts/speckit.converge.prompt.md": "8e37fe6d8b6ce130fcc011b995edd3e412d825c0f46abd1a7706451f2049d571",
+    ".vscode/settings.json": "c6782d67fc76b9128803b03247ddd015d542a574ee80a4fe0aca2429aa7bfe08"


+- **Rationale**: This is the same mechanism `analyze` and `implement` use. It already
+  resolves the feature directory via `SPECIFY_FEATURE_DIRECTORY` → `.specify/feature.json`
+  → branch-prefix fallback, so it works with or without git (Constitution Principle II).
+  No new script is introduced, preserving cross-platform parity by construction.


 | `/speckit.tasks`         | `speckit-tasks`        | Generate actionable task lists for implementation                          |
 | `/speckit.taskstoissues` | `speckit-taskstoissues`| Convert generated task lists into GitHub issues for tracking and execution |
 | `/speckit.implement`     | `speckit-implement`    | Execute all tasks to build the feature according to the plan               |
+| `/speckit.converge`      | `speckit-converge`     | Assess the codebase against spec/plan/tasks and append remaining work as new tasks |


Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Copilot's findings

Files reviewed: 85/85 changed files
Comments generated: 3

+    ".github/agents/speckit.specify.agent.md": "2d638f512263cc658e85bc05c78897d77f4f48e92c752b2465853da1fd5bfb8c",
+    ".github/agents/speckit.tasks.agent.md": "6998de540ae9564c729062ca0a3d493c3902e4647514e4d1011e6680c4c9f0c9",
+    ".github/agents/speckit.taskstoissues.agent.md": "6fb1d3f1b6668282d41f45127faa427a93d8fdd88215d1c2c5c8ee3185037e7e",
+    ".github/agents/speckit.converge.agent.md": "c4737bbfcfc51420f438d8d3ae62b0d00997a0cac31f5402d93c69141bd48a80",


+    ".github/prompts/speckit.specify.prompt.md": "7b2cc4dc6462da1c96df46bac4f60e53baba3097f4b24ac3f9b684194458aa98",
+    ".github/prompts/speckit.tasks.prompt.md": "88fc57c289f99d5e9d35c255f3e2683f73ecb0a5155dcb4d886f82f52b11841f",
+    ".github/prompts/speckit.taskstoissues.prompt.md": "2f9636d4f312a1470f000747cb62677fec0655d8b4e2357fa4fbf238965fa66d",
+    ".github/prompts/speckit.converge.prompt.md": "8e37fe6d8b6ce130fcc011b995edd3e412d825c0f46abd1a7706451f2049d571",


 | `/speckit.tasks`         | `speckit-tasks`        | Generate actionable task lists for implementation                          |
 | `/speckit.taskstoissues` | `speckit-taskstoissues`| Convert generated task lists into GitHub issues for tracking and execution |
 | `/speckit.implement`     | `speckit-implement`    | Execute all tasks to build the feature according to the plan               |
+| `/speckit.converge`      | `speckit-converge`     | Assess the codebase against spec/plan/tasks and append remaining work as new tasks |


BenBtg and others added 6 commits June 16, 2026 14:50

Record 2026-06-16 re-verification results for /speckit.converge (T025)

06a2846

Potential fix for pull request finding

eb81505

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Initial plan

ba77318

Copilot AI self-assigned this Jun 16, 2026

Copilot AI review requested due to automatic review settings June 16, 2026 15:12

Copilot AI assigned BenBtg Jun 16, 2026

Copilot AI removed the request for review from Copilot June 16, 2026 15:12

Copilot started work on behalf of BenBtg June 16, 2026 15:12 View session

Copilot AI added 2 commits June 16, 2026 15:25

fix: track converge outputs in copilot manifest

e513011

Merge commit 'ba77318' into fix-pr3001-manifest

f9449f4

Copilot AI requested review from Copilot and removed request for Copilot June 16, 2026 15:26

Copilot AI changed the title ~~[WIP] Fix code as per review comment~~ Track /speckit.converge outputs in Copilot integration manifest Jun 16, 2026

Copilot finished work on behalf of BenBtg June 16, 2026 15:27

Copilot AI requested a review from BenBtg June 16, 2026 15:27

BenBtg requested a review from Copilot June 16, 2026 15:27

Copilot started reviewing on behalf of BenBtg June 16, 2026 15:28 View session

BenBtg marked this pull request as ready for review June 16, 2026 15:28

BenBtg requested a review from mnriem as a code owner June 16, 2026 15:28

Copilot AI reviewed Jun 16, 2026

View reviewed changes

Potential fix for pull request finding

23edbee

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings June 16, 2026 15:35

Copilot started reviewing on behalf of BenBtg June 16, 2026 15:36 View session

Copilot started work on behalf of BenBtg June 16, 2026 15:36 View session

fix: add missing Copilot converge artifacts

11ba515

Copilot finished work on behalf of BenBtg June 16, 2026 15:40

Copilot AI reviewed Jun 16, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Track `/speckit.converge` outputs in Copilot integration manifest#3003

Track `/speckit.converge` outputs in Copilot integration manifest#3003
Copilot wants to merge 10 commits into
mainfrom
copilot/fix-code-review-comment-again

Copilot AI commented Jun 16, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Copilot AI commented Jun 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Copilot's findings

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot's findings

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Jun 16, 2026 •

edited

Loading