Summary

This pull request introduces comprehensive documentation for the experimental OPSX workflow commands and their corresponding Claude skills, covering the full lifecycle of proposing, exploring, applying, and archiving OpenSpec changes. The new markdown files provide step-by-step guidance, guardrails, and output examples for each workflow phase, ensuring clarity for both users and automation.

The most important changes are:

OPSX Workflow Command Documentation:

• Added .claude/commands/opsx/propose.md to document how to propose a new change, including artefact creation, dependency management, and user prompts for unclear requirements.
• Added .claude/commands/opsx/apply.md detailing the process for implementing tasks from an OpenSpec change, including task selection, progress tracking, and handling blockers or completion.
• Added .claude/commands/opsx/archive.md describing how to archive a completed change, with checks for incomplete artefacts or tasks, delta spec synchronisation, and user confirmations.
• Added .claude/commands/opsx/explore.md to define "explore mode," focusing on investigation, brainstorming, and requirements clarification without implementation, including OpenSpec artefact awareness and guardrails.

Claude Skill Integration:

• Added .claude/skills/openspec-apply-change/SKILL.md to specify the behaviour and guardrails for the openspec-apply-change skill, closely mirroring the documented workflow for applying OpenSpec changes.

Linked issue

N/A

Changes

• Adds openspec implementation

Checklist

• Tests added or updated (or N/A with reason)
• Docs / types updated if public API changed (index.d.ts and index.d.cts)
• No breaking changes (or called out explicitly above)

Summary by cubic

Adds an experimental openspec workflow with OPSX commands and skills to propose, explore, apply, and archive changes, plus a spec-driven openspec/config.yaml with project context and rules. Also stops ignoring .claude, .opencode, and openspec/ so the workflow assets are tracked.

Description

• Summary of changes

  • Adds OPSX command guides under .claude/commands/opsx/* and .opencode/commands/* for propose, explore, apply, and archive.
  • Adds matching skills under .claude/skills/* and .opencode/skills/*.
  • Adds openspec/config.yaml (schema: spec-driven) with project context, rules, and artifact guidance tailored to axios.
  • Updates .gitignore to include .claude/, .opencode/, and openspec/.

• Reasoning

  • Establishes a clear, guarded change lifecycle that tools can follow.
  • Provides consistent artifacts and task flow driven by the openspec CLI.
  • Ensures repo tracks the workflow assets for collaboration and review.

• Additional context

  • Files are mirrored under both .claude and .opencode to support different runtimes.
  • Commands rely on the openspec CLI JSON outputs for status/instructions.

Docs

• Add a new docs page in /docs/ covering:
  • Quickstart for the openspec workflow (propose → explore → apply → archive).
  • Command/skill cheat sheet with minimal examples.
  • Notes on the spec-driven schema and how openspec/config.yaml shapes artifacts and rules.

Testing

• No unit tests added.
• Suggested checks:
  • Run openspec new change, openspec status --json, and openspec instructions <artifact|apply> --json to validate paths, dependencies, and contextFiles.
  • Dry-run the command flows (propose → apply → archive) and confirm task checkbox updates and archive naming.
  • Verify .gitignore now tracks .claude/, .opencode/, and openspec/.

Semantic version impact

• Patch: documentation, config, and workflow assets only; no runtime or API changes.

^{Written for commit 8b494ee. Summary will update on new commits. Review in cubic}