I was using Claude Code wrong — here's the workflow that fixed it

Short summary

The author improved their Claude Code usage by adopting spec-first development (opsx): write detailed change proposals with specifications, design, and task lists before implementation. This enforces separation between management plane (Jira tasks) and governance plane (reviewed OpenSpec), ensuring design decisions are explicit, traceable, and authorized before coding starts. The opsx toolkit provides scaffolding and guided commands for this workflow.

• •Spec-first workflow prevents silent design decisions buried in code commits
• •Separates management plane (Jira) from governance plane (OpenSpec) to authorize changes
• •opsx tool provides CLI scaffolding and guided commands for multiple agent platforms

Generated with AI, which can make mistakes.