arquiteto-de-empresa

Visão geral da skill arquiteto-de-empresa

Para que serve arquiteto-de-empresa

arquiteto-de-empresa é uma skill de Company Architect para transformar uma ideia de negócio ainda bruta de um fundador em um pacote OKF: uma árvore de arquivos Markdown versionável, com YAML frontmatter, conceitos tipados, links cruzados, painéis em index.md e um log.md somente para acréscimos. Ela é mais indicada para fundadores, operadores, consultores e equipes de planejamento estratégico que precisam de uma base de conhecimento da empresa legível tanto por pessoas quanto por agentes de IA, sem necessidade de “tradução” entre formatos.

Casos de uso e perfis mais indicados

Use a skill arquiteto-de-empresa quando precisar construir ou reorganizar uma empresa “como código”: estratégia, mercado, finanças, vendas, marketing, produto, operações, tecnologia, pessoas, jurídico e governança em uma estrutura única e conectada. Ela se encaixa bem em desenho de ventures em estágio inicial, documentação de modelo de negócio, wikis internas, sistemas operacionais empresariais legíveis por IA e uso de arquiteto-de-empresa para Strategic Planning, especialmente quando as decisões precisam continuar rastreáveis ao longo do tempo.

O que a diferencia de um prompt comum

Um prompt genérico pode gerar um plano de negócios longo. Esta skill, em vez disso, conduz uma entrevista por fases e materializa a resposta em arquivos: um conceito por .md, valores de type controlados, links relativos, arquivos reservados index.md e log.md, além de scripts auxiliares determinísticos. O diferencial principal não é apenas o aconselhamento de negócio; é um formato repetível de documentação que pode ser validado por linter, indexado, commitado no Git e ampliado por outros agentes.

Pontos de atenção antes de adotar

A skill funciona melhor quando você está disposto a responder perguntas fase por fase. Ela não é a melhor escolha se você quer um pitch deck de uma página, aconselhamento jurídico, garantias financeiras ou uma estratégia empresarial pronta sem participação do fundador. Alguns nomes de pastas e arquivos seguem um estilo em português, enquanto a linguagem da skill é inglês; por isso, a equipe deve decidir cedo se vai preservar a estrutura original ou localizar as convenções de nomenclatura.

Como usar a skill arquiteto-de-empresa

Instalação de arquiteto-de-empresa e verificação do repositório

Instale com:

npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa

Depois revise o caminho de origem:

c-level-advisor/skills/arquiteto-de-empresa

Leia primeiro SKILL.md para entender a persona, as condições de acionamento, as regras de operação e o fluxo em 12 fases. Em seguida, inspecione references/phase_playbook.md, references/okf_conformance.md e references/type_vocabulary.md; esses arquivos definem o que o agente deve perguntar, como o pacote Markdown precisa ser estruturado e quais valores de type no frontmatter são válidos. Antes de gerar arquivos reais da empresa, visualize assets/frontmatter_template.md, assets/index_template.md e assets/log_template.md.

Entradas que geram resultados melhores

O padrão de uso de arquiteto-de-empresa funciona melhor quando a primeira solicitação traz contexto de negócio suficiente para iniciar a Phase 0. Inclua estágio, modelo de negócio, setor, jurisdição, cliente, ativos atuais e o local de saída desejado.

Prompt fraco:

“Help me structure my startup.”

Prompt mais forte:

“Use arquiteto-de-empresa to create an OKF bundle for a B2B SaaS in Brazil that helps small clinics reduce missed appointments. Stage: MVP with 5 pilot customers. Model: monthly subscription. Need the first phases only: discovery, foundation, strategy, and market. Ask me questions in small blocks, mark unknowns as [ASSUMPTION], and generate conformant Markdown files with relative links.”

Isso melhora o resultado porque a skill consegue escolher a fase adequada, evitar detalhamento prematuro e criar arquivos que seguem as regras do OKF.

Fluxo de trabalho sugerido para um pacote OKF completo

Comece pela Phase 0 de descoberta e avance pelo playbook de 12 fases em ordem. Em cada fase, faça de 3 a 5 perguntas, confirme as respostas do fundador, gere os arquivos de conceito, atualize o index.md da pasta e adicione uma entrada de decisão em log.md. Não peça ao agente para despejar todas as fases de uma vez, a menos que você só precise de um protótipo aproximado; a skill foi desenhada para reduzir estratégia alucinada entrevistando antes de escrever.

Para planejamento estratégico, execute as fases na ordem das decisões: fundação, estratégia, mercado, modelo financeiro, vendas, marketing, produto, operações, tecnologia, pessoas, jurídico e governança. Mantenha afirmações ainda não resolvidas visíveis com [ASSUMPTION], para que o pacote funcione como um sistema de planejamento, não como um gerador de falsas certezas.

Uso dos scripts auxiliares

O repositório inclui ferramentas em Python que tornam a saída mais confiável. Use scripts/scaffold_bundle.py para criar um esqueleto, scripts/okf_linter.py para verificar conformidade e scripts/index_generator.py para regenerar tabelas de conceitos em index.md. Os scripts são orientados à biblioteca padrão e apoiam um fluxo com Git: gerar, revisar diffs, rodar lint e então commitar. Se o agente criar arquivos manualmente, ainda assim rode o linter antes de tratar o pacote como canônico.

FAQ da skill arquiteto-de-empresa

arquiteto-de-empresa serve apenas para empresas novas?

Não. Ela é apresentada em torno da criação de uma empresa do zero, mas também pode documentar uma empresa existente cujo conhecimento esteja espalhado por documentos, planilhas, conversas e memória dos fundadores. Para um negócio em operação, comece informando ao agente o que já existe e peça que ele separe fatos legados, suposições e evidências ausentes.

Qual é a diferença para um gerador de plano de negócios?

Um gerador de plano de negócios normalmente produz um único documento narrativo. A skill arquiteto-de-empresa produz um grafo de conhecimento OKF: muitos arquivos Markdown pequenos de conceitos, com metadados e links consistentes. Isso a torna melhor para manutenção de longo prazo, recuperação por IA, diffs no Git e planejamento multifuncional. Ela é menos conveniente se você só precisa de um PDF polido para investidores.

Iniciantes precisam entender OKF antes?

Não, mas devem entender a ideia operacional: um arquivo por conceito, frontmatter tipado, links entre arquivos relacionados e um log de decisões. Ler references/okf_conformance.md antes de uso intensivo evita erros comuns, como juntar vários conceitos em um único arquivo ou usar rótulos de type inconsistentes.

Quando não devo usar esta skill?

Não a use como substituta de revisão profissional jurídica, tributária, contábil ou de setores regulados. Evite usá-la quando a equipe não consegue responder perguntas básicas de descoberta, quando o objetivo é apenas texto de marca ou quando você precisa de modelagem financeira confidencial sem um ambiente de execução seguro. A skill estrutura decisões; ela não valida, sozinha, a verdade do mercado.

Como melhorar a skill arquiteto-de-empresa

Melhore os resultados de arquiteto-de-empresa com mais contexto

A melhoria de maior impacto é aumentar a qualidade da entrada. Forneça restrições reais: orçamento, runway, geografia, cliente-alvo, movimento de vendas, hipóteses de preço, capacidade da equipe, stack tecnológica, exposição regulatória e documentos existentes. Peça ao agente para separar seções de “known”, “assumed” e “to validate” dentro de cada arquivo de conceito. Isso torna o pacote OKF útil para planejamento estratégico, não apenas para documentação descritiva.

Falhas comuns que merecem atenção

Fique atento a arquivos comprimidos demais, frontmatter ausente, valores de type inválidos, links relativos fracos e páginas index.md que não refletem o conteúdo real das pastas. Outro problema comum é linguagem de negócio confiante demais quando o fundador ainda não forneceu evidências. Exija marcadores [ASSUMPTION] e atualize log.md sempre que uma decisão importante mudar.

Itere depois do primeiro pacote gerado

Depois da primeira versão, revise o pacote como se fosse um backlog de produto. Pergunte: quais conceitos estão grandes demais? Quais afirmações não têm evidência? Quais decisões precisam de alternativas e justificativa? Quais links ajudariam um agente futuro a navegar da estratégia para finanças, produto ou operações? Em seguida, peça à skill para dividir arquivos grandes demais, adicionar links de conceitos ausentes, regenerar índices e registrar as mudanças no log de decisões.

Estenda a skill para sua organização

Equipes podem melhorar arquiteto-de-empresa adicionando templates específicos da empresa, checklists de jurisdição, vocabulário do setor e gates de validação. Mantenha estáveis as regras centrais do OKF: um conceito por arquivo, type obrigatório, links relativos, index.md e log.md reservados e verificações baseadas em scripts. Se você localizar nomes de pastas ou adicionar novos tipos de conceito, atualize references/type_vocabulary.md para que agentes futuros continuem consistentes.