| name | openspec-customize |
| description | Use when working with OpenSpec in Hermes: customize OpenSpec project config, rules, templates, and schemas. |
| version | 1.0.0 |
| author | TheSmuks + Hermes Agent |
| license | MIT |
| platforms | ["windows","macos","linux"] |
| metadata | {"hermes":{"category":"software-development","tags":["openspec","sdd","spec-driven-development","hermes"],"homepage":"https://github.com/Fission-AI/openspec"}} |
openspec-customize
Use when the user wants custom OpenSpec behavior, schemas, templates, artifact rules, or project context.
Prerequisite
Ensure the OpenSpec CLI exists with openspec --version. If missing, install it with npm install -g @fission-ai/openspec@latest.
Project config
Edit openspec/config.yaml:
schema: spec-driven
context: |
Tech stack: ...
Conventions: ...
rules:
proposal:
- Include rollback plan
specs:
- Use Given/When/Then scenarios
Context applies to all artifacts. Rules apply only to the matching artifact.
Schema commands
- Create:
openspec schema init <name> --description "..." --artifacts "proposal,specs,design,tasks" --default
- Fork built-in:
openspec schema fork spec-driven <name>
- Validate:
openspec schema validate <name>
- Resolve precedence:
openspec schema which <name> or openspec schema which --all --json
Project schemas live in openspec/schemas/<name>/ and are version-controlled. Always validate schemas and run a sample status/instructions check before saying customization is ready.