# 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