Implemente a tarefa Jira (passada em <entrada fornecida pelo usuário na solicitação>) no projeto fritta, em qualquer módulo, SEM consultar GitHub (sem PR, sem review). O fluxo é SEMPRE: proposta OpenSpec primeiro → aprovação do usuário → só então implementação.
Fluxo obrigatório:
Pegar a tarefa via MCP Atlassian:
jira_get_issuecom a key (summary, description, acceptance criteria, comments, links, epic). Se a key não vier em <entrada fornecida pelo usuário na solicitação>, pergunte.Identificar o(s) módulo(s) afetado(s) a partir da tarefa e do épico:
backend/— Kotlin/Ktor/Exposed (Clean/Hexagonal) →backend/CLAUDE.mdfrontend/— admin web Vue 3 →frontend/CLAUDE.mdstorefront/— cardápio público Vue 3 →storefront/CLAUDE.md(se existir)pos/— app Android Kotlin →pos/CLAUDE.md+docs/adr-pos-acquirer.mdmobile/— TBD →mobile/CLAUDE.mdinfra/— CI/CD, compose, nginx, observabilidade →infra/CLAUDE.md- Integrações externas são bounded contexts do backend (padrão WhatsApp/iFood) — Mais Delivery →
docs/adr-mais-delivery.mdSe o escopo for materialmente ambíguo (módulo ou comportamento), pergunte antes de propor.
Contexto obrigatório (do que for afetado):
CLAUDE.mdda raiz +CLAUDE.mddo(s) módulo(s) tocado(s)- ADRs/runbooks relacionados em
docs/(adr-*.md,database*.md,api-reference.md,deploy.md, ...) — fonte de verdade do módulo - Specs OpenSpec existentes (
openspec/specs/*,openspec/changes/*) eopenspec/config.yaml - Código existente do módulo para seguir o estilo (camadas, DI, lint)
PROPOSTA OpenSpec — primeiro passo do trabalho:
- Crie a change com
/opsx-propose(ou a skillopenspec-propose), nome kebab-case derivado da tarefa (ex.:fa-566-receber-pedidos) - Se já existir uma change correspondente (mesma tarefa/épico), ESTENDA a change existente (atualize os artefatos dela) — só crie uma nova se o usuário preferir
- A proposta deve cobrir: proposal (o que/porquê), specs delta, design (como, respeitando os ADRs), tasks (passos de implementação)
- Inclua SEMPRE uma task explícita de documentação: "atualizar os ADRs/docs afetados e README do módulo" — se a tarefa não mudar casos de uso/contratos, a proposta deve declarar isso e a task vira "verificar que ADRs/docs não precisam de atualização"
- Mostre o resumo da proposta (artefatos criados, decisões de design, tasks)
- Crie a change com
PARAR E AGUARDAR APROVAÇÃO DA PROPOSTA:
- Exiba a proposta e pergunte explicitamente se aprova
- O resumo da proposta DEVE destacar "documentação alterada: SIM/NÃO" e, se SIM, quais ADRs/docs/README e o impacto — você aprova sabendo se a documentação será alterada
- NÃO implemente nada, NÃO edite código, NÃO toque em arquivos além dos artefatos da proposta
- "Sempre tenho que aprovar" — sem aprovação, o fluxo morre aqui
IMPLEMENTAÇÃO — só depois da aprovação:
- Rode
/opsx-apply(ou a skillopenspec-apply-change) na change aprovada - Implemente task a task seguindo as regras do módulo: backend com domínio puro (zero framework), use cases dependendo só de portas, adapters na borda, Koin ligando; web via services/i18n (nunca chamar API direto na página); POS conforme
docs/adr-pos-acquirer.md(domínio sem Android/Retrofit) - Marque
- [x]conforme cada task completa - Na task de documentação: atualize os ADRs/docs afetados (preservando o que não mudou) e o README do módulo quando aplicável. Tarefa implementada sem docs atualizados é entrega incompleta
- Adicione testes para o novo comportamento (regra: caso novo sem teste = não terminado)
- Rode
Verificar por módulo (testes/build no host; runtime sempre via Docker — nunca
./gradlew run/npm run devno host):- backend:
./gradlew :backend:test :backend:ktlintCheck(da raiz) - frontend/storefront:
npm run type-check+npm run buildno módulo; runtimedocker compose up -d --build web|storefront - pos:
JAVA_HOME=/usr/lib/jvm/java-21-openjdk ANDROID_HOME=$HOME/Android/Sdk ./gradlew :app:assembleDebug :app:ktlintCheck :app:testDebugUnitTest --no-daemonempos/app - infra:
docker compose config+ smoke/validação do que mudou (nginx, workflows, compose) - runtime backend:
docker compose up -d --build api
- backend:
Resumo + aprovação para commitar: exiba o resumo (tasks concluídas, arquivos, testes, ADRs/docs atualizados) e PEÇA APROVAÇÃO antes do commit. Commit conventional em português (
feat(backend): ...,fix(web): ...), staging seletivo (nuncagit add .), atômico por área, branchfeature/*/fix/*a partir dedevelop(Gitflow; PR paradevelop). Push só após aprovação.
Guardrails:
- Proposta SEMPRE antes de código; implementação SEMPRE depois de aprovação explícita da proposta
- Não commitar sem aprovação explícita (nem proposta, nem commit)
- Não alterar partes dos ADRs/docs não afetadas pela tarefa
- Todo código em inglês; strings de UI em português (i18n)
- Money sempre Long em centavos; IDs tipados; soft delete
deleted_at - Nunca importar repositório direto em route/controller (backend: use cases via Koin); nunca
as anyno web - Sem comentários em código desnecessários
- Nunca commitar direto em
main/develop; nuncagit add .; nuncagit push --forceemmain/develop