diff --git a/config/default_workflow.yaml b/config/default_workflow.yaml
index 453283d..9398b30 100644
--- a/config/default_workflow.yaml
+++ b/config/default_workflow.yaml
@@ -1,3 +1,4 @@
+version: 0.5.0
 description: |
   Default tiki workflow. A lightweight kanban-style flow with
   Backlog → Ready → In Progress → Review → Done, plus Story / Bug / Spike / Epic task types.
diff --git a/config/loader.go b/config/loader.go
index 52bbb90..615bce1 100644
--- a/config/loader.go
+++ b/config/loader.go
@@ -21,6 +21,8 @@ var lastConfigFile string
 
 // Config holds all application configuration loaded from config.yaml
 type Config struct {
+	Version string `mapstructure:"version"`
+
 	// Logging configuration
 	Logging struct {
 		Level string `mapstructure:"level"` // "debug", "info", "warn", "error"
@@ -200,6 +202,7 @@ type viewsFileData struct {
 // kept in config package to avoid import cycle with plugin package.
 // all top-level sections must be listed here to survive round-trip serialization.
 type workflowFileData struct {
+	Version     string                   `yaml:"version,omitempty"`
 	Description string                   `yaml:"description,omitempty"`
 	Statuses    []map[string]interface{} `yaml:"statuses,omitempty"`
 	Types       []map[string]interface{} `yaml:"types,omitempty"`
diff --git a/plugin/loader.go b/plugin/loader.go
index ec7db60..544e3e2 100644
--- a/plugin/loader.go
+++ b/plugin/loader.go
@@ -13,6 +13,7 @@ import (
 
 // WorkflowFile represents the YAML structure of a workflow.yaml file
 type WorkflowFile struct {
+	Version     string             `yaml:"version,omitempty"`
 	Description string             `yaml:"description,omitempty"`
 	Views       viewsSectionConfig `yaml:"views"`
 }
diff --git a/workflows/bug-tracker/workflow.yaml b/workflows/bug-tracker/workflow.yaml
index a7531c5..b21823a 100644
--- a/workflows/bug-tracker/workflow.yaml
+++ b/workflows/bug-tracker/workflow.yaml
@@ -1,3 +1,4 @@
+version: 0.5.0
 description: |
   Bug tracker for triaging and resolving customer-reported issues.
   Six statuses (Open → Triaged → In Progress → In Review → Verified, plus Won't Fix),
diff --git a/workflows/kanban/workflow.yaml b/workflows/kanban/workflow.yaml
index 88cf366..a88ade9 100644
--- a/workflows/kanban/workflow.yaml
+++ b/workflows/kanban/workflow.yaml
@@ -1,3 +1,4 @@
+version: 0.5.0
 description: |
   Kanban-style workflow for small-team software work. Five statuses
   (Backlog → Ready → In Progress → Review → Done) and four task types
diff --git a/workflows/todo/workflow.yaml b/workflows/todo/workflow.yaml
index 74fac7d..9e522c0 100644
--- a/workflows/todo/workflow.yaml
+++ b/workflows/todo/workflow.yaml
@@ -1,3 +1,4 @@
+version: 0.5.0
 description: |
   Minimal two-lane todo list. One task type, two statuses (Todo → Done).
   Use when you just want a lightweight checklist and don't need prioritization,