{
  "markdown": "# WriteTextAmp Workspace - Marketing Content Studio\n\n**Workspace completo de marketing com orquestração inteligente de agents, subagents e skills.**\n\n> **CLIs Suportados:** OpenCode • Claude Code • Gemini CLI • Codex CLI • Antigravity  \n> Leia `docs/MULTI-CLI-SUPPORT.md` para instruções de cada CLI.\n\n---\n\n## 🚀 Início Rápido\n\n### Passo 1: Execute o Bootstrap\n\nO bootstrap configura automaticamente todo o workspace:\n\n1. **Abra o PowerShell como Administrador**\n   - Clique com botão direito no PowerShell\n   - Selecione \"Executar como Administrador\"\n\n2. **Navegue até o diretório do workspace**\n   ```powershell\n   cd D:\\GitHub\\WriteTextAmpWorkscpase\n   ```\n\n3. **Execute o script de bootstrap**\n   ```powershell\n   .\\bootstrap.ps1\n   ```\n\n4. **Siga as instruções na tela**\n   - O script vai verificar e instalar Node.js, Python, Git\n   - Vai instalar OpenCode CLI\n   - Vai abrir a GUI de configuração\n   - Selecione quais MCPs quer usar\n   - Preencha API keys quando necessário\n   - Clique em \"Instalar e Finalizar\"\n\n### Passo 2: Configure as Contas e API Keys\n\n**⚠️ IMPORTANTE:** Antes de continuar, leia sobre custos reais:\n\n| Documento | Descrição |\n|-----------|-----------|\n| **[docs/REAL-COSTS.md](docs/REAL-COSTS.md)** | 💰 **LEIA PRIMEIRO** — O que REALMENTE custa dinheiro |\n| [docs/COSTS-AND-ACCOUNTS.md](docs/COSTS-AND-ACCOUNTS.md) | Guia completo de custos e contas |\n\n**Resumo rápido:**\n- ✅ **100% Grátis (sem conta):** document-generator, pdf-toolkit, Docling, Open Design\n- ⚠️ **Free Tier (precisa conta grátis):** FLUX (~100 imagens/mês), Brave Search (2000 queries/mês)\n- 💲 **Pago:** Twitter API ($100/mês), SEOcrawl ($29/mês), OpenSEO ($19/mês)\n- 💡 **Dica:** Comece 100% grátis. Só pague depois de usar e ver o que precisa.\n\n### Passo 3: Crie Seu Primeiro Projeto\n\n```powershell\n# Copie o template\nCopy-Item -Path \"projetos\\_modelo\" -Destination \"projetos\\meu-primeiro-projeto\" -Recurse\n\n# Entre no diretório do projeto\ncd projetos\\meu-primeiro-projeto\n\n# Inicie o OpenCode\nopencode\n```\n\n### Passo 4: Comece a Criar Conteúdo\n\n```\n@marketing-orchestrator \"Preciso de uma campanha completa de lançamento para o Produto X\"\n```\n\nO orquestrador automaticamente:\n- 🧠 Faz brainstorming para refinar escopo\n- 📋 Cria plano detalhado\n- ⚡ Executa com subagents especializados\n- ✅ Revisa qualidade\n- 🎁 Entrega pacote final\n\n---\n\n## 📚 Documentação Completa\n\n### Para Usuários\n\n| Documento | Descrição | Quando Ler |\n|-----------|-----------|------------|\n| **README.md** (este) | Visão geral e início rápido | Sempre |\n| **QUICKSTART.md** | Guia rápido de 5 minutos | Primeira vez |\n| **WORKSPACE.md** | Guia completo de uso | Uso diário |\n| **docs/COSTS-AND-ACCOUNTS.md** | 💰 Custos e contas necessárias | Antes de configurar |\n| **docs/ORCHESTRATOR-GUIDE.md** | Como usar o orquestrador | Projetos complexos |\n| **docs/USER-GUIDE.md** | Guia completo do usuário | Referência |\n| **docs/MCP-CONFIGURATION.md** | Configuração de MCPs e serviços | Configurar ferramentas |\n| **docs/DOCLING-GUIDE.md** | Guia do Docling | Processar documentos |\n| **docs/OPEN-DESIGN-GUIDE.md** | Guia do Open Design | Criar visuais |\n\n### Para Desenvolvedores\n\n| Documento | Descrição |\n|-----------|-----------|\n| **AGENTS.md** | Informações técnicas do workspace |\n| **docs/ARCHITECTURE.md** | Arquitetura do sistema |\n| **docs/MCP-INTEGRATION.md** | Como integrar novos MCPs |\n\n---\n\n## 🏗️ Estrutura do Workspace\n\n```\nWriteTextAmpWorkscpase/\n│\n├── 📄 README.md                          # Visão geral (este arquivo)\n├── 📄 AGENTS.md                          # Informações técnicas\n├── 📄 WORKSPACE.md                       # Guia completo de uso\n├── 📄 QUICKSTART.md                      # Início rápido\n├── 📄 bootstrap.ps1                      # ⭐ Script de bootstrap\n├── 📄 opencode.jsonc                     # Configuração de MCPs\n├── 📄 .env                               # API keys (gerado pela GUI)\n├── 📄 .env.template                      # Template de configuração\n├── 📄 .gitignore                         # Ignora arquivos desnecessários\n│\n├── 📁 docs/\n│   ├── 📄 ORCHESTRATOR-GUIDE.md          # Guia do orquestrador\n│   ├── 📄 USER-GUIDE.md                  # Guia do usuário\n│   ├── 📄 ARCHITECTURE.md                # Arquitetura\n│   └── 📄 MCP-INTEGRATION.md             # Integração de MCPs\n│\n├── 📁 .opencode/\n│   ├── 📁 instructions/                  # Instruções obrigatórias\n│   │   ├── 📄 using-marketing-workspace.instructions.md  # ⭐ Inicial\n│   │   ├── 📄 bootstrap-guide.instructions.md  # ⭐ Guia para IA\n│   │   ├── 📄 content-to-visual.instructions.md\n│   │   ├── 📄 copywriting-framework.instructions.md\n│   │   ├── 📄 brand-voice.instructions.md\n│   │   ├── 📄 content-formats.instructions.md\n│   │   ├── 📄 visual-marketing.instructions.md\n│   │   └── 📄 git-workflow.instructions.md\n│   │\n│   ├── 📁 agents/\n│   │   ├── 📄 marketing-orchestrator.agent.md\n│   │   └── 📁 subagents/ (5 subagents)\n│   │\n│   ├── 📁 skills/\n│   │   ├── 📁 brainstorming-content/\n│   │   ├── 📁 writing-content-plan/\n│   │   ├── 📁 executing-content-plan/\n│   │   ├── 📁 reviewing-content/\n│   │   ├── 📁 finishing-content-project/\n│   │   ├── 📁 decision-router/\n│   │   ├── 📁 materialize-content/\n│   │   ├── 📁 open-design-workflow/\n│   │   └── 📁 [5 skills de produção]\n│   │\n│   └── 📁 templates/\n│       └── 📄 open-design-prompts.md\n│\n├── 📁 _templates/                        # Templates reutilizáveis\n│   ├── 📄 briefing.md\n│   ├── 📄 brand-voice-card.md\n│   ├── 📄 persona.md\n│   └── 📄 content-brief.md\n│\n├── 📁 projetos/                          # Projetos isolados\n│   ├── 📁 _modelo/                       # Template para novos projetos\n│   └── 📁 [seus-projetos]/\n│\n└── 📁 scripts/\n    ├── 📄 setup.ps1                      # Setup automático\n    ├── 📄 configure.py                   # Configuração CLI\n    └── 📄 configure-gui.py               # ⭐ GUI de configuração\n```\n\n---\n\n## 🤖 Sistema de Orquestração\n\n### Instruction Inicial (Obrigatória)\n\n**`using-marketing-workspace.instructions.md`** é carregada automaticamente e força o uso do sistema:\n\n1. **SEMPRE** use decision-router para analisar solicitações\n2. **SEMPRE** faça brainstorming para projetos complexos\n3. **SEMPRE** maximize conteúdo textual antes de materializar\n4. **SEMPRE** use subagents para tarefas especializadas\n5. **SEMPRE** siga o workflow completo\n\n### Agents e Subagents\n\n**Marketing Orchestrator** (coordenador central):\n- Recebe solicitações complexas\n- Decompõe em tarefas\n- Delega para subagents\n- Valida qualidade\n- Entrega pacote final\n\n**5 Subagents Especializados**:\n- Content Creator → artigos, blogs, whitepapers\n- Visual Designer → imagens, banners, visuais\n- Social Media Manager → posts, calendários\n- Document Generator → PDFs, Word, apresentações\n- Email Marketing → sequências, newsletters\n\n### Workflow Completo\n\n```\n1. decision-router → analisa solicitação\n2. brainstorming-content → refina ideias (se complexo)\n3. writing-content-plan → cria plano\n4. executing-content-plan → executa com subagents\n5. reviewing-content → valida qualidade\n6. finishing-content-project → finaliza e entrega\n```\n\n---\n\n## 🛠️ MCPs e Serviços\n\n### Configuração Automática\n\nO `bootstrap.ps1` configura automaticamente todos os MCPs:\n\n- ✅ **Docling** - Processamento de documentos (inicia automaticamente no login)\n- ✅ **Open Design** - Prototipagem visual local (com modelos de imagem AI)\n- ✅ **FLUX** - Geração de imagens AI (Black Forest Labs)\n- ✅ **Pictify** - Templates HTML para imagens\n- ✅ **ChangeImageTo** - 16 ferramentas de edição de imagem\n- ✅ **Chompute** - Remoção de fundo automática\n- ✅ **Nano Banana** - Edição com Google Gemini\n\n### Configuração Manual\n\nConsulte `docs/MCP-CONFIGURATION.md` para:\n- Configurar API keys\n- Inicialização manual de serviços\n- Troubleshooting\n- Verificação de status\n\n### Docling (Inicialização Automática)\n\nO Docling é configurado para iniciar automaticamente no login do Windows:\n\n```powershell\n# Verificar status\n.\\scripts\\setup-docling-startup.ps1 -Status\n\n# Remover inicialização automática\n.\\scripts\\setup-docling-startup.ps1 -Remove\n\n# Iniciar manualmente\npython scripts\\start-docling-server.py\n```\n\n**Acesso:**\n- API: http://localhost:8000\n- Documentação: http://localhost:8000/docs\n- Health: http://localhost:8000/health\n\n### Open Design\n\nInstalado automaticamente em `tools/open-design/` a partir da **última release do GitHub**:\n\n```powershell\n# Iniciar\ncd tools\\open-design\n.\\start.ps1\n```\n\n**Acesso:** http://localhost:3000\n\n**Instalação:**\n- O script `install-open-design.ps1` consulta a API do GitHub\n- Baixa a última release disponível (asset para Windows)\n- Extrai e configura localmente\n- Configura modelos de imagem AI\n\n**Modelos configurados:**\n- FLUX (flux-1.1-pro, flux-1.1-pro-ultra, flux-1.1-dev)\n- Pictify (templates HTML)\n- ChangeImageTo (edição)\n- Chompute (remoção de fundo)\n- Nano Banana (edição com Gemini)\n\n---\n\n## 🔒 Segurança e Git\n\n### Dados Sensíveis\n\nO workspace usa `.gitignore` para proteger dados sensíveis:\n\n```gitignore\n# API keys e configurações\n.env\n.env.local\n.env.*.local\n\n# Dados de projetos\nprojetos/*/output/\nprojetos/*/.orchestrator/\nprojetos/*/.brainstorming/\nprojetos/*/.planos/\n\n# Credenciais\n*.key\n*.pem\n*.p12\n```\n\n### Git Workflow Seguro\n\nO sistema segue `git-workflow.instructions.md`:\n\n1. **Commit automático** após entregas importantes\n2. **Nunca commita** `.env` ou dados sensíveis\n3. **Usa branches** para projetos isolados\n4. **Tags** para versões estáveis\n5. **Backup automático** em momentos críticos\n\n---\n\n## 🎨 Materialização de Conteúdo\n\n### Princípio Fundamental\n\n**\"Maximize conteúdo textual antes de materializar visualmente.\"**\n\n### Workflow de Materialização\n\n```\n1. Complete TODO o conteúdo textual\n2. Valide com checklist de maximização\n3. Mapeie seções → componentes\n4. Escolha ferramenta (Open Design, FLUX, Pictify)\n5. Materialize visualmente\n6. Exporte e entregue\n```\n\n### Quando Usar Cada Ferramenta\n\n| Tipo de Entrega | Ferramenta Principal |\n|----------------|---------------------|\n| Landing Page | Open Design |\n| Apresentação | Open Design |\n| Dashboard | Open Design |\n| Email Template | Open Design |\n| Banner/Ad | FLUX ou Pictify |\n| Social Media Post | Pictify ou FLUX |\n| Whitepaper | Open Design + document-generator |\n| Relatório | document-generator |\n\n---\n\n## 📊 Estatísticas do Workspace\n\n- **45+ arquivos** criados\n- **~250 KB** de conteúdo\n- **1 Orchestrator** agent\n- **5 Subagents** especializados\n- **13 Skills** (8 workflow + 5 produção)\n- **8 Instructions** (diretrizes)\n- **4 Templates** reutilizáveis\n- **3 Scripts** de setup (PowerShell + Python CLI + Python GUI)\n- **20+ MCPs** configurados\n\n---\n\n## 🚨 Troubleshooting\n\n### Bootstrap falhou\n\n```powershell\n# Verifique se está como Administrador\n# Clique com botão direito no PowerShell → \"Executar como Administrador\"\n\n# Tente novamente com Force\n.\\bootstrap.ps1 -Force\n```\n\n### GUI não abre\n\n```powershell\n# Instale Python\n# Download: https://www.python.org/downloads/\n\n# Ou use modo sem GUI\n.\\bootstrap.ps1 -SkipGUI\n\n# Depois configure .env manualmente\nCopy-Item .env.template .env\nnotepad .env\n```\n\n### MCP não funciona\n\n1. Verifique se está habilitado em `.env`\n2. Verifique se API key está correta\n3. Execute `powershell -File scripts/setup.ps1` novamente\n\n### Subagent não responde\n\n1. Verifique se o agent está em `.opencode/agents/`\n2. Verifique se o nome está correto\n3. Reinicie o OpenCode\n\n### Projeto não está isolado\n\n1. Certifique-se de estar no diretório do projeto\n2. Não trabalhe no diretório raiz do workspace\n\n---\n\n## 📞 Suporte\n\nPara dúvidas ou problemas:\n- Leia `docs/USER-GUIDE.md` para guia completo\n- Consulte `docs/ORCHESTRATOR-GUIDE.md` para uso avançado\n- Abra uma issue no GitHub\n\n---\n\n## 🎓 Filosofia do Sistema\n\nInspirado no **Superpowers**, o sistema segue:\n\n1. **Brainstorming antes de executar** — Refine ideias antes de gastar recursos\n2. **Planejamento detalhado** — Decomponha em tarefas pequenas e claras\n3. **Execução via subagents** — Delegue para especialistas, mantenha contexto limpo\n4. **Revisão constante** — Valide qualidade em cada etapa\n5. **Documentação completa** — Ledger de progresso, decisões, aprendizados\n\n**Princípio central:** \"Nunca execute tarefas diretamente. Seu papel é coordenar, não executar.\"\n\n---\n\n**Workspace completo com orquestração inteligente, pronto para criar campanhas de marketing profissionais de forma ágil e consistente!**\n",
  "bytes": 12401,
  "sha": "f24a3d499e16d382b63eff365af14c1c1c9ade25ae00b942bbb498d76e13c820",
  "repo_slug": "joaorura/writetextampworkscpase",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_joaorura_writetextampworkscpase_54fde37a/readme"
}