Avançado: Pipeline e Mecanismos Internos

Este capítulo explica em profundidade os mecanismos centrais e funcionalidades avançadas do AI App Factory, incluindo os princípios operacionais detalhados do pipeline de 7 fases, as estratégias de escalonamento do escalonador Sisyphus, mecanismos de permissão e segurança, estratégias de tratamento de falhas, e como otimizar o contexto para economizar custos de Token.

Pré-requisitos

Antes de estudar este capítulo, certifique-se de ter concluído:

• Início Rápido e Instalação e Configuração
• Visão Geral do Pipeline de 7 Fases
• Configuração de Integração de Plataformas

Conteúdo do Capítulo

Este capítulo inclui os seguintes tópicos:

Detalhamento do Pipeline de 7 Fases

• Fase 1: Bootstrap - Estruturar Ideia de Produto

  • Aprenda a transformar ideias vagas de produto em documentos estruturados
  • Entenda o formato de entrada e saída do Bootstrap Agent

• Fase 2: PRD - Gerar Documento de Requisitos de Produto

  • Gere PRD nível MVP, incluindo histórias de usuário, lista de funcionalidades e não-objetivos
  • Domine técnicas de decomposição de requisitos e priorização

• Fase 3: UI - Design de Interface e Protótipo

  • Use a skill ui-ux-pro-max para designar estrutura de UI e protótipos visualizáveis
  • Entenda o fluxo de design de interface e melhores práticas

• Fase 4: Tech - Design de Arquitetura Técnica

  • Design arquitetura técnica mínima viável e modelo de dados Prisma
  • Domine princípios de seleção de tecnologia e design de arquitetura

• Fase 5: Code - Gerar Código Executável

  • Gere código frontend e backend, testes e configurações com base no Schema de UI e design Tech
  • Entenda o fluxo de geração de código e sistema de templates

• Fase 6: Validation - Validar Qualidade de Código

  • Valide instalação de dependências, verificação de tipos, schema Prisma e qualidade de código
  • Domine fluxos de verificação de qualidade automatizados

• Fase 7: Preview - Gerar Guia de Deploy

  • Gere documentação completa de instruções de execução e configuração de deploy
  • Aprenda integração CI/CD e configuração de Git Hooks

Mecanismos Internos

• Detalhamento do Escalonador Sisyphus

  • Entenda como o escalonador coordena o pipeline, gerencia estado e executa verificações de permissão
  • Domine estratégias de escalonamento e princípios de máquina de estado

• Otimização de Contexto: Execução por Sessão

  • Aprenda a usar o comando factory continue para economizar Tokens
  • Domine melhores práticas de criar novas sessões em cada fase

• Mecanismos de Permissão e Segurança

  • Entenda matriz de limites de capacidade, tratamento de ultrapassagem e mecanismos de verificação de segurança
  • Domine configurações de segurança e gerenciamento de permissões

• Tratamento de Falhas e Rollback

  • Aprenda identificação de falhas, mecanismos de retry, estratégias de rollback e fluxos de intervenção humana
  • Domine técnicas de troubleshooting e recuperação

Recomendações de Rota de Aprendizado

Ordem Recomendada de Estudo

1. Primeiro conclua o Pipeline de 7 Fases (em ordem)

   • Bootstrap → PRD → UI → Tech → Code → Validation → Preview
   • Cada fase tem entradas e saídas claras; aprender em ordem constrói compreensão completa

2. Depois estude o Escalonador e Otimização de Contexto

   • Entenda como o Sisyphus coordena as 7 fases
   • Aprenda a otimizar contexto para economizar custos de Token

3. Finalmente estude Segurança e Tratamento de Falhas

   • Domine limites de permissão e mecanismos de segurança
   • Entenda cenários de falha e estratégias de resposta

Foco de Estudo por Papel

Papel	Capítulos Focados
Desenvolvedor	Code, Validation, Tech, Orchestrator
Product Manager	Bootstrap, PRD, UI, Preview
Tech Lead	Tech, Code, Security, Failure Handling
DevOps Engineer	Validation, Preview, Context Optimization

Próximos Passos

Após concluir este capítulo, você pode continuar estudando:

• Perguntas Frequentes e Troubleshooting - Resolva problemas no uso prático
• Melhores Práticas - Domine técnicas de uso eficiente do Factory
• Referência de Comandos CLI - Veja lista completa de comandos
• Padrões de Código - Entenda padrões de código gerado

---

💡 Dica: Se encontrar problemas durante o uso, consulte primeiro o capítulo Perguntas Frequentes e Troubleshooting.