Engineering
opsx avatar

opsx

A specification-driven workflow management system for structured development lifecycle management, covering proposal, planning, implementation, and archival phases.

Introduction

OpsX is a specialized lifecycle management tool designed for teams practicing specification-driven development. It integrates directly into the software development workflow by enforcing a standardized process from the initial change proposal to the final archival of implementation artifacts. By utilizing a structured directory format, it ensures that every task—whether a small security fix or a large feature addition—remains trackable, well-documented, and aligned with project requirements. The tool allows developers and AI agents to move seamlessly between phases, ensuring that code changes are never implemented without a corresponding specification and implementation plan.

  • Standardized lifecycle phases including Onboard, New, Fast-Forward (planning generation), Apply (execution), and Archive.

  • Automated generation of comprehensive documentation such as proposal.md, specification.md, plan.md, and tasks.md.

  • Versioned change tracking within the .openspec directory, maintaining a clean separation between active development and historical records.

  • Integration with AI orchestrators like Wave, enabling autonomous or semi-autonomous development pipelines.

  • Support for both full lifecycle management for complex features and expedited flows for urgent security or bug fixes.

  • Usage typically follows a sequence of commands: initialize with opsx.onboard, propose with opsx.new, plan with opsx.ff, implement with opsx.apply, and conclude with opsx.archive.

  • Requires local git configuration to track changes in the .openspec directory structure effectively.

  • Acts as a contract-validated handoff layer; ensure that requirements are clearly defined in the proposal phase to minimize implementation friction.

  • Use the provided references/full-reference.md for advanced command patterns and configuration customization.

  • Designed for environments where traceability and audit trails are critical for compliance and maintainability.

Repository Stats

Stars
15
Forks
2
Open Issues
253
Language
Go
Default Branch
main
Sync Status
Idle
Last Synced
May 3, 2026, 07:59 PM
View on GitHub