Trixie

OpenSpec Workflow

Spec-driven dev: propose → apply → archive.

OpenSpec Workflow (v2026-09-30T104250Z-5e473105f4) 2026-09-30 | Spec-driven dev: propose → apply → archive. 1 - AGENT CONFIG API - Handles agent configuration agent_config_api.py _build_roots() GET /api/agent-config/... write_file() safe_join ~/.kevin/vault/agent-config-templates/ templates/*.md templates_root() vault_path() examples_includes.py IncludeResolver.__init__(base_dir) compose_template() template source resolved conte… 2 - COMPRESSION CACHE - Manages compressed cache kvgraph_format.py encode_kvg() decode_kvg() KvgFile ~/.kevin/vault/agent-config-templates/templates.kvg generated supersedes ensure_library_cache() .kvg file 3 - FRONTEND - Provides UI for templates Mona dev server AgentConfigPage.tsx showLibrary() loadLibrary() composeFor() HTTP requests GET /api/agent-config/roots POST /api/agent-config/compose GET /templates/library UI actions 1. Client requests tem… 2. API returns roots 3. Client selects temp… 4. Client composes tem… 5. API resolves includ… 6. API writes plain te… 7. Client reads compos… 8. Client views librar… Template request payload { "template_path": "templates/example.md", "target_root": "assumptions", "target_path": "assumptions/example.txt", "parameters": { "title": "Example Title", "audience": "Everyone" } } .kvg cache metadata { "generated": "2023-10-01T12:00:00Z", "supersedes": null } 19 of 20 identifiers appear only in design docs, not in code — this shows SPECIFIED behaviour, not verified implementation. The `examples_includes.py` resolver is already parameterized, so no changes are needed there. The `.kvg` cache is outside the git working tree and does not require a `.gitignore` entry. Legend actor = initiates work · process = code path · store = state on disk · bus = durable queue · dashed = separate process cyan = request flow · pink = state read/write · dashed green = pull / return path · red = refusal As of 2026-09-30 10:42 UTC, from commit 5e47310

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-09-30T104250Z
From commit
5e473105f4
Updated
30 Sep 2026, 10:42 UTC
Sources at
5e47310
Watches
1 path
  • openspec