Add Gitea issue workflow documentation

AGENTS.md

@@ -1,6 +1,22 @@
 # Agent Instructions
 
-This project uses **bd** (beads) for issue tracking. Run `bd onboard` to get started.
+This project uses **bd** (beads) for issue tracking and **Gitea** for external issue tracking.
+
+## Gitea Issues Workflow
+
+When asked to work on Gitea issues:
+1. Read issue via API: `curl -s "https://gitea.calmcacil.dev/api/v1/repos/{owner}/{repo}/issues/{number}"`
+2. Analyze requirements and scope
+3. Create task list with `todowrite` for multi-step work
+4. Implement fix following existing patterns
+5. Commit with `Closes #{number}` in message (auto-closes issue)
+6. Push to remote
+
+See `GITEA_ISSUES.md` for detailed workflow.
+
+## Beads Workflow
+
+Run `bd onboard` to get started with beads.
 
 ## Quick Reference
 

GITEA_ISSUES.md

@@ -0,0 +1,60 @@
+# Gitea Issue Workflow
+
+## Process for Working with Gitea Issues
+
+### 1. Read Issue
+```bash
+# Get all issues
+curl -s "https://gitea.calmcacil.dev/api/v1/repos/{owner}/{repo}/issues?state=open" | jq '.'
+
+# Get specific issue
+curl -s "https://gitea.calmcacil.dev/api/v1/repos/{owner}/{repo}/issues/{number}" | jq '.'
+```
+
+### 2. Analyze Issue
+- Read title and body
+- Check labels, assignee, milestone
+- Identify blocking dependencies
+- Determine if actionable
+
+### 3. Create Task List
+- Use `todowrite` for multi-step issues
+- Break down into actionable steps
+- Mark first step `in_progress`
+
+### 4. Implement Fix
+- Follow existing code patterns
+- Make minimal changes
+- Update relevant documentation
+
+### 5. Verify Fix
+- Run any available tests
+- Manual verification of functionality
+- Check for side effects
+
+### 6. Commit Changes
+```bash
+git add -A
+git commit -m "Brief description
+
+Details about what was fixed.
+
+Closes #{issue_number}"
+```
+
+### 7. Push and Close
+```bash
+bd sync
+git push
+```
+
+The `Closes #{issue_number}` in commit message will automatically close the issue via Gitea API.
+
+## Guidelines
+
+- Always read the full issue before starting work
+- If issue is unclear, ask for clarification
+- Create todos for 2+ step tasks
+- Reference issue in commit message with `Closes #`
+- Verify the fix actually resolves the issue
+- Update documentation if behavior changes