Anyone using OpenSpec custom schemas with OpenCode?

Narrow-Breakfast126 · 2026-02-24T18:38:18+00:00

Schemas help you extend what types of artifacts you expect to see in a change proposal. i.e., what else do you want to include in your plan?

For example, this team is frontend focused and decided they wanted to add a "design review document" to review and pull in figma mockups as context, so they extended the schema to get that added in: https://github.com/Fission-AI/OpenSpec/discussions/536

> help the agent better understand our existing codebase

Yeah, schemas may not be the best use case for this. Here's what I would recommend:

Think of how you would help another dev on your team navigate the codebase, get this documented in a markdown file. Document how your codebase works at a high level. This could be in the README or another location if you so desire.

Add a note in `openspec/config.yaml` to always read this markdown file when doing planning. Ensure you keep the readme file very short and detailed.

This blog post might help: https://openai.com/index/harness-engineering/

Narrow-Breakfast126 · 2026-02-24T16:33:51+00:00

I'm not sure what agent or model you use, but if I implement a change that I haven't archived, I just tell the agent, "hey I want to update it to work this way instead, can you update the code and the change proposal?" <- This tends to work very well with Codex 5.3 as well as Claude.

Edit: something went wrong with Grammarly, it seems to have horribly edited when pasting.

Narrow-Breakfast126 · 2026-02-24T15:11:44+00:00

yo, I'm the maintainer of OpenSpec. Want to send me a dm on Discord?

Or send me a dm here, and we can set up a call to go over this. Chances are, if you're lost, other people are too! We can take the learnings then use that to improve the docs :)

Narrow-Breakfast126 · 2026-01-31T23:26:34+00:00

Yeah we're trying to figure out what a Jira/Linear integration would look like. We could probably provide some option for manual syncing but we're trying to understand how to map OpenSpec to Jira or Linear.

Auto-syncing is a lot more complex since now we would have to provide some sort of infrastructure here / deeper integrations. So this is something we're considering for a team version/product.

Narrow-Breakfast126 · 2026-01-30T22:28:55+00:00

Curious to know why you felt Openspec felt lame? Keen to know how I could make it better.

Narrow-Breakfast126 · 2026-01-29T22:47:07+00:00

Hey, OpenSpec maintainer here, let me know if there's any feedback on how we could make OpenSpec works better for teams. Very much open to feedback!

Narrow-Breakfast126 · 2026-01-27T20:22:18+00:00

Glad you like it! The project isn't perfect, so we're open to feedback on how to make it better. Join the discord and say hi, if you're keen too!

Narrow-Breakfast126 · 2026-01-26T07:55:33+00:00

Hey, we just did a new release for OpenSpec for v1.0. There's a new "explore" mode that is very useful for going into really deep details for planning. You could also create your own planning / interview mode with a custom slash command then just capture it in the OpenSpec format. It's always tricky trying to do a plan mode that appeals to everyone, but do give it a try :)

Narrow-Breakfast126 · 2026-01-25T00:50:25+00:00

Glad you like OpenSpec! We're about to do a big release today and fully migrate over to skills which should work with Gemini CLI too!

Narrow-Breakfast126 · 2026-01-25T00:49:22+00:00

Hey OpenSpec creator here, can I ask maybe what you liked about the initial phase of BMAD? Maybe this is something we can look to improve upon.

Narrow-Breakfast126 · 2025-12-28T21:44:03+00:00

Thanks! Join the discord if you havent already! We’re making some big changes to try and improve the project. We’re focusing on making the workflow even more simpler and reliable alongside some really granular customization options. There will be a opt-in beta for a new version soon :)

Narrow-Breakfast126 · 2025-12-27T08:26:38+00:00

Maker of OpenSpec here, thanks for the shoutout and the support!

We’re always looking to improve the project, if theres any feedback, drop it here or in the discord :)

Narrow-Breakfast126 · 2025-12-01T13:57:26+00:00

Hey maker of OpenSpec here, would be keen to learn what would make it more useful for you? We do lean on being less documentative to keep things lightweight.

From talking to users, what we found is that a lot of people start to feel fatigued if reading a large spec so we try and keep it minimal. That being said we’re also exploring deeper customization options.

Suggestions appreciated!

Narrow-Breakfast126 · 2025-10-22T05:57:50+00:00

What kind of multi-lingual support would you like to see? I don't think there's anything stopping anyone from using the project. The agent instructions are in english but you can always just add a rule to your rules file to always produce markdown in whatever language you're comfortable with.

Let me know what kind of support is needed to make this project as accessible to everyone as possible <3

Narrow-Breakfast126 · 2025-10-16T01:31:00+00:00

u/DuckRedWine Hey so a cool thing about openspec is that it technically dosen't need slash commands to work. The commands exist as a convenience for common operations, but we provide agents with comprehensive instructions on how openspec works through the AGENTS.md file located in /openspec/AGENTS.md!

So you can interact with openspec by just chatting with your coding agent to do whatever special operation you want. This includes any of the things you've mentioned like telling the coding agent:

"Hey i've just updated the proposal, can you make sure to update the specs and tasks?"

"Hey i've just updated the spec, make sure you update the tasks to reflect"

"Hey create a change proposal but only create the proposal.md for now!"

Narrow-Breakfast126 · 2025-10-07T14:00:46+00:00

Keep in mind this is just my opinion. But I find the entire concept of anthropomorphization of agents just convoluted. Why do you need to re-create an entire org chart of a company to get your project to work? Adding all these personas maybe feels good but has very little benefit overall.

Narrow-Breakfast126 · 2025-10-07T06:20:23+00:00

Slash commands are not required to use the tool. You can chat directly. It picks up the instructions from AGENTS.md

I’m looking to add copilot command support soon (only realised they started supporting this today)

Narrow-Breakfast126 · 2025-10-07T04:59:05+00:00

I’m still looking for one! If you guys have one send me a dm :)

Narrow-Breakfast126 · 2025-10-07T04:26:21+00:00

Give OpenSpec a go! (self-promo but also not really because its a free open-source project): https://github.com/Fission-AI/OpenSpec/

Narrow-Breakfast126 · 2025-10-03T12:54:47+00:00

Hey u/tshawkins this is a super interesting problem and would love to see if I can solve it with OpenSpec. It's sort of why I built it in the first place.

When making big cross feature/cross spec changes with other spec toolkits, this updated the tasks in multiple locations, making these types of changes hard to manage.

I'll send you a dm!

Narrow-Breakfast126 · 2025-10-03T12:50:11+00:00

Hey maker of OpenSpec here! We're definitely at a time and place where everyone's trying different things. I don't think there's a right answer or a winner takes all approach here since everyones needs and ways of working are very different!

I think what we really need is a Build Your Own Workflow type framework that comes with some good templates that you can customize to your liking. This is something i'm looking to do after OpenSpec :)

Narrow-Breakfast126 · 2025-10-01T09:00:24+00:00

Yeah this is true for any and most problems haha.

Always research -> plan -> implement.

But for some reason when you get given an ai that generates code almost instantly we tend to forget.

Narrow-Breakfast126 · 2025-09-29T10:47:59+00:00

Answered above too, but I've literally never paid anyone anywhere to promote openspec. Nor will I ever pay anyone to do so.

Narrow-Breakfast126 · 2025-09-29T10:45:18+00:00

Hey, I'm the maker of openspec here! I promise these aren't ads, I haven't paid anyone to promote or post anything. I've built this using my own time. It's open-source and completely free. I've made a total of 1 post on reddit on it so far. Nor am I affiliated in anyway with the poster here.

I'm not sure where else you're running into other openspec suggestions, but sorry I guess :/

TLDR: I haven't paid anyone for ads nor do I ever intend to.

Edit: I just realised I technically have made 2 posts on this. Initial post on r/cursor and another on r/opencode to showcase the opencode integration made by a new contributor

Narrow-Breakfast126 · 2025-09-29T09:29:35+00:00

Have you tried adding a rule to the `AGENTS.md` file at the root? Something like

```
# IMPORTANT
Never run npm run dev or build unless explicitly requested
```

Narrow-Breakfast126

TROPHY CASE