create-genia-os 1.0.0

package/template/.genia/skills/documents/pdf.md

@@ -0,0 +1,134 @@
+# Skill: /pdf
+
+## Metadata
+- **Nome**: PDF Processing
+- **Comando**: /pdf
+- **Agente**: @dev
+- **Categoria**: documents
+- **Versao**: 2.0
+
+## Descricao
+Toolkit completo para manipulacao de PDFs: extrair texto e tabelas, criar novos PDFs, mesclar/dividir documentos e preencher formularios.
+
+## Quando Usar
+- Extrair texto de PDFs
+- Extrair tabelas para Excel/CSV
+- Mesclar multiplos PDFs
+- Dividir PDF em paginas
+- Criar novos PDFs
+- Preencher formularios PDF
+- Adicionar marca d'agua
+- OCR em PDFs escaneados
+
+## Bibliotecas Python
+
+### pypdf - Operacoes Basicas
+```python
+from pypdf import PdfReader, PdfWriter
+
+# Ler PDF
+reader = PdfReader("documento.pdf")
+print(f"Paginas: {len(reader.pages)}")
+
+# Extrair texto
+text = ""
+for page in reader.pages:
+    text += page.extract_text()
+```
+
+### Mesclar PDFs
+```python
+from pypdf import PdfWriter, PdfReader
+
+writer = PdfWriter()
+for pdf_file in ["doc1.pdf", "doc2.pdf", "doc3.pdf"]:
+    reader = PdfReader(pdf_file)
+    for page in reader.pages:
+        writer.add_page(page)
+
+with open("mesclado.pdf", "wb") as output:
+    writer.write(output)
+```
+
+### Dividir PDF
+```python
+reader = PdfReader("input.pdf")
+for i, page in enumerate(reader.pages):
+    writer = PdfWriter()
+    writer.add_page(page)
+    with open(f"pagina_{i+1}.pdf", "wb") as output:
+        writer.write(output)
+```
+
+### pdfplumber - Extrair Tabelas
+```python
+import pdfplumber
+import pandas as pd
+
+with pdfplumber.open("documento.pdf") as pdf:
+    all_tables = []
+    for page in pdf.pages:
+        tables = page.extract_tables()
+        for table in tables:
+            if table:
+                df = pd.DataFrame(table[1:], columns=table[0])
+                all_tables.append(df)
+
+if all_tables:
+    combined_df = pd.concat(all_tables, ignore_index=True)
+    combined_df.to_excel("tabelas.xlsx", index=False)
+```
+
+### reportlab - Criar PDFs
+```python
+from reportlab.lib.pagesizes import letter
+from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer
+from reportlab.lib.styles import getSampleStyleSheet
+
+doc = SimpleDocTemplate("relatorio.pdf", pagesize=letter)
+styles = getSampleStyleSheet()
+story = []
+
+story.append(Paragraph("Titulo", styles['Title']))
+story.append(Spacer(1, 12))
+story.append(Paragraph("Conteudo aqui...", styles['Normal']))
+
+doc.build(story)
+```
+
+## Comandos CLI
+
+### pdftotext (poppler-utils)
+```bash
+pdftotext input.pdf output.txt
+pdftotext -layout input.pdf output.txt  # Preserva layout
+```
+
+### qpdf
+```bash
+qpdf --empty --pages file1.pdf file2.pdf -- merged.pdf  # Mesclar
+qpdf input.pdf --pages . 1-5 -- pages1-5.pdf  # Extrair paginas
+```
+
+## Quick Reference
+
+| Tarefa | Biblioteca | Codigo |
+|--------|------------|--------|
+| Mesclar PDFs | pypdf | `writer.add_page(page)` |
+| Extrair texto | pdfplumber | `page.extract_text()` |
+| Extrair tabelas | pdfplumber | `page.extract_tables()` |
+| Criar PDFs | reportlab | Canvas ou Platypus |
+| OCR | pytesseract | Converter para imagem primeiro |
+| Formularios | pypdf/pdf-lib | Ver forms.md |
+
+## Dependencias
+```bash
+pip install pypdf pdfplumber reportlab pytesseract pdf2image
+```
+
+## Tasks Relacionadas
+- task:extrair-dados-pdf
+- task:gerar-relatorio-pdf
+
+## Workflows
+- workflow:processar-documentos

package/template/.genia/skills/documents/pptx.md

@@ -0,0 +1,118 @@
+# Skill: /pptx
+
+## Metadata
+- **Nome**: PowerPoint Processing
+- **Comando**: /pptx
+- **Agente**: @dev
+- **Categoria**: documents
+- **Versao**: 2.0
+
+## Descricao
+Criacao, edicao e analise de apresentacoes PowerPoint com suporte a layouts, comentarios, notas do apresentador e temas.
+
+## Quando Usar
+- Criar novas apresentacoes
+- Modificar/editar slides
+- Trabalhar com layouts
+- Adicionar comentarios ou notas
+- Extrair conteudo de apresentacoes
+
+## Extracao de Texto
+```bash
+python -m markitdown apresentacao.pptx
+```
+
+## Estrutura de Arquivos PPTX
+
+| Arquivo | Conteudo |
+|---------|----------|
+| `ppt/presentation.xml` | Metadata e referencias |
+| `ppt/slides/slide{N}.xml` | Conteudo dos slides |
+| `ppt/notesSlides/` | Notas do apresentador |
+| `ppt/comments/` | Comentarios |
+| `ppt/slideLayouts/` | Templates de layout |
+| `ppt/slideMasters/` | Master slides |
+| `ppt/theme/` | Tema e estilos |
+| `ppt/media/` | Imagens e midia |
+
+## Criar Apresentacao (html2pptx)
+
+### Design Principles
+1. **Considerar o assunto**: Tom, industria, mood
+2. **Branding**: Cores da empresa/organizacao
+3. **Paleta contextual**: Cores que refletem o tema
+4. **Declarar abordagem**: Explicar escolhas antes do codigo
+
+### Workflow
+1. Ler `html2pptx.md` completamente
+2. Criar HTML para cada slide (720pt x 405pt para 16:9)
+3. Usar JavaScript com `html2pptx.js`
+4. Validar visualmente com thumbnails
+
+### Paletas de Cores (Exemplos)
+```
+Classic Blue: #1C2833, #2E4053, #AAB7B8, #F4F6F6
+Teal & Coral: #5EA8A7, #277884, #FE4447, #FFFFFF
+Bold Red: #C0392B, #E74C3C, #F39C12, #F1C40F
+Black & Gold: #BF9A4A, #000000, #F4F6F6
+```
+
+### Dicas de Layout
+- **Duas colunas**: Header full-width, duas colunas abaixo
+- **Full-slide**: Chart/tabela ocupando slide inteiro
+- **NUNCA**: Empilhar verticalmente texto + chart
+
+## Editar Apresentacao Existente
+
+### Workflow
+1. Desempacotar: `python ooxml/scripts/unpack.py apresentacao.pptx diretorio`
+2. Editar XMLs em `ppt/slides/`
+3. Validar: `python ooxml/scripts/validate.py diretorio --original apresentacao.pptx`
+4. Reempacotar: `python ooxml/scripts/pack.py diretorio output.pptx`
+
+## Usar Template Existente
+
+### Workflow
+1. Extrair texto e criar thumbnails
+2. Analisar template e criar inventario
+3. Criar outline com mapeamento de slides
+4. Reordenar slides: `python scripts/rearrange.py template.pptx working.pptx 0,34,34,50`
+5. Extrair inventario: `python scripts/inventory.py working.pptx inventory.json`
+6. Gerar JSON de substituicao
+7. Aplicar: `python scripts/replace.py working.pptx replacement.json output.pptx`
+
+## Criar Thumbnails
+```bash
+python scripts/thumbnail.py template.pptx [output_prefix]
+# Opcoes: --cols 4 (3-6)
+```
+
+## Converter para Imagens
+```bash
+# PPTX → PDF
+soffice --headless --convert-to pdf apresentacao.pptx
+
+# PDF → JPEG
+pdftoppm -jpeg -r 150 apresentacao.pdf slide
+```
+
+## Dependencias
+```bash
+# Python
+pip install markitdown defusedxml
+
+# Node
+npm install pptxgenjs playwright react-icons sharp
+
+# Sistema
+sudo apt-get install libreoffice poppler-utils
+```
+
+## Tasks Relacionadas
+- task:criar-apresentacao
+- task:gerar-slides-dados
+- task:adaptar-template
+
+## Workflows
+- workflow:criar-pitch-deck
+- workflow:relatorio-visual

package/template/.genia/skills/documents/xlsx.md

@@ -0,0 +1,140 @@
+# Skill: /xlsx
+
+## Metadata
+- **Nome**: Excel/Spreadsheet Processing
+- **Comando**: /xlsx
+- **Agente**: @dev
+- **Categoria**: documents
+- **Versao**: 2.0
+
+## Descricao
+Criacao, edicao e analise de planilhas com suporte a formulas, formatacao, analise de dados e visualizacao.
+
+## Quando Usar
+- Criar planilhas com formulas
+- Ler e analisar dados
+- Modificar planilhas preservando formulas
+- Analise e visualizacao de dados
+- Recalcular formulas
+
+## Requisitos de Qualidade
+
+### Zero Erros de Formula
+Todo arquivo Excel deve ter ZERO erros (#REF!, #DIV/0!, #VALUE!, #N/A, #NAME?)
+
+### Cores Padrao (Modelos Financeiros)
+- **Texto azul**: Inputs hardcoded
+- **Texto preto**: TODAS as formulas
+- **Texto verde**: Links de outras abas
+- **Texto vermelho**: Links externos
+- **Fundo amarelo**: Assumpcoes importantes
+
+## Pandas - Analise de Dados
+```python
+import pandas as pd
+
+# Ler Excel
+df = pd.read_excel('arquivo.xlsx')
+all_sheets = pd.read_excel('arquivo.xlsx', sheet_name=None)  # Todas as abas
+
+# Analisar
+df.head()      # Preview
+df.info()      # Info das colunas
+df.describe()  # Estatisticas
+
+# Escrever
+df.to_excel('output.xlsx', index=False)
+```
+
+## OpenPyXL - Formulas e Formatacao
+
+### Criar Arquivo
+```python
+from openpyxl import Workbook
+from openpyxl.styles import Font, PatternFill, Alignment
+
+wb = Workbook()
+sheet = wb.active
+
+# Adicionar dados
+sheet['A1'] = 'Produto'
+sheet['B1'] = 'Valor'
+sheet.append(['Item 1', 100])
+sheet.append(['Item 2', 200])
+
+# Formula (NUNCA hardcodar valores calculados)
+sheet['B4'] = '=SUM(B2:B3)'
+
+# Formatacao
+sheet['A1'].font = Font(bold=True)
+sheet['A1'].fill = PatternFill('solid', start_color='FFFF00')
+sheet.column_dimensions['A'].width = 20
+
+wb.save('output.xlsx')
+```
+
+### Editar Arquivo Existente
+```python
+from openpyxl import load_workbook
+
+wb = load_workbook('existente.xlsx')
+sheet = wb.active
+
+# Modificar
+sheet['A1'] = 'Novo Valor'
+sheet.insert_rows(2)
+
+wb.save('modificado.xlsx')
+```
+
+## REGRA CRITICA: Usar Formulas
+
+### ERRADO - Hardcodar valores
+```python
+total = df['Sales'].sum()
+sheet['B10'] = total  # Hardcoda 5000
+```
+
+### CORRETO - Usar formulas Excel
+```python
+sheet['B10'] = '=SUM(B2:B9)'
+```
+
+## Recalcular Formulas
+```bash
+python recalc.py output.xlsx
+```
+
+O script:
+- Usa LibreOffice para recalcular
+- Escaneia TODAS as celulas por erros
+- Retorna JSON com erros detalhados
+
+## Formatacao de Numeros
+
+| Tipo | Formato |
+|------|---------|
+| Anos | Texto ("2024") |
+| Moeda | $#,##0 |
+| Percentual | 0.0% |
+| Multiplos | 0.0x |
+| Negativos | Parenteses (123) |
+
+## Best Practices
+- **pandas**: Analise de dados, operacoes bulk
+- **openpyxl**: Formatacao complexa, formulas
+- Indices sao 1-based (row=1, column=1 = A1)
+- `data_only=True` le valores calculados (perde formulas se salvar)
+
+## Dependencias
+```bash
+pip install pandas openpyxl
+```
+
+## Tasks Relacionadas
+- task:criar-relatorio-excel
+- task:analisar-dados
+
+## Workflows
+- workflow:processar-dados
+- workflow:gerar-relatorios

package/template/.synapse/agent-analyst

@@ -0,0 +1,8 @@
+=== @analyst — Ana, Analista de Negócios ===
+PAPEL: Coleta e documenta requisitos. Entrega BRIEFING.md para @pm.
+AUTORIDADE: briefing, pesquisa, análise de negócio, mapeamento de requisitos.
+GIT: APENAS leitura (status, log, diff).
+ENTREGA: docs/[projeto]/BRIEFING.md
+ESCALA PARA: @pm (mudança de escopo) | @architect (dúvidas técnicas)
+PRINCÍPIO: Nunca inventar requisitos. Questionar o "por quê" sempre.
+COMMANDS: *briefing *pesquisa *análise *validar

package/template/.synapse/agent-architect

@@ -0,0 +1,8 @@
+=== @architect — Arqui, Arquiteta de Sistemas ===
+PAPEL: Decisões arquiteturais, seleção de stack, VETO técnico irrevogável.
+AUTORIDADE EXCLUSIVA: Arquitetura, seleção de tecnologia, ADRs, SPEC-TECNICO.
+GIT: APENAS leitura.
+ENTREGAS: docs/[projeto]/SPEC-TECNICO.md | docs/[projeto]/adrs/ADR-*.md
+VETO: Pode bloquear qualquer decisão técnica.
+PRINCÍPIO: Arquitetura antes do código. Zero coupling desnecessário.
+COMMANDS: *spec *arquitetura *adr *veto *tech-stack

package/template/.synapse/agent-dev

@@ -0,0 +1,8 @@
+=== @dev — Dev, Desenvolvedor Full Stack ===
+PAPEL: Implementação de código conforme SPEC aprovado por @architect.
+AUTORIDADE: Implementação, testes unitários, refatoração.
+GIT: checkout, add, commit. NUNCA push (Artigo II — BLOQUEIO).
+ENTREGAS: Código em src/ | Testes em tests/
+ESCALA PARA: @devops (push/PR) | @architect (dúvida arquitetural) | @qa (revisão)
+PRINCÍPIO: Story aprovada por @po antes de codar. Sem invenção de features.
+COMMANDS: *implementar *testar *refatorar *debug

package/template/.synapse/agent-devops

@@ -0,0 +1,8 @@
+=== @devops — Gate, Engenheiro DevOps ===
+PAPEL: git push, PR, releases, CI/CD, infraestrutura, configuração MCP.
+AUTORIDADE EXCLUSIVA: git push, git push --force (só main emergência), PR, release, MCP add/remove.
+GIT: TUDO — único agente com permissão de push.
+ENTREGAS: PR criado | Deploy realizado | CI/CD configurado
+ESCALA PARA: @architect (decisões de infra) | @pm (aprovação de release)
+PRINCÍPIO: Nada vai para produção sem aprovação de @pm.
+COMMANDS: *push *pr *release *deploy *mcp-add *ci

package/template/.synapse/agent-pm

@@ -0,0 +1,8 @@
+=== @pm — Marina, Product Manager ===
+PAPEL: PRD, escopo, priorização, gestão de stakeholders, épicos.
+AUTORIDADE: PRD.md, COMERCIAL.md, épicos, priorização de backlog.
+GIT: APENAS leitura.
+ENTREGAS: docs/[projeto]/PRD.md | docs/[projeto]/COMERCIAL.md
+ESCALA PARA: @architect (decisões técnicas) | @po (validação de stories)
+PRINCÍPIO: Qualidade sobre velocidade. Zero ambiguidade em requisitos.
+COMMANDS: *prd *épico *priorizar *comercial *roadmap

package/template/.synapse/agent-po

@@ -0,0 +1,7 @@
+=== @po — Pax, Product Owner ===
+PAPEL: Validação de stories (10-point checklist), gestão de backlog, épico context.
+AUTORIDADE EXCLUSIVA: Aprovar stories para desenvolvimento.
+GIT: APENAS leitura.
+ENTREGAS: Stories validadas | Backlog priorizado
+PRINCÍPIO: Story sem acceptance criteria claros = REJEITADA.
+COMMANDS: *validar-story *backlog *priorizar *épico-context

package/template/.synapse/agent-qa

@@ -0,0 +1,8 @@
+=== @qa — Quinn, QA Engineer ===
+PAPEL: Veredictos de qualidade, design de testes, validação de acceptance criteria.
+AUTORIDADE: Aprovação/rejeição de entregas. Ninguém passa para Done sem Quinn.
+GIT: leitura + git stash.
+ENTREGAS: Relatório QA | Casos de teste | Aprovação formal
+QA LOOP: Máximo 5 iterações com @dev.
+PRINCÍPIO: Zero bugs críticos antes de aprovar. Qualidade é inegociável.
+COMMANDS: *revisar *testar *qa-report *aprovar *rejeitar

package/template/.synapse/agent-reviewer

@@ -0,0 +1,7 @@
+=== @reviewer — Rev, Code Reviewer ===
+PAPEL: Code review, padrões de código, aprovação técnica do código.
+AUTORIDADE: Aprovar ou rejeitar código para merge.
+GIT: APENAS leitura.
+ENTREGAS: Aprovação com comentários | Lista de issues
+PRINCÍPIO: Clean code sempre. Nenhum code vai para main sem review.
+COMMANDS: *review *aprovar *rejeitar *sugerir

package/template/.synapse/agent-sm

@@ -0,0 +1,7 @@
+=== @sm — Sami, Scrum Master ===
+PAPEL: Criação de stories, gestão de sprint, remoção de blockers.
+AUTORIDADE EXCLUSIVA: Criar stories no formato correto.
+GIT: APENAS leitura.
+ENTREGAS: STORY-NNN-slug.md | Sprint backlog
+PRINCÍPIO: Toda story tem acceptance criteria antes de ir para @po.
+COMMANDS: *story *sprint *blocker *planning *retrospectiva

package/template/.synapse/constitution

@@ -0,0 +1,7 @@
+=== CONSTITUIÇÃO GEN.IA OS ===
+ART I (BLOQUEIO): CLI First — Claude Code é fonte de verdade.
+ART II (BLOQUEIO): Autoridade — @devops é ÚNICO com push/PR. @architect tem veto técnico. @sm é ÚNICO que cria stories.
+ART III (OBRIG): Story-Driven — Zero código sem story aprovada por @po.
+ART IV (OBRIG): Sem Invenção — Apenas features dos requisitos explícitos.
+ART V (OBRIG): Qualidade — lint + testes + build devem passar.
+ART VI (INFO): Imports absolutos com @/.

package/template/.synapse/context

@@ -0,0 +1,8 @@
+=== CONTEXTO DO PROJETO ===
+Sistema: GEN.IA OS — Framework de desenvolvimento assistido por IA
+Marca: {{TEAM_NAME}}
+Criadora: {{CREATOR_NAME}}
+Agentes: analyst(Ana), pm(Marina), architect(Arqui), dev(Dev), devops(Gate), qa(Quinn), reviewer(Rev), po(Pax), sm(Sami)
+Workflows: spec-pipeline, story-development-cycle, qa-loop, greenfield, brownfield, planning, development, delivery
+Contextos disponíveis: {{CONTEXTS}}
+Skills disponíveis: /pdf /xlsx /docx /pptx /frontend-design /canvas-design /mcp-builder /webapp-testing

package/template/.synapse/global

@@ -0,0 +1,8 @@
+=== REGRAS GLOBAIS GEN.IA OS ===
+IDIOMA: Sempre responder em Português do Brasil.
+IDENTIDADE: {{TEAM_NAME}} | {{CREATOR_NAME}} | GEN.IA OS v1.0
+MEMORY: Ler .claude/agent-memory/[agente]/MEMORY.md ao ativar agente.
+HANDOFF: Ao transferir agente, usar formato de handoff (≤400 tokens).
+IDS: REUSAR > ADAPTAR > CRIAR — verificar antes de criar novo artefato.
+DOCS: PRD em docs/[projeto]/PRD.md | SPEC em docs/[projeto]/SPEC-TECNICO.md | Stories em docs/stories/
+COMMITS: formato "tipo(escopo): descricao" | Co-Authored-By: GEN.IA OS <genia@bedata.com.br>

package/template/.synapse/manifest

@@ -0,0 +1,14 @@
+# GEN.IA OS — Synapse Manifest
+# Formato: nome=caminho_relativo_ao_projeto
+constitution=.synapse/constitution
+global=.synapse/global
+context=.synapse/context
+agent-analyst=.synapse/agent-analyst
+agent-pm=.synapse/agent-pm
+agent-architect=.synapse/agent-architect
+agent-dev=.synapse/agent-dev
+agent-devops=.synapse/agent-devops
+agent-qa=.synapse/agent-qa
+agent-reviewer=.synapse/agent-reviewer
+agent-po=.synapse/agent-po
+agent-sm=.synapse/agent-sm

package/template/README.md

@@ -0,0 +1,53 @@
+# {{PROJECT_NAME}}
+
+> Powered by **GEN.IA OS** — Sistema operacional de desenvolvimento com IA
+
+## Setup
+
+Este projeto usa o [GEN.IA OS](https://github.com/elidyizzy/GENIA-SQUAD-OS) com Claude Code.
+
+### Pré-requisitos
+
+- [Claude Code](https://claude.ai/code) instalado
+- Node.js 18+
+- Python 3.10+
+- Git
+
+### Como usar
+
+Abra o projeto no VS Code com Claude Code e chame um agente:
+
+```
+@sm crie a primeira story do projeto
+@analyst faça um briefing sobre [funcionalidade]
+@dev implemente a STORY-001
+```
+
+## Agentes disponíveis
+
+| Agente | Nome | Papel |
+|--------|------|-------|
+| `@analyst` | Ana | Analista de Negócios |
+| `@pm` | Marina | Product Manager |
+| `@architect` | Arqui | Arquiteta de Sistemas |
+| `@dev` | Dev | Desenvolvedor Full Stack |
+| `@devops` | Gate | DevOps Engineer |
+| `@qa` | Quinn | QA Engineer |
+| `@reviewer` | Rev | Code Reviewer |
+| `@po` | Pax | Product Owner |
+| `@sm` | Sami | Scrum Master |
+
+## Estrutura
+
+```
+{{PROJECT_NAME}}/
+├── .claude/          ← Integração Claude Code
+├── .genia/           ← Framework core
+├── .synapse/         ← Runtime do Synapse Engine
+├── docs/stories/     ← Stories do projeto
+└── src/              ← Código-fonte
+```
+
+---
+
+_Gerado com [create-genia-os](https://github.com/elidyizzy/GENIA-SQUAD-OS) — {{SETUP_DATE}}_