Skip to content

Releases: markhazleton/devspark

DevSpark Templates - 2.7.0

Choose a tag to compare

@markhazleton markhazleton released this 29 Jun 04:42

Release Notes: v2.7.0

Release Metadata

  • Version: v2.7.0
  • Release Date: 2026-06-27
  • Release Window: 2026-06-20 → 2026-06-27
  • Previous Version: v2.6.0
  • Commit Range: fd80ba76fda4c044431f8795eb342d24a71f368c..4acdefa0b54e28296681db87fd5479755cfff0ee (v2.6.0..HEAD)
  • Commits: 4
  • Contributors: 1
  • Merged PRs: 0

Highlights

This release closes a real gap users hit chaining specify → plan → tasks → critic → analyze by hand: critic and analyze findings now have a path back into tasks.md. Re-running /devspark.tasks after tasks.md already exists merges both gate reports (deduped, severity-sorted) into a ## Gate Remediation task phase, and /devspark.implement marks each resolved finding back in its originating gate file — so re-running critic/analyze converges instead of re-reporting the same issues.

A new full-cycle workflow/alias chains the entire lifecycle with autonomy.level: autonomous and guardrails instead of mandatory pauses, for users who want fewer checkpoints. It ships in two forms: templates/workflows/full-cycle.yaml (sequenced via devspark run full-cycle, still expects an agent driving the conversation) and full-cycle.harness.yaml (a HarnessSpec for genuinely unattended execution via devspark harness run --hands-off). Eight command prompts (implement, tasks, create-pr, quickfix, analyze, address-pr-review, specify, clarify) now recognize a --auto autonomy convention that auto-selects the recommended option at each gate instead of waiting — while still hard-stopping on constitution/SHOWSTOPPER violations.

The rest of the cycle was a documentation accuracy pass: every command prompt that runs long now states its completion condition and chat-output budget up front instead of only at the final step, implement.md had three redundant steps merged into two, and a sweep across README/CHANGELOG/FAQ/index/harness docs corrected several pre-existing staleness issues found along the way — a missing codex adapter in three docs, a stale "27 commands" count in four places, a missing /devspark.taskstoissues row, a broken link to a file that never existed, and an autonomy-model.md claim that didn't match the actual executor.py behavior.

New Features

Gate Remediation Merge and Finding Resolution Sync

/devspark.tasks detects whether tasks.md already exists; on a re-run it merges gates/critic.md + gates/analyze.md findings into a deduped, severity-sorted ## Gate Remediation task phase with elaborated recommendations. /devspark.implement flips a finding's status to resolved (and fills outcome) in its originating gate file when the task tagged (resolves: <finding_id>) completes.

--auto Autonomy Convention

implement.md, tasks.md, create-pr.md, quickfix.md, analyze.md, address-pr-review.md, specify.md, and clarify.md recognize a standing --auto instruction and auto-select the recommended option at "ask the user" gates, recording auto-selected: true under ## Gate Acknowledgements. Constitution/SHOWSTOPPER violations, quickfix FAIL findings, and execution_mode: manual findings are never auto-bypassed; PR creation under --auto defaults to --draft.

full-cycle Workflow, Alias, and Harness Spec

A fourth workflow/alias pair chaining all nine lifecycle steps with autonomy.level: autonomous and guardrails (max_files_changed, restricted_paths, max_total_lines_changed) instead of pause_after checkpoints. full-cycle.harness.yaml provides the same chain as agent_task steps for execution via devspark harness run --adapter claude_code --hands-off, with validation rules that resolve the active feature directory dynamically instead of hardcoding a path.

Bug Fixes

  • Removed unused logo_large.webp and logo_small.webp from .documentation/media/.
  • Updated the release-notes generator's agent count to 18+.
  • Corrected .documentation/autonomy/autonomy-model.md's autonomous level description, a stale "27 commands" count (4 files), a missing codex adapter listing (3 files), a missing /devspark.taskstoissues row in README.md, and a broken templates/README.md link.

Breaking Changes

None.

Deprecations

None.

Architectural Decisions

  • ADR-008: Prompt-Level Autonomy Override and the full-cycle Lifecycle — View

Deferred Features

None — no pending specs at release time.

Upgrade Guide

No breaking changes. Consumer projects receive the new version stamp and the full-cycle workflow/alias/harness-spec files the next time they run devspark upgrade. The --auto convention is prompt-level — no CLI flag parsing changed, so existing automation is unaffected; opt in by including --auto in a command invocation or stating a standing autonomy instruction in the conversation.

Metrics

Metric Value
Features Delivered 3
Bugs Fixed 6
PRs Merged 0
Files Changed 32
Tests Added 0
Breaking Changes 0
ADRs Created 1
Contributors 1
Commits 4

Release documentation generated by /devspark.release

DevSpark Templates - 2.6.0

Choose a tag to compare

@github-actions github-actions released this 20 Jun 20:06

DevSpark

DevSpark is an Adaptive System Life Cycle Development (ASLCD) toolkit with constitution-powered commands, prompt-first onboarding, and right-sized workflows for AI coding assistants.

Highlights

  • Prompt-first lifecycle: Quickstart and upgrade flows work directly from remote prompt files
  • Constitution-powered workflows: Requirements, planning, review, and audit flows stay aligned with project rules
  • Agent-agnostic architecture: Shared stock prompts plus thin shims for 18+ AI coding assistants
  • Safe customization model: .devspark/ stays replaceable while .documentation/ preserves project work

Using This Release

For normal use, bootstrap and update DevSpark from your AI chat using the remote quickstart and upgrade prompt files. The CLI remains available for advanced terminal-driven automation.

Changelog

  • Antigravity agent support — registered as a first-class agent (.gemini/ folder, ANTIGRAVITY.md, command shims, dedicated quickstart guide and integration doc). DevSpark now supports 18 AI agents.
  • Make Bold Solutions and Make Bold Spark brand assets added under .documentation/branding/
  • devspark upgrade agent auto-detection now distinguishes Antigravity from Gemini CLI (both share the .gemini/ folder)
  • devspark run --allow-dirty help text reworded for clarity
  • Documentation harvest — archived 10 stale audit/harvest/repo-story/PR-review artifacts
  • Fix: corrected formatting/spacing in the Antigravity integration doc
  • Fix: hands-off lifecycle contract test now reads its spec fixture from the archived releases/v2.5.0/ path instead of a stale pre-archival path

See CHANGELOG.md for full details.


DevSpark is independently maintained by Mark Hazleton and the open-source community.

v2.5.0

Choose a tag to compare

@markhazleton markhazleton released this 05 Jun 13:58

Release Notes: v2.5.0

Release Metadata

  • Version: v2.5.0
  • Release Date: 2026-06-05
  • Release Window: 2026-04-18 → 2026-06-05
  • Previous Version: v2.4.0
  • Commit Range: 1eb4f46c..297b6ab5 (v2.4.0..HEAD)
  • Commits: 22
  • Contributors: 4
  • Merged PRs: 7 (#41, #42, #43, #44, #46, #47, #48, #49)

Highlights

v2.5.0 re-platforms DevSpark from a curated prompt library into a governed orchestration engine. The headline delivery is the Tiered Prompt and Workflow Engine — three new artifact layers (atomic prompts, workflow YAML, alias entrypoints) wired by a Python workflow runner that enforces autonomy guardrails, pauses for human review, and writes structured telemetry. Three flagship aliases (create-spec, execute-plan, suggest-improvement) give beginners discoverable entrypoints without disrupting the expert atomic command surface.

This release also introduces two vocabulary and governance advances. Participant Roles resolves a long-standing terminology ambiguity: participant now denotes human or AI-filled team members while agent remains reserved for AI runtime integrations. AGT-Inspired Governance Improvements bring structured severity codes, trust-tiered PR review depth, a known-limitations document, and a prompt conformance manifest — all as additive Markdown artifacts with no new tool dependencies.

Four architectural decisions (ADR-004 through ADR-007) are ratified and stored in .documentation/decisions/, providing durable context for every significant choice made during this cycle.

New Features

Tiered Prompt and Workflow Engine

DevSpark now ships three orchestration layers under templates/:

  • templates/prompts/atomic/ — 28 atomic prompt shims (one per legacy command)
  • templates/workflows/ — YAML workflow definitions (create-spec.yaml, execute-plan.yaml, suggest-improvement.yaml)
  • templates/aliases/ — Alias entrypoints mapping high-level names to workflows

The Python workflow runner (src/devspark_cli/runner/) enforces autonomy guardrails, evaluates when expressions, pauses at review_after steps, and writes JSON Lines telemetry. A shim-drift CI job ensures atomic prompts never fall out of sync with command sources.

New CLI: devspark run <alias|workflow>, devspark workflows, devspark runs, devspark resume, devspark help.

Spec: View archived spec

Participant Roles

Introduces participant as the canonical vocabulary for team members carrying workflow responsibility. Optional participants YAML frontmatter can now appear in any spec, plan, or task file:

participants:
  owner: human
  planner: ai
  implementer: ai
  reviewer: human
  critic: ai
  scribe: ai

Metadata is advisory only — it does not affect prompt resolution, command behavior, or backward compatibility.

Spec: View archived spec

AGT-Inspired Governance Improvements

Four additive governance artifacts inspired by Microsoft AGT's governance philosophy:

  • Severity registry — finding codes in §{section}.{LEVEL} format matching constitution markers
  • Known-limitations document — honest public statement of DevSpark's scope boundaries
  • Prompt conformance manifest — semantic checklist for command template governance drift
  • Trust-tier PR review — spec-backed PRs: standard depth; spec-less PRs: elevated scrutiny + MEDIUM finding

Spec: View archived spec

Bug Fixes

  • Agent Skills install gap (#42, #43, #44): templates/skills/ was not installed by any quickstart or upgrade. All five quickstart guides now include Step 5.5 fetching the full skills tree.
  • Cross-platform script install (#46): All quickstarts now unconditionally install both Bash and PowerShell script sets. address-pr-review.md sh variant fixed to use the native Bash script.

Breaking Changes

None.

Deprecations

None.

Architectural Decisions

  • ADR-004: Tiered Prompt and Workflow Architecture — View
  • ADR-005: Participant Vocabulary — Reserving agent for AI Runtimes — View
  • ADR-006: AGT-Inspired Governance — Severity Registry, Trust Tiers, and Conformance Manifest — View
  • ADR-007: Harness Workflow Fixture as Spec Lifecycle Compliance Artifact — View

Deferred Features

None — all specs in this cycle are complete.

Upgrade Guide

No breaking changes. To upgrade existing consumer projects:

devspark upgrade

The upgrade will install the new templates/prompts/atomic/, templates/workflows/, and templates/aliases/ surfaces plus updated scripts. All existing /devspark.* slash commands continue to resolve unchanged.

Metrics

Metric Value
Features Delivered 4
Bugs Fixed 2
PRs Merged 8
ADRs Created 4
Contributors 4
Commits 22
Breaking Changes 0

Release documentation generated by /devspark.release v1.0

DevSpark Templates - 2.4.0

Choose a tag to compare

@github-actions github-actions released this 21 May 02:49

DevSpark

DevSpark is an Adaptive System Life Cycle Development (ASLCD) toolkit with constitution-powered commands, prompt-first onboarding, and right-sized workflows for AI coding assistants.

Highlights

  • Prompt-first lifecycle: Quickstart and upgrade flows work directly from remote prompt files
  • Constitution-powered workflows: Requirements, planning, review, and audit flows stay aligned with project rules
  • Agent-agnostic architecture: Shared stock prompts plus thin shims for 17+ AI coding assistants
  • Safe customization model: .devspark/ stays replaceable while .documentation/ preserves project work

Using This Release

For normal use, bootstrap and update DevSpark from your AI chat using the remote quickstart and upgrade prompt files. The CLI remains available for advanced terminal-driven automation.

Changelog

  • feat: Add documentation audit for v1.6.0 release and PR review files for recent changes
  • feat: Add support for GitHub release asset resolution and pre-run gate checks
  • Merge pull request #41 from markhazleton/003-add-first-skill
  • fix: resolve PR 41 CI failures
  • review(pr-41): rev 3 codex scope update
  • Add first-class Codex quickstart support
  • review(pr-41): rev 2 — 3 fixed, 1 remaining (CON-01)
  • fix(pr-41): address M-01, M-02, L-01 — skills root resolution, CI coverage, unused import
  • docs(pr-review): add review for PR #41 — feat(skills) write-spec Agent Skill
  • docs(003): mark all 35 tasks complete — spec status Complete, all user stories delivered
  • refactor(specify): 2D thin-wrapper — delegate spec-drafting to write-spec skill
  • feat(skills): add 2C tests and CLI — skill contract validation, adapter contract, devspark skills subcommand
  • feat(skills): add write-spec skill — portable spec-drafting Agent Skill
  • feat(skills): add 2A foundation — adapter contract, SKILL validation contract, skills README
  • feat(agents): add comprehensive documentation for agent integration and workflows
  • docs(003): resolve all analyze + critic gate findings before implementation
  • feat(skills): add initial implementation of write-spec skill and associated guide
  • refactor: optimize release/harvest workflow — clarify boundaries, align spec status logic, add commit range to release artifacts
  • docs: improve table formatting and clarity in implementation gates section
  • Enhance documentation and risk checklists
  • docs: update formatting for script preference prompts in quickstart guide
  • feat(cli): add validate_installation_manifest and wire into init shim-validate step
  • feat(quickstart): resolve issue #39 - simplify bootstrap UX (6 phases)
  • docs: add attribution, live-site link, and GA4 tag

DevSpark is independently maintained by Mark Hazleton and the open-source community.

DevSpark Templates - 2.3.0

Choose a tag to compare

@markhazleton markhazleton released this 14 May 16:37

DevSpark

DevSpark is an Adaptive System Life Cycle Development (ASLCD) toolkit with constitution-powered commands, prompt-first onboarding, and right-sized workflows for AI coding assistants.

Highlights

  • Prompt-first lifecycle: Quickstart and upgrade flows work directly from remote prompt files
  • Constitution-powered workflows: Requirements, planning, review, and audit flows stay aligned with project rules
  • Agent-agnostic architecture: Shared stock prompts plus thin shims for 17+ AI coding assistants
  • Safe customization model: .devspark/ stays replaceable while .documentation/ preserves project work

Using This Release

For normal use, bootstrap and update DevSpark from your AI chat using the remote quickstart and upgrade prompt files. The CLI remains available for advanced terminal-driven automation.

Changelog

  • chore: release v2.3.0 metadata and documentation refresh - feat: add upgrade release-asset preflight diagnostics - fix: repair malformed copilot shim frontmatter and harden quickstart - feat(init): add support for specifying GitHub release tag during project initialization feat(template): enhance template download with fallback to previous releases and detailed metadata test: add tests for template download behavior with fallback and explicit release tags - chore: remove archived review subproject reference - fix(harvest): support dogfood script fallback and resilient context out-file - docs(harvest): record 2026-05-06 run and fixture changelog cross-reference

DevSpark is independently maintained by Mark Hazleton and the open-source community.

DevSpark Templates - 2.2.1

Choose a tag to compare

@markhazleton markhazleton released this 06 May 14:52

Release Notes: v2.2.1

Release Metadata

  • Version: v2.2.1
  • Release Date: 2026-05-06
  • Release Window: 2026-04-30 → 2026-05-06
  • Previous Version: v2.2.0
  • Commits: 41
  • Contributors: 3 (Mark Hazleton, DevSpark Test, copilot-swe-agent[bot])
  • Merged PRs: 3 (#31, #34, #35)

Highlights

This patch release focuses on maintainability, release-process documentation quality,
and compatibility hardening rather than introducing new end-user workflow features.

The harness and CLI internals were refactored into smaller, focused modules to improve
readability and future change safety. In parallel, several audit and lifecycle issues
were fixed to keep quality gates, fixture integrity, and contract behavior consistent.

New Features

None in this patch release.

Bug Fixes

  • Restored backward-compatibility delegates for removed HarnessRunner methods
  • Corrected harness max-pass failure report pass_count handling
  • Restored missing harness fixture files required by contract workflows
  • Resolved markdown lint trigger and spec lifecycle audit findings
  • Fixed delivery-status shell timeout variable handling (TIMEOUT_SECONDS)

Breaking Changes

None.

Deprecations

None.

Architectural Decisions

No new ADRs were created in this release.

Deferred Features

None.

Upgrade Guide

No migration steps are required. Update to v2.2.1 to receive refactoring,
compatibility, and release-quality fixes.

Metrics

Metric Value
Features Delivered 0
Bugs Fixed 5
PRs Merged 3
Files Changed 0
Tests Added 0
Breaking Changes 0
ADRs Created 0
Contributors 3
Commits 41

Release documentation generated by /devspark.release v2.2.1

DevSpark Templates - 2.1.0

Choose a tag to compare

@github-actions github-actions released this 18 Apr 22:40

DevSpark

DevSpark is an Adaptive System Life Cycle Development (ASLCD) toolkit with constitution-powered commands, prompt-first onboarding, and right-sized workflows for AI coding assistants.

Highlights

  • Prompt-first lifecycle: Quickstart and upgrade flows work directly from remote prompt files
  • Constitution-powered workflows: Requirements, planning, review, and audit flows stay aligned with project rules
  • Agent-agnostic architecture: Shared stock prompts plus thin shims for 17+ AI coding assistants
  • Safe customization model: .devspark/ stays replaceable while .documentation/ preserves project work

Using This Release

For normal use, bootstrap and update DevSpark from your AI chat using the remote quickstart and upgrade prompt files. The CLI remains available for advanced terminal-driven automation.

Changelog

  • docs: update audit, harvest, and release documentation with markdownlint guidelines and formatting improvements

DevSpark is independently maintained by Mark Hazleton and the open-source community.

DevSpark Templates - 2.0.0

Choose a tag to compare

@github-actions github-actions released this 16 Apr 15:15

DevSpark

DevSpark is an Adaptive System Life Cycle Development (ASLCD) toolkit with constitution-powered commands, prompt-first onboarding, and right-sized workflows for AI coding assistants.

Highlights

  • Prompt-first lifecycle: Quickstart and upgrade flows work directly from remote prompt files
  • Constitution-powered workflows: Requirements, planning, review, and audit flows stay aligned with project rules
  • Agent-agnostic architecture: Shared stock prompts plus thin shims for 17+ AI coding assistants
  • Safe customization model: .devspark/ stays replaceable while .documentation/ preserves project work

Using This Release

For normal use, bootstrap and update DevSpark from your AI chat using the remote quickstart and upgrade prompt files. The CLI remains available for advanced terminal-driven automation.

Changelog

  • fix lint issues

DevSpark is independently maintained by Mark Hazleton and the open-source community.

v1.6.0

Choose a tag to compare

@markhazleton markhazleton released this 12 Apr 15:13

Release Notes: v1.6.0

Release Metadata

  • Version: v1.6.0
  • Release Date: 2026-04-12
  • Previous Version: v1.5.0
  • Commits Since Previous Release: 8
  • Contributors: Mark Hazleton, copilot-swe-agent[bot]

Highlights

DevSpark v1.6.0 is a consistency and install-hardening release. It standardizes how installed repositories resolve stock helper templates, closes quickstart drift around constitution seeding and inventory completeness, and makes incomplete same-version installs repairable instead of only reportable.

This release also tightens the quickstart intake experience. Users are now asked only for install-critical information up front, while project metadata questions are deferred until a new constitution actually needs to be created.

Added

  • /devspark.update-pr prompt template for refreshing an existing pull request description from branch delta
  • /devspark.commit-audit prompt template for commit-history workflow and hygiene review
  • Explicit quickstart Repair Mode for missing stock framework files in existing installs

Changed

  • Installed-repository prompt templates now resolve helper templates from .devspark/templates/
  • Quickstarts now preserve existing constitutions and reuse them instead of re-asking for project metadata
  • Quickstarts now separate install-critical questions from constitution-bootstrap questions
  • Release evidence docs and validation references now track v1.6.0

Fixed

  • Missing quickstart inventory entries for quick-spec-template.md and update-pr.md
  • Duplicate constitution seeding under .devspark/
  • Mismatch between command-template helper-template paths and quickstart install paths
  • Same-version quickstart installs that were missing framework files now trigger repair guidance instead of a false success path

Validation

  • 10 repository test scripts executed successfully
  • Targeted markdown linting passed for all edited quickstart files and quickstart README
  • GitHub CLI release prerequisites validated before publication

Upgrade Notes

  • Team and per-user overrides under .documentation/ remain preserved.
  • Stock framework assets under .devspark/ can now be repaired even when the installed version already matches the latest release.
  • Existing constitutions under .documentation/memory/constitution.md are treated as the source of truth during quickstart bootstrap.

Release Artifacts

  • Changelog updated for v1.6.0
  • Package version bumped to 1.6.0
  • Release readiness documented in .documentation/release-readiness-v1.6.0.md
  • Documentation audit documented in .documentation/docs-audit-2026-04-12.md

DevSpark Templates - 1.5.0

Choose a tag to compare

@github-actions github-actions released this 11 Apr 15:52

DevSpark

DevSpark is an Adaptive System Life Cycle Development (ASLCD) toolkit with constitution-powered commands, prompt-first onboarding, and right-sized workflows for AI coding assistants.

Highlights

  • Prompt-first lifecycle: Quickstart and upgrade flows work directly from remote prompt files
  • Constitution-powered workflows: Requirements, planning, review, and audit flows stay aligned with project rules
  • Agent-agnostic architecture: Shared stock prompts plus thin shims for 17+ AI coding assistants
  • Safe customization model: .devspark/ stays replaceable while .documentation/ preserves project work

Using This Release

For normal use, bootstrap and update DevSpark from your AI chat using the remote quickstart and upgrade prompt files. The CLI remains available for advanced terminal-driven automation.

Changelog

  • Merge pull request #15 from markhazleton/feature/workflow-evolution-create-pr-agent-registry
  • docs: fix markdown lint error in AGENTS.md
  • docs: document agents-registry.json in AGENTS.md
  • fix: resolve markdownlint, shellcheck, and test failures for CI
  • feat: add validation for create-pr preflight lifecycle context
  • feat: evolve route-aware workflows and shared agent registry

DevSpark is independently maintained by Mark Hazleton and the open-source community.