cal/claude-memory
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
614cd3688d
claude-memory/graph/decisions/issue-worker-agent-phased-workflow-architecture-45c219.md

2.4 KiB
Raw Blame History

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:19:31.681317+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

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