{"id":50826465,"url":"https://github.com/paulasilvatech/workshop-datacorp-team-kit-pt-br","last_synced_at":"2026-06-13T19:34:47.901Z","repository":{"id":359114140,"uuid":"1244538301","full_name":"paulasilvatech/workshop-datacorp-team-kit-pt-br","owner":"paulasilvatech","description":"Kit do time em Português (BR) — workshop de modernização de Natural/Adabas com GitHub Copilot e Spec-Kit","archived":false,"fork":false,"pushed_at":"2026-06-10T16:23:24.000Z","size":1487,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-13T19:34:37.310Z","etag":null,"topics":["agentic-ai","copilot","github","legacy","workshop"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paulasilvatech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-20T11:07:20.000Z","updated_at":"2026-06-10T16:25:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paulasilvatech/workshop-datacorp-team-kit-pt-br","commit_stats":null,"previous_names":["paulasilvatech/workshop-datacorp-team-kit-pt-br"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/paulasilvatech/workshop-datacorp-team-kit-pt-br","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulasilvatech%2Fworkshop-datacorp-team-kit-pt-br","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulasilvatech%2Fworkshop-datacorp-team-kit-pt-br/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulasilvatech%2Fworkshop-datacorp-team-kit-pt-br/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulasilvatech%2Fworkshop-datacorp-team-kit-pt-br/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paulasilvatech","download_url":"https://codeload.github.com/paulasilvatech/workshop-datacorp-team-kit-pt-br/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulasilvatech%2Fworkshop-datacorp-team-kit-pt-br/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34298247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","copilot","github","legacy","workshop"],"created_at":"2026-06-13T19:34:44.146Z","updated_at":"2026-06-13T19:34:47.896Z","avatar_url":"https://github.com/paulasilvatech.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- markdownlint-disable MD013 MD025 MD026 MD028 MD029 MD034 MD040 MD051 MD056 MD060 --\u003e\n\n# 🏰 Kit do Time — Workshop SIFAP 2.0 (PT-BR)\n\n![Jornada de modernização do SIFAP: de Natural e Adabas para Java 21 e Next.js 15](assets/hero-sifap-journey.svg)\n\n\u003e 🎮 **A missão em uma frase:** você e 4 colegas têm **8 horas** para modernizar um sistema de pagamentos de **29 anos**. Cinco pares, quatro mundos, uma princesa para resgatar (= SIFAP 2.0 rodando ao vivo na demo).\n\n---\n\n## 🚪 Por onde começar (escolha sua porta)\n\n| Eu sou… | Comece aqui |\n|---|---|\n| 🆕 **Primeira vez ou não-técnico** | [`00-COMECE-AQUI.md`](00-COMECE-AQUI.md) — 15 minutos guiados |\n| 👨‍💻 **Dev, quero o cronograma** | [`00-TEAM-FLOW.md`](00-TEAM-FLOW.md) — 10 minutos |\n| 🧠 **Quero entender os conceitos primeiro** | [`07-conceitos/`](07-conceitos/) — analogias Mario |\n| 🛠 **Quero subir o ambiente** | [`00-SETUP.md`](00-SETUP.md) — laptop + Copilot |\n| 🌿 **Como Git funciona neste workshop?** | [`00-GIT-WORKFLOW.md`](00-GIT-WORKFLOW.md) — branch por persona |\n| 🆘 **Algo deu errado** | [`docs/troubleshooting.md`](docs/troubleshooting.md) |\n| 🏆 **Sou o líder do time** | [`docs/CHECKLIST-LIDER.md`](docs/CHECKLIST-LIDER.md) — hora a hora |\n| 🪦 **Quero evitar erros comuns** | [`docs/lessons-learned.md`](docs/lessons-learned.md) |\n| 🎤 **Vou fazer a demo** | [`docs/demo-script.md`](docs/demo-script.md) |\n| 📊 **Quero ver o progresso do dia** | [`docs/STATUS.md`](docs/STATUS.md) |\n\n---\n\n## 🍄 A analogia: o workshop é um co-op de Super Mario\n\n```\n                                                                       🏰\n🟦 MUNDO 1 ──🟢cano──\u003e 🟫 MUNDO 2 ──🟢cano──\u003e 🟧 MUNDO 3 ──🟢cano──\u003e CASTELO\n@archaeologist          @architect              @builder              @evolution\n(arqueologia)           (spec moderna)          (implementação)       (evolução)\n                                                                          │\n                                                                          ▼\n                                                                     👸 SIFAP 2.0\n                                                                       rodando!\n```\n\n- **5 jogadores** = 5 pessoas, cada uma com 2 personas (1 par)\n- **4 mundos** = 4 estágios; cada um com um agente Copilot dedicado\n- **Power-ups permanentes** = persona-kits (slash commands, skills)\n- **Cano verde** = passagem entre estágios (5 min de conversa síncrona)\n- **Estrela** = CI verde valida seu PR\n- **Princesa** = demo do SIFAP 2.0 funcionando\n\n📘 Entenda a analogia em detalhe → [`07-conceitos/02-agentes-como-super-mario.md`](07-conceitos/02-agentes-como-super-mario.md)\n\n---\n\n## 📍 Estrutura do kit (ordem de leitura recomendada)\n\n```\n📁 workspace/\n├── 📜 README.md                       ← você está aqui\n├── 📜 00-COMECE-AQUI.md               ← 15 min para qualquer pessoa\n├── 📜 00-SETUP.md                     ← preparar laptop + Copilot\n├── 📜 00-TEAM-FLOW.md                 ← cronograma canônico do dia\n├── 📜 00-SITEMAP.md                   ← mapa visual do kit\n├── 📜 00-GIT-WORKFLOW.md              ← branches, PRs, merges\n│\n├── 📁 01-arqueologia/                 🟦 ESTÁGIO 1 — ler legado SIFAP\n│   ├── GUIDE.md                       (passo a passo do estágio)\n│   ├── LEGACY-EXPLORATION-CHECKLIST.md (gate obrigatório!)\n│   └── legado-sifap/                  📜 (15 .NSN + 4 DDMs + docs históricos)\n├── 📁 02-spec-moderna/                🟫 ESTÁGIO 2 — escrever EARS, ADRs, C4\n├── 📁 03-implementacao/               🟧 ESTÁGIO 3 — Java + Next.js + testes\n├── 📁 04-evolucao/                    🏰 ESTÁGIO 4 — Agent mode + Terraform\n│\n├── 📁 05-personas/                    🧑‍🤝‍🧑 10 personas (escolha 2 = seu par)\n├── 📁 06-agentes-de-estagio/          🌍 4 agentes Copilot (1 por mundo)\n├── 📁 07-conceitos/                   🧠 analogias Mario (Lego/RPG/EARS)\n├── 📁 08-exemplos/                    📘 artefatos completos prontos\n├── 📁 09-cheat-sheets/                🎴 3 cartões de 1 página\n├── 📁 12-plugins/                     🔌 GitHub Issues, Azure Boards\n│\n├── 📁 docs/                           📚 FAQ, troubleshooting, runbook, ADRs\n├── 📁 assets/                         🖼 SVGs e diagramas\n└── 📁 specs/                          📋 exemplo Spec-Kit\n```\n\n---\n\n## 🧑‍🤝‍🧑 Os 5 pares (escolha seu personagem)\n\nCada pessoa veste **um par** (duas personas) e fica com ele o dia inteiro.\n\n| Par | Personas | 🍄 Personagem Mario | Fase do SDLC |\n|---|---|---|---|\n| **1 · Visão** | PO + Requirements Engineer | 👸 Peach + 📖 Toad | Descoberta + Especificação |\n| **2 · Arquitetura** | Enterprise + Software Architect | 🌟 Rosalina + 🔷 Daisy | Especificação + Design |\n| **3 · Implementação** | Technical Lead + Developer | 🟥 Mario + 🟩 Luigi | Implementação + Evolução |\n| **4 · Qualidade** | DBA + QA Engineer | 🦖 Yoshi + 🐢 Koopa | Implementação (dados + testes) |\n| **5 · Operações** | DevOps + Tech Writer | 🍄 Captain Toad + 🎺 Bardo | Transversal + Evolução |\n\n📘 Detalhe de cada papel → [`05-personas/OVERVIEW.md`](05-personas/OVERVIEW.md)\n\n---\n\n## ⚙️ Ferramentas aprovadas — somente estas\n\n\u003e [!IMPORTANT]\n\u003e O workshop roda em **stack fixa**. Misturar ferramentas alternativas fragmenta o time e quebra a rastreabilidade spec → código → teste.\n\n| ✅ Use | ❌ Não use |\n|---|---|\n| **VS Code** (ou Insiders) | Cursor, Windsurf, Antigravity, IntelliJ, Eclipse |\n| **GitHub Copilot** (Ask + Plan + Agent) | Codex, Cline, Continue, Aider, Codeium, Tabnine |\n| **GitHub Copilot CLI** *(opcional)* | UIs web de chat para gerar código |\n| **Spec-Kit oficial** (`Specify CLI`) | Kiro, frameworks SDD alternativos |\n| **GitHub** (Issues, PRs, Actions) | — |\n| **Docker / Docker Compose** | Instalações locais que divergem do devcontainer |\n| **Terraform** (Azure provider) | `terraform apply` (só `plan`!) |\n\nO racional completo e o que o CI verifica estão em [`.github/copilot-instructions.md`](.github/copilot-instructions.md).\n\n---\n\n## 🎮 Duas camadas de agente — ambas obrigatórias\n\nO kit traz **duas camadas** que cobrem eixos diferentes (papel × estágio). Use as duas.\n\n| Camada | O que é | Quando carrega | Como |\n|---|---|---|---|\n| [`05-personas/`](05-personas/) | Seu **personagem** (Mario, Peach…) com inventário (prompts, skills, MCP) | Já vem no repositório | Leia o `PERSONA.md`; os kits já estão no `.github/` |\n| [`06-agentes-de-estagio/`](06-agentes-de-estagio/) | O **mundo atual** (@archaeologist → @evolution) | A cada estágio | Seletor de agentes no Copilot Chat |\n\n**Não são duplicados.** Persona = sua classe individual. Agente = mundo em que o time todo está agora.\n\n📘 Explicação completa → [`07-conceitos/02-agentes-como-super-mario.md`](07-conceitos/02-agentes-como-super-mario.md)\n\n---\n\n## 🌿 Git: cada persona em sua branch\n\nCada par cria **sua própria branch** a partir de `develop` (pelo site do GitHub ou pelo VS Code — não precisa abrir PR para criar a branch), trabalha nela, abre **Pull Request** para `develop`, recebe **review do par downstream**, mergeia. Ao fim do dia, líder mergeia `develop → main`.\n\n```\nspec/\u003cNNN\u003e-...        ← Estágio 2 (RE+SA)\nimpl/\u003cmodulo\u003e-...     ← Estágio 3 (Dev+DBA)\ntest/\u003cfeature\u003e        ← Estágio 3 (QA)\ninfra/\u003ccomponente\u003e    ← Estágio 4 (DevOps)\ndocs/\u003ctopico\u003e         ← Transversal (TW)\nagent/\u003cissue-NN\u003e      ← Estágio 4 (Copilot Agent)\n```\n\n📘 Detalhes + comandos salvadores → [`00-GIT-WORKFLOW.md`](00-GIT-WORKFLOW.md)\n\n---\n\n## 🚀 Como usar este kit (3 passos)\n\n### 1. Setup inicial (uma vez, ~45 min)\n\nO líder cria o repositório do time clicando em **Use this template** no repositório do kit (organização [`serpro-sao-paulo`](https://github.com/serpro-sao-paulo)), nomeando-o `workshop-\u003ccor\u003e-\u003cnumero\u003e` e deixando-o **público**. Depois cada pessoa clona:\n\n```bash\n# Clone o repositório do time e abra no VS Code (troque pela cor/número reais)\ncd ~/Code\ngit clone https://github.com/serpro-sao-paulo/workshop-azul-01.git\ncd workshop-azul-01\ngit checkout develop\ncode .\n```\n\nNão há script de bootstrap nem dev container: o repositório já vem completo do template (documentação, personas, legado SIFAP, CI e Spec-Kit).\n\n📘 Detalhes em [`00-SETUP.md`](00-SETUP.md)\n\n### 2. Pré-aquecimento (~30 min, cada pessoa)\n\n```bash\n# 1. Cronograma do dia\ncat 00-TEAM-FLOW.md\n\n# 2. Conceitos com analogia Mario (não-devs: comece aqui)\ncat 07-conceitos/00-README.md\n\n# 3. Suas 2 personas (os kits Copilot já estão no .github/ do repo)\ncat 05-personas/XX-persona-A/PERSONA.md\ncat 05-personas/YY-persona-B/PERSONA.md\n```\n\n### 3. Dia do workshop — siga os 4 estágios\n\n```\n🟦 01-arqueologia/GUIDE.md   ← ler legado, extrair regras\n🟫 02-spec-moderna/GUIDE.md  ← EARS, ADRs, C4\n🟧 03-implementacao/GUIDE.md ← Java + Next.js + testes\n🏰 04-evolucao/GUIDE.md      ← Agent mode + Terraform\n```\n\n---\n\n## 🎯 Por que isso importa\n\nA maioria dos projetos de modernização falha não porque o time não sabe escrever Java, mas porque escreve Java para o **problema errado**. Modernizam o brief, não o sistema. Perdem 29 anos de regras de negócio enterradas em código que ninguém lê.\n\n![Quatro dores do SIFAP legado](assets/sifap-pain-points.svg)\n\nEste kit existe para impedir isso:\n\n- 📜 O código legado vem junto (em [`01-arqueologia/legado-sifap/`](01-arqueologia/legado-sifap/))\n- ⭐ A rastreabilidade (`source_legacy:`) é exigida pelo CI\n- 🟢 Os canos verdes (passagens H1, H2, H3) estão agendados\n- 🧑‍🤝‍🧑 Os papéis são explícitos (10 PERSONA.md)\n- 📘 Você não precisa **inventar** o processo; precisa **executá-lo**.\n\n---\n\n## 📜 Contrato didático deste kit (5 regras)\n\nTodo documento aqui segue 5 regras:\n\n1. 📍 **Contexto primeiro** — onde isso encaixa no SDLC e por que importa\n2. 👣 **Passo a passo executável** — comandos, checklist ou sequência\n3. 🎯 **Exemplo concreto** — sempre exemplos SIFAP, nunca abstrato\n4. ✅ **Critério de pronto** — como saber que terminou\n5. 🆘 **Solução de problemas** — onde há risco operacional, há seção de troubleshooting\n\n---\n\n## 🍄 Glossário mínimo (1 frase cada)\n\n| Termo | 🍄 Em uma frase |\n|---|---|\n| **EARS** | Receita exata de requisito (sem \"a gosto\") |\n| **ADR** | Carta da Princesa explicando uma decisão |\n| **Spec-Kit** | Mario Maker — desenhe a fase antes de jogar |\n| **Persona-kit** | Seu personagem + inventário do dia |\n| **Agent-kit** | O mundo atual (1-1, 2-1, 3-1, castelo) |\n| **source_legacy** | Moeda numerada provando origem no `.NSN` |\n| **Bounded context** | Departamento da empresa (RH, Pagamento...) |\n| **CI verde** | Estrela de invencibilidade |\n\n📘 Glossário completo com 30+ termos → [`07-conceitos/03-glossario-visual.md`](07-conceitos/03-glossario-visual.md)\n\n---\n\n### Continuar a leitura\n\n\u003ctable width=\"100%\"\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\" valign=\"top\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\" valign=\"top\" align=\"right\"\u003e\n\u003csub\u003e\u003cstrong\u003ePRÓXIMO →\u003c/strong\u003e\u003c/sub\u003e\u003cbr/\u003e\n\u003ca href=\"00-COMECE-AQUI.md\"\u003e\u003cstrong\u003e00 — Comece aqui\u003c/strong\u003e\u003c/a\u003e\u003cbr/\u003e\n\u003csub\u003e15 minutos guiados para qualquer pessoa.\u003c/sub\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n— Paula\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulasilvatech%2Fworkshop-datacorp-team-kit-pt-br","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulasilvatech%2Fworkshop-datacorp-team-kit-pt-br","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulasilvatech%2Fworkshop-datacorp-team-kit-pt-br/lists"}