Trixie

OpenSpec Workflow

Spec-driven dev: propose → apply → archive.

OpenSpec Spec-Driven Development (v2026-08-02T101544Z-ab2bbdebf5) 2026-08-01 | openspec/config.yaml -- propose / review / implement / archive pipeline Developer Claude / AG / Orion /opsx:propose openspec propose "desc" reads openspec/config.yaml KAN ticket reserved first openspec/changes/ proposal.md + design.md tasks.md (per feature) openspec/config.yaml project context + rules proposal / tasks / design Review Phase read proposal.md openspec validate adjust before coding /opsx:apply reads tasks.md checklist Claude implements tasks max 2h chunks each Agent Execution Claude (architecture) AG (firmware/flash) Ollama (boilerplate) Codebase feature branch conventional commits /opsx:archive merges changes/ deltas into openspec/specs/ cleans changes/ dir openspec/specs/ persistent spec truth merged per feature honest count: 0 of 29 changes/ ever archived here (2026-08-01) Holon Deposit docs/holons/ required_skills frontmatter for major features openspec view interactive TUI all specs + changes Backlog KAN Ticket backlog/.next-kan reserve BEFORE propose 1 /opsx:propose "feature" 2 generate artifacts reads rules proposal.md ready 3 openspec validate 4 execute tasks 5 write code openspec view 6 /opsx:archive 7 merge to specs/ deposit holon if major reserve KAN before propose Sequence 1 Reserve KAN ticket from backlog/.next-kan BEFORE proposing. Put ticket number in proposal. 2 Run /opsx:propose "feature description". OpenSpec reads config.yaml context + rules to generate proposal.md, design.md, tasks.md. 3 Review artifacts. Run openspec validate (exits non-zero to block implementation if spec is incomplete). 4-5 Run /opsx:apply. Claude reads tasks.md checklist; each task max 2h; firmware tasks include bump-flash-confirm cycle. 6 Execution routes to correct agent: Claude for architecture/daemon, AG for firmware/flash, Ollama for boilerplate. 7 /opsx:archive merges spec deltas into openspec/specs/ (persistent truth) and cleans openspec/changes/ workspace. openspec/config.yaml (rules excerpt) proposal: - Under 400 words - Include Non-goals section - Reference KAN ticket number tasks.md chunk (agent-config-template-library) - [x] 2.1 Add `templates` root to _build_roots() in agent_config_api.py - [x] 6.6 .kvg cache regenerates after deletion, no data loss (8/8 tests pass) Holon frontmatter (docs/holons/outbox/, real example) holon_id: 1784513686.22664-render-openspec-workflow character: diagram-bot action_type: render-diagram required_skills: [svg-dataflow, kevin-design-system]

Provenance

This drawing is generated, not drawn. It is rebuilt from the source files below, so when they change the picture changes — a diagram here cannot quietly describe a system that no longer works this way.

Owner
Trixie
Slug
openspec-workflow
Rendered
2026-08-02T101544Z
From commit
ab2bbdebf5
Watches
1 path
  • openspec