How does the OpenSec workflow integrate with the requirements documentation produced by product teams?

[breezern]

Based on the practical examples currently available online, the standard workflow typically begins with a proposal, followed by the generation of spec, design, and task documents, and finally, the implementation phase. For individual developers, this approach is ideal. However, what about team-based development? In a team environment, the product team typically produces a detailed Requirements Specification—often in .docx format; the development team then proceeds to build the product based on this document. Given this scenario, how can a document formatted as a Requirements Specification be effectively converted into the "spec" format required by the OpenSec workflow?

[B2F]

First you'd convert your docx in something your LLM can read (if not already compatible), then you go through explore and proposal phase to translate it into openspec specs ?

If you mean to have the document as a single source of truth, that's not how it works. You need to build a proposal. I guess that could be automated on every docx update, but without supervision I wouldn't trust it. Yeah sure why not building a pipeline with an event triggered on docx update so that an agent is prompted to explore and build proposal. Doable, but I doubt that it would be useful ?

If you're in a human team environment, don't you have a proper Jira, Redmine or such to manage the team / tasks ? Everyone can build their own openspec proposal from there. A proper coding LLM + coding agent doesn't really need the whole baseline, they will read the context on the fly. What really matters is your current perimeter definition, and pairing OpenSpec with an agentic coding tool really could at building those spec proposals so that your current task does what it is supposed to be.

Don't forget that the first step in openspec workflow is the opsx explore command, to make sure your perimeter is clear. If you're afraid about regressions, that's what automated tests are for.