[Feature]: First-party bugfix and assess bundles with bundled workflows
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 45/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- python
- Área
- cli, documentation, tooling
Línea de trabajo
Comienza con las capas existentes de workflows y bundles, especialmente workflows/speckit/, workflows/catalog.json, bundles/catalog.community.json y las pruebas de validación de bundles y workflows. Lee workflows/README.md y docs/reference/bundles.md y, después, sigue el flujo para añadir y eliminar bundles, así como la resolución del catálogo builtin://default. La tarea estará terminada cuando tanto los workflows como los bundles se validen, instalen y eliminen conjuntamente sin cambios colaterales, se supere la comprobación de consistencia del catálogo y se actualice la documentación solicitada.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Problem Statement
Spec Kit ships exactly one out-of-the-box workflow: the SDD cycle (speckit, auto-installed at init). The bug and assess extensions provide multi-step pipelines (assess → fix → test, and intake → research → define → shape → decide) that are ideal workflow candidates, but they can only be driven by manually invoking each command — with no gates, persisted state, or workflow resume. There is no orchestrated bug-fixing or idea-assessment path in stock Spec Kit.
Discussed and agreed in #4461: the fix follows the existing layering — workflows live in the workflow layer, bundles are the composition layer. No new contribution types.
Proposed Solution
Two first-party bundles, each pairing its extension with a bundled workflow:
-
Bundled workflows (parallel to workflows/speckit/):
- workflows/bugfix/workflow.yml (id bugfix): speckit.bug.assess → gate "review the assessment before any code change" (reject aborts) → speckit.bug.fix → speckit.bug.test; inputs: report, slug
- workflows/assess/workflow.yml (id assess): intake → research → define → shape → decide → gate on the verdict (stops there; the /speckit.specify handoff stays manual); inputs: idea, slug
- Both registered in workflows/catalog.json and packaged with the CLI (core_pack) like speckit — nothing is auto-installed at init; the extensions stay opt-in, installation happens via bundle add.
-
First-party bundles:
- bundles/bugfix/ — bundle.yml composing the bug extension + bugfix workflow (pinned versions, role developer)
- bundles/assess/ — bundle.yml composing the assess extension + assess workflow
- bundles/catalog.json listing both (repo-shipped first-party counterpart to catalog.community.json, verified: true)
-
First-party bundle catalog wiring: the reserved builtin://default catalog (currently empty) resolves entries from bundles/catalog.json — online from the repo, offline from the packaged snapshot (mirroring the community catalog pattern). Without this,
specify bundle add bugfixcannot resolve by id.
specify bundle add bugfix then installs the extension and its orchestrated pipeline in one step; bundle update/remove provide the lifecycle coupling.
Alternatives Considered
- Extension-owned workflows via provides.workflows in extension.yml (rejected in #4461: duplicates the bundle layer inside the extension layer).
- git / agent-context extension workflows — deliberately excluded: git runs via lifecycle hooks, agent-context is a single hook-driven command, not a multi-step flow.
- Only registering the workflows in workflows/catalog.json without bundles — would leave the extension↔workflow coupling to the user and defeat the agreed composition layer.
Component
Specify CLI (initialization, commands)
AI Agent (if applicable)
Not applicable
Use Cases
- A user hits a bug and wants a guided, resumable pipeline: assess → human gate before any code change → fix → test, instead of invoking three commands in the right order by hand.
- A team wants idea triage before SDD: run the assess pipeline with a review gate at the verdict, then hand surviving ideas to /speckit.specify manually.
Acceptance Criteria
- validate_workflow passes for both new workflow YAMLs; steps/gates/inputs match the schema in workflows/README.md
- workflows/catalog.json entries match the bundled YAMLs' ids/versions/urls; contract test mirrors test_wheel_bundled_presets.py for bundled workflows
-
specify bundle validate bundles/bugfix --offline(and assess) passes with zero unresolved references -
specify bundle add bugfixin a fresh project installs the bug extension and registers the bugfix workflow (workflow info/run works: assess → gate → fix → test) -
specify bundle remove bugfixuninstalls both contributed components; independently-installed components are never removed (no collateral removals, FR-022) - Both bundles' catalog pins match the shipped extension/workflow versions; automated consistency test
- Docs updated: docs/reference/bundles.md (first-party bundles + bundles/catalog.json), workflows/README.md (layout), bundle READMEs
- Existing behavior unchanged: speckit workflow auto-install, extension add/remove, and community catalogs behave identically before/after
Additional Context
- Discussion: #4461 (maintainer-approved shape: two first-party bundles composing existing pieces, bug/assess command surfaces unchanged)
- Related discussion #4415 for the acceptance-criteria-first workflow
- Out of scope (follow-up): fully offline
bundle install --offline. Today the bundle manifest itself always resolves via its catalog download_url, and workflow add has no bundled-asset fallback — both would need packaged first-party bundle artifacts. Tracked separately once this feature lands. - Open point for the PR: hosting of the bundle artifacts referenced by the bundles/catalog.json download_urls (e.g. CI-built release assets), to be decided during implementation.
- Lenguaje dominante
- Python
- Estrellas
- 138k
- Forks
- 12.4k
- Merge medio
- 3 d 6 h
- PR fusionados (30 d)
- 136
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de github/spec-kit
-
triage-can-wait
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
-
enhancement needs-triage triage-can-wait
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
-
bundle-submission needs-info triage-can-wait validation-failed
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
-
author-awaiting enhancement needs-triage preset-submission triage-can-wait validation-failed
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
-
author-awaiting enhancement extension-submission needs-triage triage-can-wait validation-failed
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
Todos los issues de github/spec-kit
Issues similares
-
triage/confirmed
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
agentscope-ai/agentscope#2775 ·
-
comp/desktop P3 type/bug
Dificultad 1/5 Menos de una hora Aptitud para principiantes 92/100
NousResearch/hermes-agent#118866 ·
-
bug
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
apache/cloudstack#14222 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100