English · Por que este projeto é em português?
O ProdOps é um modelo operacional para times de produto que separa artefatos de conhecimento permanentes — OBC, BDD, Business Intent, Signal, Architecture, Plans, Trails, Evidence — de execução efêmera no GitHub — Issues, PRs, Releases.
Origem: O Framework foi criado e validado em produção no produto
payments-api. A documentação canônica vive emprodops-framework. Artefatos de produto ficam no repositório do produto.
Status atual: Framework e Runtime estão sendo co-desenvolvidos neste repo e na RI
payments-apiem paralelo — sincronizados a cada alteração — enquanto o conteúdo amadurece para Release Candidate. Quando o RC for declarado, apayments-apipassa a ser consumidora pura e este repositório vira a única fonte de autoridade.→ Última release: v1.4.0 → RI (payments-api): produtoreativo/payments-api
ProdOps Framework → ProdOps Portfolio → ProdOps Workspace → Product Repository
O Framework é o nível zero — define vocabulário, princípios, fluxo e modelo operacional. Portfolios, Workspaces e Product Repositories o adotam sem modificar suas definições canônicas.
→ Arquitetura completa e definições
Um artefato ProdOps NUNCA é uma GitHub Issue.
Knowledge Space (permanente) Execution Space (efêmero)
───────────────────────────── ──────────────────────────
OBC, BDD, Intent, Signal, Issues, PRs, Discussions,
Architecture, Plans, Evidence Releases, Milestones
Markdown sempre prevalece sobre GitHub.
→ Knowledge vs Execution → Execution Mapping
Origin Stream → Business Signal → Fluxo Global ou Local
→ Local OBC Draft no Product Backlog
→ Modo: Upstream (exploração) | Downstream (compromisso)
→ Discovery + Assessment → OBC Committed
→ Iteration Plan → Delivery → Operation
→ Fluxo completo explicado → Os quatro Origin Streams
| Documento | Descrição |
|---|---|
| framework/principles.md | Princípios fundacionais |
| framework/glossary.md | Termos canônicos |
| framework/flow.md | Fluxo oficial do Framework |
| framework/origin-streams.md | Os quatro Origin Streams |
| framework/operating-model.md | Modelo operacional completo |
| framework/knowledge-vs-execution.md | Separação Knowledge × Execution |
| framework/execution-mapping/README.md | Execution Mapping capability |
| framework/backlogs.md | Backlogs e tipos de Work Item |
| framework/artifact-governance.md | Governança de artefatos |
No diretório raiz do repositório destino:
bash <(curl -fsSL \
https://raw.githubusercontent.com/produtoreativo/prodops-framework/master/prodops/scripts/install-prodops.sh) \
--version v1.4.0Ou, se preferir clonar primeiro:
gh repo clone produtoreativo/prodops-framework /tmp/prodops-framework
bash /tmp/prodops-framework/prodops/scripts/install-prodops.sh --version v1.4.0 --target /caminho/do/repoApós a instalação:
- Crie
prodops/exec/manifest.yaml— configuração operacional do produto (paths, gates, skills, github, diligence) - Crie os diretórios de artefatos:
prodops/artifacts/obcs/,prodops/artifacts/bdd/,prodops/artifacts/plans/, etc. - Ative os hooks de commit:
git config core.hooksPath prodops/framework/journeys/delivery/capabilities/commit-workflow/hooks
- Verifique a instalação:
bash prodops/scripts/doctor.sh
→ Filosofia e regras de extensão: prodops/framework/contributor-philosophy.md
# Atualizar para uma nova versão (abre PR)
bash prodops/scripts/sync-from-framework.sh --version v1.4.0
# Verificar drift sem alterar
bash prodops/scripts/sync-from-framework.sh --checkEsta seção é relevante quando você está lendo este README dentro de um Product Repository.
| Área | Descrição |
|---|---|
| framework/ | Framework canônico — não modificar por produto |
| artifacts/business/intents/ | Business Intents registradas |
| journeys/ | As 5 jornadas: Discovery, Delivery, Operation, Assessment, Diligence |
| artifacts/ | Artefatos produzidos: OBCs, BDD Features, planos, trilhas, evidências |
| templates/ | Templates centralizados por área |
| skills/ | Skills executáveis por agentes |