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, dashboards em index.md e um log.md append-only. Em vez de gerar um plano de negócios pontual, a skill conduz uma entrevista em fases e materializa a empresa como conhecimento estruturado, legível por pessoas e por agentes de IA.

Usuários e decisões para os quais faz mais sentido

Esta skill é mais indicada para fundadores, operadores de chief-of-staff, venture studios, consultores e equipes de planejamento estratégico que precisam de uma base viva de conhecimento da empresa, não apenas de uma narrativa para pitch. Ela se encaixa bem em desenho de empresas em estágio inicial, documentação de modelo de negócio, criação de sistema operacional da empresa e fluxos de “company as code”. arquiteto-de-empresa for Strategic Planning é especialmente útil quando você quer conectar, em um único repositório, decisões de estratégia, mercado, finanças, vendas, marketing, produto, operações, tecnologia, pessoas, jurídico e governança.

O que diferencia esta skill

O principal diferencial é a estrutura. A skill segue um playbook de 12 fases, faz poucas perguntas por vez e grava um conceito por arquivo .md usando um vocabulário controlado de type. Isso torna a saída mais fácil de comparar no Git, validar, indexar e reutilizar por outros agentes. As referências e os scripts Python incluídos dão suporte a scaffolding, linting de conformidade OKF e regeneração de tabelas de índice.

Quando pode ser estrutura demais

Não instale arquiteto-de-empresa skill se você só precisa de uma SWOT rápida, um briefing de landing page ou um memorando curto para investidores. O método é intencionalmente sistemático. Ele funciona melhor quando você está disposto a responder perguntas por etapas, manter arquivos e tratar premissas como conhecimento em rascunho, não como verdade final.

Como usar arquiteto-de-empresa skill

Instale e inspecione o repositório primeiro

Para um fluxo de Claude skills, instale a partir do repositório com:

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

Se a sua ferramenta não oferecer suporte a esse comando, copie ou referencie a pasta da skill em c-level-advisor/arquiteto-de-empresa/skills/arquiteto-de-empresa. Antes de usar a sério, leia SKILL.md, depois references/phase_playbook.md, references/okf_conformance.md e references/type_vocabulary.md. Confira também assets/frontmatter_template.md, assets/index_template.md e assets/log_template.md para entender o contrato de arquivos que se espera que o agente cumpra.

Comece com um prompt completo de descoberta

Um bom arquiteto-de-empresa usage começa com contexto, não com um pedido vago. Em vez de “crie minha empresa”, forneça os fatos iniciais de que a descoberta da Phase 0 precisa:

• ideia da empresa e problema do cliente
• estágio: ideia, MVP, operação ou escala
• modelo de negócio: serviço, SaaS, marketplace, produto, híbrido
• setor, país e jurisdição legal
• nome existente, ativos, restrições e premissas já conhecidas
• local desejado para a saída, por exemplo ./my-company-okf

Um prompt mais forte seria: “Use arquiteto-de-empresa to create an OKF bundle for a B2B SaaS in Brazil that helps clinics reduce no-shows. We are at MVP stage, have no legal entity yet, and want files suitable for Git. Run Phase 0 first, ask only the necessary questions, mark unknowns as [ASSUMPTION], then scaffold the bundle.”

Siga o fluxo de 12 fases, não peça um despejo de conteúdo

A skill foi projetada para entrevistar em ordem: descoberta, fundação, estratégia, mercado, finanças, vendas, marketing, produto, operações, tecnologia, pessoas, jurídico e governança. Peça ao agente para concluir uma fase, confirmar os conceitos gerados, atualizar o index.md raiz e anexar entradas ao log.md antes de avançar. Isso evita uma saída rasa e inconsistente e mantém as decisões estratégicas rastreáveis.

Use os scripts auxiliares para controle de qualidade

O repositório inclui scripts/scaffold_bundle.py, scripts/okf_linter.py e scripts/index_generator.py. Use-os como apoio de implementação depois que o agente rascunhar o conteúdo. O linter é importante porque a qualidade do OKF depende de detalhes: cada conceito deve estar em um arquivo Markdown separado, o frontmatter deve incluir um type válido, e os links devem formar um grafo utilizável, não documentos isolados.

FAQ da skill arquiteto-de-empresa

arquiteto-de-empresa serve apenas para empresas novas?

Não. Ela é mais forte para criar um negócio do zero, mas também pode documentar uma empresa existente se você fornecer estratégia atual, processos, ferramentas, finanças e detalhes da organização. Para uma empresa em operação, peça à skill que diferencie “estado atual”, “estado desejado” e itens marcados como [ASSUMPTION], para que o pacote não reescreva a realidade como se fosse aspiração.

Em que ela é melhor do que um prompt comum de plano de negócios?

Um prompt comum muitas vezes retorna um documento polido, mas plano. arquiteto-de-empresa produz um sistema de conhecimento navegável: conceitos Markdown tipados, índices reservados, logs de decisão e links cruzados. Isso importa se você quer que agentes futuros recuperem conhecimento da empresa, atualizem um conceito sem reescrever tudo ou acompanhem como as decisões mudaram ao longo do tempo.

Preciso conhecer OKF antes de usar?

Não, mas você deve ler a referência de conformidade OKF antes de confiar na saída. As regras principais são simples: um conceito por arquivo, YAML frontmatter com um type válido, index.md e log.md reservados, links relativos entre conceitos e premissas marcadas com clareza. Iniciantes conseguem usar bem a skill se seguirem a entrevista por fases em vez de pedir todos os arquivos de uma vez.

Quando não devo usar esta skill?

Evite esta skill quando velocidade for mais importante do que estrutura, quando o negócio for confidencial demais para ser compartilhado em um ambiente de IA ou quando você precisar de aconselhamento juridicamente vinculante. Ela pode organizar conceitos jurídicos e de governança, mas não substitui advogados, contadores nem uma revisão de conformidade específica da jurisdição.

Como melhorar arquiteto-de-empresa skill

Melhore os insumos de arquiteto-de-empresa antes de gerar arquivos

A maior alavanca de qualidade é a especificidade das informações de entrada. Informe restrições reais: faixa de orçamento, cliente-alvo, geografia, habilidades dos fundadores, tração atual, hipóteses de preço, modelo de vendas, riscos regulatórios e preferências tecnológicas. Se algo for desconhecido, diga isso. A convenção [ASSUMPTION] da skill só é útil quando o agente sabe quais fatos estão faltando.

Evite modos comuns de falha em OKF

Fique atento a arquivos que combinam vários conceitos, valores de type ausentes, descrições genéricas, links relativos quebrados e afirmações estratégicas que não se conectam a premissas de mercado ou finanças. Peça ao agente para fazer uma checagem de conformidade após cada fase: “Check every generated concept against references/okf_conformance.md and references/type_vocabulary.md; list fixes before rewriting.”

Itere as saídas de cada fase com critérios de decisão

Depois de cada fase, revise se a saída ajuda a decidir. Uma boa fase de fundação deve esclarecer propósito, problema, valores e premissas. Uma boa fase de finanças deve explicitar modelo de receita, estrutura de custos, unit economics, precificação e projeções. Uma boa fase de operações deve produzir processos e runbooks que alguém conseguiria executar. Se a saída parecer texto de marketing, peça tradeoffs mais claros, dependências e alternativas rejeitadas.

Estenda a skill para o seu modelo operacional

Para melhorar arquiteto-de-empresa para a sua organização, adicione templates específicos da empresa, extensões do vocabulário de tipos ou checklists de revisão sem quebrar os fundamentos do OKF. Por exemplo, uma startup de saúde regulada pode adicionar campos de evidência de conformidade; um venture studio pode incluir status de comitê de investimento; uma equipe SaaS pode vincular PRDs a arquivos de roadmap e arquitetura. Mantenha as extensões explícitas para que agentes futuros entendam o pacote sem depender de convenções ocultas.