[Backlog] TI-7 — Federação de sinais

[sraphaz]

Item de backlog (sync-backlog)

Id: TI-7
Documento: docs/backlog-api/TI7.md

---

[github-actions]

Agente acionado: Backend Agent

ID: backend | Quando: 2026-07-27T07:24:06Z UTC | Gatilho: issues:labeled
Workflow: 30245998232

Verificações automáticas de conduta

✅ Guardrail no_merge
✅ Guardrail require_ci (opcional por agente)
✅ Checklist de conduta (checklists/backend.checklist.md)
✅ Escopo de paths respeitado

Conduta compartilhada

Conduta comum (todos os agentes)

• Merge humano — nunca mergear em main sem aprovação explícita
• Escopo mínimo — alterar apenas paths permitidos no manifest
• Sem secrets — nada de tokens, senhas ou chaves no diff
• PR obrigatório — todo código via branch + Pull Request
• CI verde — gates passam antes de pedir review
• Bots resolvidos — apontamentos de CodeRabbit/Dependabot tratados (PR Steward)
• Doc-sync — sync-docs no mesmo PR quando código mudar comportamento documentado

Checklist do agente

Backend Agent — Checklist de conduta

Escopo permitido

• Alterações em backend/Arah.*, backend/Tests/** (inclui Arah.Core)
• Sem mudanças em Flutter, wiki ou docs fora de sync-docs / spec

SDD (fases S0+)

• PR inclui Spec-Id: <id> ou spec atualizada em docs/specs/
• Clarify antes de implementar: ambiguidades da spec listadas e resolvidas (não adivinhar intenção)
• ./scripts/agents/arah-agents.ps1 spec-validate passa
• Critérios acceptance cobertos: status: covered exige covered_by anotado (dotnet test --filter FullyQualifiedName~Core se Core); status: manual exige evidence

Antes do PR

• dotnet build e dotnet test passam localmente ou via CI
• Clean Architecture respeitada (Domain não depende de Infrastructure)
• Nomenclatura: territory, items, membership (nunca place/listings)
• Territory sem lógica social embutida
• BFF: jornada registrada em BffJourneyRegistry se aplicável
• sync-docs quando contrato API ou regra de negócio mudou

Skills (ordem sugerida)

1. run-tests (area backend)
2. spec-validate / harness-run (se fase S0+ ou Arah.Core)
3. register-bff-journey (se BFF alterado)
4. sync-docs
5. open-pr

Consultar quando Core/federação

• Domain control-plane + specialist core-control-plane

Proibido

• Commit direto em main
• Araponga.* namespaces ou Araponga.sln
• Lógica HTTP em Application/Domain

Skills sugeridas (ordem)

1. run-tests
2. register-bff-journey
3. sync-docs
4. spec-validate
5. harness-run
6. open-pr
7. code-review
8. craft-review

Manifest

.agents/backend.agent.yaml

---

Visível via agents.yml — artifact agent-activity.json. Merge continua humano.

[github-actions]

Orquestrador Arah

Agente: backend — Backend Agent
Manifest: .agents/backend.agent.yaml
Skills sugeridas: run-tests, register-bff-journey, sync-docs, spec-validate, harness-run, open-pr, code-review, craft-review
Delegate to agent 'backend' (Backend Agent). Read AGENTS.md and apply skills from .skills/.

Automático via agents.yml. Merge continua humano. Ver AGENTS.md.