claude-memory/graph/decisions/retrosheet-card-update-agent-definition-created-8a2f30.md
Cal Corum 34bb613c57 Add 20 retroactive edges and sync pending memory updates
- 20 new high-quality edges across 8 project clusters
- Edge types: BUILDS_ON, RELATED_TO, ALTERNATIVE_TO, REQUIRES
- Updated relation metadata on connected memories
- New episode entries and memory files from recent sessions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 23:34:07 -06:00

31 lines
1.9 KiB
Markdown

---
id: 8a2f30f0-137d-4390-9252-22c4eb565046
type: decision
title: "Retrosheet card update agent definition created"
tags: [paper-dynasty, claude-code, agents, architecture]
importance: 0.7
confidence: 0.8
created: "2026-02-16T19:34:19.383497+00:00"
updated: "2026-02-20T04:32:07.169669+00:00"
relations:
- target: 9e1897e8-a5ec-4297-ba85-941dcfe304b9
type: ALTERNATIVE_TO
direction: incoming
strength: 0.9
edge_id: 5c874e03-7119-4747-87bc-dff11e08328c
---
Created .claude/agents/retrosheet-card-update-agent.md for Paper Dynasty card-creation project. Key design decisions:
1. **Minimal tool set**: Bash, Read, Grep, Glob, AskUserQuestion only — no Edit/Write. Agent is a pipeline executor, not a coder.
2. **Sonnet model**: Sequential CLI execution doesn't need heavy reasoning.
3. **8-step pipeline with validation gates**: dry-run → generate cards → validate positions → render images → validate groundball_b → S3 upload → scouting all → scouting upload.
4. **Environment verification**: Reads db_calls.py alt_database before executing, refuses to proceed if mismatch. Does NOT modify the file.
5. **Pre-flight parameter table**: Year, Cardset ID, Description, Start/End dates, Season %, Environment, Cardset name. Asks user for missing params via AskUserQuestion.
6. **Critical guardrails**: groundball_b validation is hardcoded as Step 5 with STOP gate. Scouting always runs for ALL cardsets (no --cardset-id filter).
7. **Structured report output**: Pass/fail for each step with counts.
File location: /mnt/NV2/Development/paper-dynasty/card-creation/.claude/agents/retrosheet-card-update-agent.md
Discovery issue: Custom agents from .claude/agents/ are only discovered at Claude Code startup — must restart session after creating new agent files. Agent name in frontmatter (retrosheet-card-update) must match the subagent_type used in Task tool calls.