[Epic] FASE61 — Capital Territorial

[sraphaz]

Épico de fase (sync-backlog)

Fase: FASE61
Prioridade: P2
Onda: S4
Depende de: FASE55, FASE56
Documento: docs/backlog-api/FASE61.md
Spec SDD pendente — usar spec-author.

Intenção

Implementar FASE61 — Capital Territorial conforme documento de fase e critérios de aceite.

Critérios de aceite

• Itens documentados em docs/backlog-api/FASE61.md
• Harness/spec verde quando aplicável
• run-tests passa na área afetada
• sync-docs aplicado
• Apontamentos de bots resolvidos no PR
• Merge humano após ready-for-merge

Guardrails

• Sem merge automático
• Escopo limitado à área: area/backend

---

[github-actions]

Agente acionado: Backend Agent

ID: backend | Quando: 2026-07-01T18:47:54Z UTC | Gatilho: issues:labeled
Workflow: 28540155766

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/
• ./scripts/agents/arah-agents.ps1 spec-validate passa
• Critérios acceptance da spec cobertos por testes (dotnet test --filter FullyQualifiedName~Core se Core)

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

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
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.