Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature, fix, or modification with a structured step-by-step approach.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
Start a new change using the experimental artifact-driven approach.
**Input**: The user's request should include a change name (kebab-case) OR a description of what they want to build.
**Steps**
1. **If no clear input provided, ask what they want to build**
Use the **AskUserQuestion tool** (open-ended, no preset options) to ask:
> "What change do you want to work on? Describe what you want to build or fix."
From their description, derive a kebab-case name (e.g., "add user authentication" → `add-user-auth`).
**IMPORTANT**: Do NOT proceed without understanding what the user wants to build.
2. **Determine the workflow schema**
Use the default schema (omit `--schema`) unless the user explicitly requests a different workflow.
**Use a different schema only if the user mentions:**
- A specific schema name → use `--schema <name>`
- "show workflows" or "what workflows" → run `openspec schemas --json` and let them choose
**Otherwise**: Omit `--schema` to use the default.
3. **Create the change directory**
```bash
openspec new change "<name>"
```
Add `--schema <name>` only if the user requested a specific workflow.
…
The line at the top of this page pins the label v1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (2889 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag
Source
GitHub
taskless/cli · 239 stars · license MIT · pushed 2026-11-02 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jltygd5wlpeusuwq
GET https://markdownregistry.com/api/v1/resolve?ref=taskless/cli/openspec-new-change
GET https://markdownregistry.com/api/v1/blob/cdaa388d36d27cc4b29a6a96d748671dc39e7484bab2025828606fee4d16190a
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
taskless/cli · .agents/skills/code-simplifier/SKILL.md · Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when…
taskless/cli · .agents/skills/iterate-pr/SKILL.md · Iterate on a PR until CI passes. Use when you need to fix CI failures, address review feedback, or continuously push…
taskless/cli · .agents/skills/openspec-apply-change/SKILL.md · Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or…
taskless/cli · .agents/skills/openspec-archive-change/SKILL.md · Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after…
taskless/cli · .agents/skills/openspec-bulk-archive-change/SKILL.md · Archive multiple completed changes at once. Use when archiving several parallel changes.
taskless/cli · .agents/skills/openspec-continue-change/SKILL.md · Continue working on an OpenSpec change by creating the next artifact. Use when the user wants to progress their change…
taskless/cli · .agents/skills/openspec-explore/SKILL.md · Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use…
taskless/cli · .agents/skills/openspec-ff-change/SKILL.md · Fast-forward through OpenSpec artifact creation. Use when the user wants to quickly create all artifacts needed for…
taskless/cli · .agents/skills/openspec-onboard/SKILL.md · Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
taskless/cli · .agents/skills/openspec-propose/SKILL.md · Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they…
taskless/cli · .agents/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
taskless/cli · .agents/skills/openspec-verify-change/SKILL.md · Verify implementation matches change artifacts. Use when the user wants to validate that implementation is complete…
fengshao1227/ccg-workflow · .agents/skills/openspec-new-change/SKILL.md · Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature…
intent-driven-dev/intent-driven-template · .opencode/skills/openspec-new-change/SKILL.md · Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature…
yazelin/ching-tech-os · .claude/skills/openspec-new-change/SKILL.md · Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature…
yazelin/ching-tech-os · .github/skills/openspec-new-change/SKILL.md · Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature…
justinjdev/fellowship · .claude/skills/openspec-new-change/SKILL.md · Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature…