Appearance
Service Agent Next Slice Spawn Packets
Status: next-slice-prompt-catalog-not-completion-proof.
Source path: docs/agents/service-agent-next-slice-spawn-packets.md. Machine-readable source: docs/agents/service-agent-next-slice-queue.json.
Use this page after the first service-agent handoff for a row has been accepted. It turns the next-slice queue into prompt-ready packet fields. It is not completion proof and does not approve default route promotion.
Use this catalog with:
docs/agents/service-agent-next-slice-queue.jsondocs/agents/service-agent-next-slice-queue.mddocs/agents/service-agent-proof-ledger.jsondocs/agents/service-agent-closeout-ledger.jsondocs/agents/service-agent-next-slice-closeout-ledger.jsondocs/agents/service-agent-spawn-runbook.mddocs/agents/service-agent-spawn-packets.mddocs/agents/agent-handoff-format.md
Packet Rules
- Use the exact
nextTaskIdfromdocs/agents/service-agent-next-slice-queue.json. - Include the row's
openProofGatein the worker prompt. - Include the accepted first-slice handoff path so the worker starts from the current evidence, not from the original first slice.
- Include
workflowVerification,requiredNextHandoffPath,proofPack,prerequisites,blockedActions, andparallelismLockfrom the JSON row. - Require audit, investigate, code, test, and fix evidence in the handoff.
- Keep frontend callers behind
api-gatewayor an approved BFF. - Keep default gateway routes legacy unless the task explicitly produces route proof, browser/runtime proof, and rollback evidence.
- Do not spawn
auth-service; identity and access work routes toiam-service. RET-USERis retirement-only; no new product work belongs inservices/user-service.- A returned next-slice handoff is accepted through
docs/agents/service-agent-next-slice-closeout-ledger.json, not by replacing the first-slice handoff inservice-agent-closeout-ledger.json.
Base Next-Slice Prompt
txt
You own <canonical-service> for the next bounded proof-gate slice in go-platform.
Task ID: <nextTaskId> from docs/agents/service-agent-next-slice-queue.json.
Queue source: docs/agents/service-agent-next-slice-queue.json.
Required handoff path: <requiredNextHandoffPath>.
Proof pack: <proofPack>.
Read first:
- docs/architecture/service-responsibility-matrix.md
- docs/agents/service-agent-manifest.json
- docs/agents/service-agent-proof-ledger.json
- docs/agents/service-agent-closeout-ledger.json
- docs/agents/service-agent-execution-queue.json
- docs/agents/service-agent-next-slice-queue.json
- docs/agents/service-agent-accepted-handoffs.md
- docs/agents/service-agent-next-slice-closeout-ledger.json
- docs/agents/service-agent-next-slice-closeout-ledger.md
- docs/agents/service-agent-spawn-runbook.md
- docs/agents/service-agent-spawn-packets.md
- docs/agents/service-agent-next-slice-spawn-packets.md
- docs/agents/agent-handoff-format.md
- <taskPack>
- <acceptedHandoff>
- legacy evidence cited by <taskPack>
Ownership:
- Writable implementation scope: <implementationOwner>
- Writable docs/contracts scope: <taskPack writable files only>
- Orchestrator-owned files stay read-only unless this task explicitly delegates them.
- Parallelism lock: <parallelismLock>.
Rules:
- You are not alone in the codebase. Do not revert unrelated worktree changes.
- Keep frontend callers behind api-gateway or an approved BFF.
- Do not create alias directories or an auth-service/user-service boundary.
- Keep default gateway routes legacy unless this task's proof gate explicitly requires
route proof, browser/runtime proof, and rollback evidence.
- The open proof gate is: <openProofGate>
- Required prerequisites: <prerequisites>
- Blocked actions: <blockedActions>
- Route/default state: <routeDefaultState>
Deliver:
- Task ID and handoff title using docs/agents/agent-handoff-format.md.
- Handoff file at <requiredNextHandoffPath>.
- Docs read and legacy files read.
- Files changed.
- Behavior implemented.
- Focused tests plus every command in <workflowVerification>.
- Evidence for every requiredEvidence item.
- Route/default cutover status and rollback notes.
- Remaining risks and next recommended task.1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
Next-Slice Packets
| Dispatch ID | Service | Next task ID | Implementation owner | Task pack | First verification |
|---|---|---|---|---|---|
| SVC-001 | api-gateway | SVC-001-default-route-proof-bundle | services/api-gateway | docs/agents/service-tasks/api-gateway.md | GOTOOLCHAIN=go1.25.11 go test ./services/api-gateway/... |
| SVC-002 | bff-service | SVC-002-owner-source-gateway-proof | services/bff-service | docs/agents/service-tasks/bff-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/bff-service/... |
| SVC-003 | iam-service | SVC-003-default-auth-cutover-proof-bundle | services/iam-service | docs/agents/service-tasks/iam-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/iam-service/... |
| SVC-004 | profile-service | SVC-004-default-profile-cutover-proof-bundle | services/profile-service | docs/agents/service-tasks/profile-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/profile-service/... |
| SVC-005 | organization-service | SVC-005-iam-membership-school-sync-proof | services/school-service | docs/agents/service-tasks/organization-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/school-service/... |
| SVC-006 | classroom-service | SVC-006-public-route-guard-proof | services/classroom-service | docs/agents/service-tasks/classroom-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/classroom-service/... |
| SVC-007 | course-service | SVC-007-student-course-route-proof | services/course-service | docs/agents/service-tasks/course-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/course-service/... |
| SVC-008 | question-service | SVC-008-question-save-reload-route-proof | services/question-bank-service | docs/agents/service-tasks/question-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/question-bank-service/... |
| SVC-009 | exam-service | SVC-009-exam-attempt-public-proof | services/exam-service | docs/agents/service-tasks/exam-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/exam-service/... |
| SVC-010 | attempt-service | SVC-010-attempt-public-idempotency-proof | services/attempt-service | docs/agents/service-tasks/attempt-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/attempt-service/... |
| SVC-011 | file-service | SVC-011-storage-media-browser-proof | services/document-service | docs/agents/service-tasks/file-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/document-service/... |
| SVC-012 | import-service | SVC-012-import-route-proof-bundle | services/docx-import-service | docs/agents/service-tasks/import-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/docx-import-service/... |
| SVC-013 | formula-docx-service | SVC-013-formula-adapter-determinism-proof | runtimes/go-formula-docx | docs/agents/service-tasks/formula-docx-service.md | sh scripts/test/go-formula-runtime-coverage.sh |
| SVC-014 | search-service | SVC-014-search-legacy-owner-rebuild-proof | services/search-service | docs/agents/service-tasks/search-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/search-service/... -count=1 |
| SVC-015 | ai-service | SVC-015-ai-usage-wallet-route-proof | services/ai-classifier-service | docs/agents/service-tasks/ai-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/ai-classifier-service/... |
| SVC-016 | billing-service | SVC-016-subscription-entitlement-replay-proof | services/billing-service | docs/agents/service-tasks/billing-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/billing-service/... |
| SVC-017 | wallet-service | SVC-017-wallet-ledger-route-proof | services/wallet-service | docs/agents/service-tasks/wallet-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/wallet-service/... |
| SVC-018 | usage-service | SVC-018-usage-billing-sync-replay-proof | services/usage-service | docs/agents/service-tasks/usage-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/usage-service/... |
| SVC-019 | payment-service | SVC-019-payment-webhook-reconcile-proof | services/payment-service | docs/agents/service-tasks/payment-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/payment-service/... |
| SVC-020 | notification-service | SVC-020-notification-recipient-route-proof | services/notification-service | docs/agents/service-tasks/notification-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/notification-service/... |
| SVC-021 | audit-service | SVC-021-audit-replay-retention-proof | services/audit-service | docs/agents/service-tasks/audit-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/audit-service/... |
| SVC-022 | analytics-service | SVC-022-analytics-rebuildable-projection-proof | services/analytics-service | docs/agents/service-tasks/analytics-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/analytics-service/... |
| SVC-023 | admin-service | SVC-023-admin-owner-source-route-proof | services/admin-service | docs/agents/service-tasks/admin-service.md | GOTOOLCHAIN=go1.25.11 go test ./services/admin-service/... |
| RET-USER | user-service retirement | RET-USER-retirement-readiness-proof | services/user-service | docs/agents/service-tasks/user-service-retirement.md | GOTOOLCHAIN=go1.25.11 go test ./services/user-service/... |
Required Next Handoffs
| Task ID | Required handoff path |
|---|---|
SVC-001-default-route-proof-bundle | docs/agents/handoffs/SVC-001-default-route-proof-bundle.md |
SVC-002-owner-source-gateway-proof | docs/agents/handoffs/SVC-002-owner-source-gateway-proof.md |
SVC-003-default-auth-cutover-proof-bundle | docs/agents/handoffs/SVC-003-default-auth-cutover-proof-bundle.md |
SVC-004-default-profile-cutover-proof-bundle | docs/agents/handoffs/SVC-004-default-profile-cutover-proof-bundle.md |
SVC-005-iam-membership-school-sync-proof | docs/agents/handoffs/SVC-005-iam-membership-school-sync-proof.md |
SVC-006-public-route-guard-proof | docs/agents/handoffs/SVC-006-public-route-guard-proof.md |
SVC-007-student-course-route-proof | docs/agents/handoffs/SVC-007-student-course-route-proof.md |
SVC-008-question-save-reload-route-proof | docs/agents/handoffs/SVC-008-question-save-reload-route-proof.md |
SVC-009-exam-attempt-public-proof | docs/agents/handoffs/SVC-009-exam-attempt-public-proof.md |
SVC-010-attempt-public-idempotency-proof | docs/agents/handoffs/SVC-010-attempt-public-idempotency-proof.md |
SVC-011-storage-media-browser-proof | docs/agents/handoffs/SVC-011-storage-media-browser-proof.md |
SVC-012-import-route-proof-bundle | docs/agents/handoffs/SVC-012-import-route-proof-bundle.md |
SVC-013-formula-adapter-determinism-proof | docs/agents/handoffs/SVC-013-formula-adapter-determinism-proof.md |
SVC-014-search-legacy-owner-rebuild-proof | docs/agents/handoffs/SVC-014-search-legacy-owner-rebuild-proof.md |
SVC-015-ai-usage-wallet-route-proof | docs/agents/handoffs/SVC-015-ai-usage-wallet-route-proof.md |
SVC-016-subscription-entitlement-replay-proof | docs/agents/handoffs/SVC-016-subscription-entitlement-replay-proof.md |
SVC-017-wallet-ledger-route-proof | docs/agents/handoffs/SVC-017-wallet-ledger-route-proof.md |
SVC-018-usage-billing-sync-replay-proof | docs/agents/handoffs/SVC-018-usage-billing-sync-replay-proof.md |
SVC-019-payment-webhook-reconcile-proof | docs/agents/handoffs/SVC-019-payment-webhook-reconcile-proof.md |
SVC-020-notification-recipient-route-proof | docs/agents/handoffs/SVC-020-notification-recipient-route-proof.md |
SVC-021-audit-replay-retention-proof | docs/agents/handoffs/SVC-021-audit-replay-retention-proof.md |
SVC-022-analytics-rebuildable-projection-proof | docs/agents/handoffs/SVC-022-analytics-rebuildable-projection-proof.md |
SVC-023-admin-owner-source-route-proof | docs/agents/handoffs/SVC-023-admin-owner-source-route-proof.md |
RET-USER-retirement-readiness-proof | docs/agents/handoffs/RET-USER-retirement-readiness-proof.md |
Cutover-Sensitive Packets
| Row | Required extra handling |
|---|---|
SVC-003 iam-service | Use docs/agents/service-tasks/iam-profile-default-cutover-proof.md; do not claim default auth promotion until production-like target provenance, migrator run report, candidate review, browser proof, and rollback-after-candidate proof exist. |
SVC-004 profile-service | Keep password, JWT, role, permission, payment, and quota state out of profile-service; default promotion needs profile candidate diff, browser proof, and rollback-after-candidate proof. |
RET-USER user-service retirement | Retirement is allowed only after IAM/Profile parity and default-route rollback evidence; no new product work belongs in services/user-service. |
Completion Boundary
These packets are dispatch inputs only. A row remains not-complete until the next-slice worker produces an accepted handoff with concrete test output, route/default state, rollback notes, and evidence for the row's current open proof gate.