claude-memory/graph/decisions/issue-worker-agent-phased-workflow-architecture-45c219.md

id	type	title	tags	importance	confidence	created	updated	relations
45c21973-7fae-4cf7-b247-b40a757d54b0	decision	Issue Worker Agent: Phased Workflow Architecture	claude-configs issue-worker agent-design gitea automation workflow cognitive-memory	0.7	0.8	2026-03-02T20:19:30.456720+00:00	2026-03-02T20:20:08.207657+00:00	target type direction strength edge_id b27fb831-811e-4103-b5f1-3c36d5b1ad20 RELATED_TO outgoing 0.9 a1813354-3f35-46b8-9689-9d259413bf6e target type direction strength edge_id 73646e80-a640-4316-b7c6-54a4330f1b28 RELATED_TO outgoing 0.87 c078c5fc-c046-411b-8807-d52f1a4c399f target type direction strength edge_id 1052e91d-58ed-4308-87e8-e01d1143a146 RELATED_TO outgoing 0.77 21f44795-4134-4ebf-b242-0d233ab82a17 target type direction strength edge_id 4321bee8-105e-4fc8-b645-964d1234c966 BUILDS_ON outgoing 0.95 0924ac34-ddaa-4eba-ad0f-743077be7354 target type direction strength edge_id c4b2f42d-b443-447f-8a05-bba099e06036 RELATED_TO outgoing 0.9 6b20858b-0402-4dfb-ae93-6cf4a0afb86d target type direction strength edge_id d326094f-63eb-4b42-8aa6-f2d53d6f2628 REQUIRES outgoing 0.85 89529f58-d709-46e1-bbdd-c0636ee41b21 target type direction strength edge_id 6ce2055a-b51b-45e4-8ff0-d34b385f7552 RELATED_TO outgoing 0.7 6f390811-ecf9-4a2a-a28c-849d585fe9a6

Issue Worker Agent: Phased Workflow Architecture

Context

Rewrote the issue-worker agent at ~/.claude/agents/issue-worker.md from a flat 10-step workflow into 4 distinct phases. Config synced to Gitea at commit a62f16d.

Architecture

Phase 1: Understand

• Read issue from Gitea
• Explicitly read CLAUDE.md before any code work
• Assess feasibility
• Add status/in-progress label to issue

Phase 2: Implement

• Explore relevant code
• Create branch using -B flag for retry safety
• Implement fix
• Run tests with auto-discovery: CLAUDE.md → Makefile → pyproject.toml → package.json → Cargo.toml

Phase 3: Review & Ship

• Self-review via git diff before committing (avoids needing a second cleanup commit)
• Commit and push
• Create PR via gitea-mcp
• Swap labels: remove status/in-progress, add status/pr-open
• Comment on original issue with PR link

Phase 4: Remember

• Store cognitive memory of fix with proper tags
• Create graph edges to related memories using memory_relate

Key Decisions

Branch Naming

• Changed from ai/<repo>#<issue_number> to ai/<repo>-<issue_number>
• Reason: # causes shell interpretation issues and URL encoding problems

MCP Tools Added

• edit_issue — for swapping labels during phase transitions
• memory_search — for finding related existing memories in Phase 4
• memory_relate — for creating graph edges in Phase 4

Self-Review Placement

• git diff review placed before commit, not after
• Avoids needing a follow-up fixup commit for issues caught post-commit