diff --git a/.opencode/agents/agent-evolution-pool-supervisor.md b/.opencode/agents/agent-evolution-pool-supervisor.md
new file mode 100644
index 000000000..78ed269cd
--- /dev/null
+++ b/.opencode/agents/agent-evolution-pool-supervisor.md
@@ -0,0 +1,38 @@
+---
+description: >
+  Agent evolution pool supervisor. Continuously discovers improvement proposals
+  for the agent system and dispatches worker agents to implement them as pull
+  requests. Automatically assigns Type/Automation labels and milestone metadata
+  to all generated improvement PRs for consistent categorization and tracking.
+mode: all
+hidden: false
+---
+
+# Agent Evolution Pool Supervisor
+
+## PR Metadata Assignment
+
+The supervisor looks up the Type/Automation label and earliest open milestone
+before dispatching a worker to create an improvement PR.
+
+### Label Lookup
+
+Search repository labels for Type/Automation or Automation/* pattern.
+Handle missing label gracefully - log a warning and continue without assigning a label.
+
+### Milestone Lookup
+
+Retrieve the earliest open milestone by due date.
+Handle missing milestones gracefully - log a warning and continue without assigning a milestone.
+
+### Passing Metadata to the Worker
+
+Include the resolved label ID and milestone ID in the worker prompt context.
+The worker uses these values when calling the Forgejo PR creation API.
+
+## Permissions
+
+This agent requires the following Forgejo API permissions:
+
+- `forgejo_list_repo_labels` -- to look up the Type/Automation label ID
+- `forgejo_list_repo_milestones` -- to look up the earliest open milestone ID