CapaKraken/.agents/sprints/widget-field-refactor/README.md

Widget + Field Refactor Sprint Agent Pack

This folder contains the sprint-specific agent briefs for the widget-platform, field-management, and dashboard-query refactor.

Source plan: docs/refactor-sprint-plan.md

Team

• O1-orchestrator.md
• A1-architect.md
• C1-field-domain-coder.md
• C2-blueprint-ui-coder.md
• C3-widget-platform-coder.md
• C4-dashboard-data-coder.md
• T1-test-agent.md
• R1-reviewer.md

Startup Order

1. Start O1.
2. Start A1.
3. Wait for contract approval.
4. Start C1, C3, and T1.
5. Start C2 after field contract is stable.
6. Start C4 once router/application boundaries are agreed.
7. Keep R1 reviewing every merge candidate.

Hard Rule

The orchestrator never implements. O1 may inspect, sequence, assign, review, and accept or reject work. O1 must not patch files, write code, add tests, or fix lint/type issues directly.

Merge Order

1. Shared contracts
2. Shared/application helpers
3. API integration
4. UI integration
5. Tests
6. Final review

Shared Handoff Format

Every agent handoff should include:

• summary
• changed_files
• acceptance_met
• tests
• open_risks
• next_agent

Shared Sprint Stories

• S1 Canonical field-definition contract
• S2 Shared dynamic-field validation and filter path
• S3 Typed widget config and layout versioning
• S4 Widget platform refactor
• S5 Dashboard query refactor groundwork