thalesraymond · thalesraymond · Jun 15, 2026 · Jun 15, 2026
diff --git a/...em-and-plugin-architecture/.openspec.yaml → ...em-and-plugin-architecture/.openspec.yaml b/...em-and-plugin-architecture/.openspec.yaml → ...em-and-plugin-architecture/.openspec.yaml
diff --git a/...-system-and-plugin-architecture/design.md → ...-system-and-plugin-architecture/design.md b/...-system-and-plugin-architecture/design.md → ...-system-and-plugin-architecture/design.md
diff --git a/...ystem-and-plugin-architecture/proposal.md → ...ystem-and-plugin-architecture/proposal.md b/...ystem-and-plugin-architecture/proposal.md → ...ystem-and-plugin-architecture/proposal.md
diff --git a/...rchitecture/specs/go-event-system/spec.md → ...rchitecture/specs/go-event-system/spec.md b/...rchitecture/specs/go-event-system/spec.md → ...rchitecture/specs/go-event-system/spec.md
diff --git a/...ture/specs/go-plugin-architecture/spec.md → ...ture/specs/go-plugin-architecture/spec.md b/...ture/specs/go-plugin-architecture/spec.md → ...ture/specs/go-plugin-architecture/spec.md
diff --git a/...t-system-and-plugin-architecture/tasks.md → ...t-system-and-plugin-architecture/tasks.md b/...t-system-and-plugin-architecture/tasks.md → ...t-system-and-plugin-architecture/tasks.md
diff --git a/openspec/specs/go-event-system/spec.md b/openspec/specs/go-event-system/spec.md
@@ -0,0 +1,19 @@
+## Purpose
+
+This document specifies the event dispatching infrastructure for the Go task runner. It defines a central, asynchronous event dispatcher and strongly-typed listener interfaces that allow components to react to task lifecycle events without tight coupling.
+
+## Requirements
+
+### Requirement: Central Event Dispatcher
+The system SHALL provide a central event dispatcher to broadcast lifecycle events asynchronously.
+
+#### Scenario: Dispatching an event
+- **WHEN** the runner emits a lifecycle event (e.g., TaskStart)
+- **THEN** the dispatcher pushes the event to a buffered channel for asynchronous processing
+
+### Requirement: Interface-Based Event Listeners
+The system SHALL define strongly-typed interfaces for each lifecycle event type.
+
+#### Scenario: Defining event listeners
+- **WHEN** a new event type is needed
+- **THEN** a specific interface (e.g., `TaskStartListener`) with a typed method is provided
diff --git a/openspec/specs/go-plugin-architecture/spec.md b/openspec/specs/go-plugin-architecture/spec.md
@@ -0,0 +1,19 @@
+## Purpose
+
+This document specifies the plugin architecture for the Go task runner. It defines how external plugins are registered with the event dispatcher and how events are selectively delivered to plugins based on the listener interfaces they implement.
+
+## Requirements
+
+### Requirement: Plugin Registration
+The system SHALL allow plugins to be registered with the central event dispatcher.
+
+#### Scenario: Registering a plugin
+- **WHEN** a plugin struct is passed to the dispatcher registration function
+- **THEN** the dispatcher evaluates which listener interfaces the plugin implements and registers it for those specific events
+
+### Requirement: Event Delivery to Plugins
+The system SHALL deliver events only to plugins that have implemented the corresponding listener interface.
+
+#### Scenario: Delivering TaskStart event
+- **WHEN** a TaskStart event is broadcast
+- **THEN** only plugins implementing `TaskStartListener` have their `OnTaskStart` method called with the event payload