Skip to content

markhazleton/devspark

DevSpark

A structured development process for AI coding assistants.
Just markdown files — no install required.

Release GitHub stars License Documentation

Not a program. Not a subscription. Copy 21 prompt files into your project and your AI coding assistant gets a repeatable workflow — from requirements through release. Works with Claude, Copilot, Cursor, Gemini, and 13 more.


What's In This Repo

devspark/
├── templates/commands/   ← 21 slash-command prompt files (THE PRODUCT)
├── scripts/              ← Context-gathering scripts (PowerShell + Bash)
├── src/devspark_cli/     ← Optional CLI for automated setup
└── .documentation/       ← Guides, media, and GitHub Pages site

Get Started

Option A — Agent Quickstart (recommended — no install)

Point your AI agent at the quickstart prompt for your platform:

The agent asks a few questions, then pulls and installs all DevSpark prompts.

Option B — Download and Drop

  1. Download the latest release zip for your agent and unzip into your project
  2. Start using /devspark.* commands in your AI assistant

Option C — CLI (automates Option A)

uv tool install devspark-cli --from git+https://github.com/markhazleton/devspark.git
devspark init my-project          # new project
devspark init --here --ai claude  # existing project

For a full walkthrough see the Quickstart Guide.


Slash Commands

Core Workflow

Command Purpose
/devspark.constitution Establish project principles and guidelines
/devspark.specify Define what you want to build (requirements & user stories)
/devspark.plan Create a technical implementation plan
/devspark.tasks Break the plan into actionable task lists
/devspark.implement Execute tasks and build the feature

Constitution-Powered (no spec required)

Command Purpose
/devspark.pr-review Constitution-based PR review
/devspark.site-audit Comprehensive codebase audit
/devspark.quickfix Lightweight workflow for bug fixes
/devspark.critic Adversarial risk analysis
/devspark.release Archive dev artifacts and prepare releases
/devspark.harvest Clean stale docs and archive obsolete artifacts
/devspark.evolve-constitution Propose constitution amendments
/devspark.repo-story Generate narrative from commit history

Quality & Personalization

Command Purpose
/devspark.clarify Ask structured questions to de-risk ambiguity
/devspark.analyze Cross-artifact consistency check
/devspark.checklist Generate quality validation checklists
/devspark.personalize Create per-user command overrides
/devspark.discover-constitution Generate a constitution from existing code
/devspark.archive Archive completed spec artifacts
/devspark.upgrade Pull latest DevSpark prompts into your project

See templates/README.md for full command details.


Customization Without Risk

DevSpark cleanly separates your work from its installation:

.devspark/                 ← Installation (removable, upgrade-safe)
├── defaults/commands/     ← Stock prompts
├── scripts/              ← Stock helper scripts
├── templates/            ← Spec/plan templates
└── VERSION               ← Installed version stamp

.documentation/            ← Your work (never touched by DevSpark)
├── memory/constitution.md
├── specs/
├── commands/             ← Team command overrides
├── scripts/              ← Team script overrides (optional)
├── devspark.json         ← Platform config (optional)
└── {git-user}/commands/  ← Personal overrides

3-tier prompt resolution (first match wins):

  1. .documentation/{git-user}/commands/ — Personal tweaks
  2. .documentation/commands/ — Team customizations
  3. .devspark/defaults/commands/ — Stock prompts

2-tier script resolution (first match wins):

  1. .documentation/scripts/ — Team script overrides (e.g., Azure DevOps adapter)
  2. .devspark/scripts/ — Stock scripts

Clean removal: devspark uninstall removes .devspark/ and agent shims, leaves .documentation/ untouched.


Supported AI Agents

DevSpark is agent-agnostic. Every agent below gets thin shims that redirect to shared canonical prompts.

Agent Agent Agent
Claude Code Cursor Gemini CLI
GitHub Copilot Codex CLI Windsurf
Amp Roo Code Kilo Code
Auggie CLI opencode Qwen Code
SHAI Amazon Q ⚠️ IBM Bob
CodeBuddy Qoder CLI

Learn More

Topic Link
Quickstart quickstart.md
Constitution guide constitution-guide.md
CLI reference installation.md
Upgrading upgrade.md
PR review guide pr-review-usage.md
Site audit guide site-audit-usage.md
Critic guide critic-usage.md
Harvest guide harvest-usage.md
Repo story repo-story/

DevSpark video


Prerequisites

Contributing

See CONTRIBUTING.md and CODE_OF_CONDUCT.md.

Acknowledgements

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

License

MIT — see LICENSE.

About

Spec-driven development process for AI coding assistants. 21 prompt files, 17+ agents, no install required.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors