Skip to content

openspec-propose/explore skill reference specific artifacts #2084

Closed

Description

@JackCaster

What happened

I have a custom (simpler) schema, with assumes different artifacts as compared to the default ones. The openspec-propose/explore skills, however, reference spec-driven default artifacts (proposal.md, design.md, tasks.md) so their are not compatible with custom schema.

What you expected instead

Openspec procedures should be general enough to work with any schema, and it currently is for the most part. Only the intro text and the examples in the skill name proposal.md, design.md and tasks.md. I have not encountered any failure. The risk is that an agent follows the examples literally and expects artifacts that the custom schema does not produce.

Minimal steps to reproduce

Read skills openspec-propose and openspec-explore

OpenSpec version

1.14.1

Coding agent and model

No response

OS and Node version

No response

Activity

  1. added a commit that references this issue on Oct 14, 2026
    9cb5ba8
  2. added a commit that references this issue on Oct 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingneeds-triageAwaiting triage

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions