diff --git a/.gitea/ISSUE_TEMPLATE/agent_task.md b/.gitea/ISSUE_TEMPLATE/agent_task.md
new file mode 100644
index 00000000..647a6dca
--- /dev/null
+++ b/.gitea/ISSUE_TEMPLATE/agent_task.md
@@ -0,0 +1,40 @@
+---
+name: Agent Task
+about: A structured task for autonomous agents
+title: ""
+labels: ""
+assignees: ""
+---
+
+## Task
+Short description of the task.
+
+## Context
+Explain why the task is needed.
+Include links to related issues, PRs, or files.
+
+## Expected Result
+Describe what should exist after the task is completed.
+
+## Files Likely Affected
+List directories or files that will probably change.
+
+## Suggested Implementation
+Outline a possible approach or algorithm.
+
+## Difficulty
+- [ ] easy
+- [ ] medium
+- [ ] hard
+
+## Priority
+- [ ] low
+- [ ] normal
+- [ ] high
+
+## Labels
+- [ ] bug
+- [ ] feature
+- [ ] refactor
+- [ ] infra
+- [ ] documentation