arquiteto-de-empresa
por alirezarezvaniarquiteto-de-empresa convierte la idea de negocio de un fundador en un bundle OKF en Markdown con control de versiones, frontmatter, enlaces cruzados, index.md, log.md y una entrevista de 12 fases que cubre estrategia, mercado, finanzas, producto, operaciones, aspectos legales y gobernanza. Incluye plantillas, además de scripts Python para scaffold, linter e indexación.
Esta skill obtiene 84/100, lo que la convierte en una candidata sólida para usuarios del directorio que buscan un flujo guiado por agente para convertir una entrevista con el fundador en una base de conocimiento empresarial versionable. Ofrece suficiente orientación de activación, estructura por fases, plantillas, referencias y scripts como para aportar bastante más valor que un prompt genérico de planificación de negocios, aunque la instalación y las expectativas de idioma y nomenclatura necesitan un empaquetado más claro.
- Alta capacidad de activación: el frontmatter menciona explícitamente casos de uso como crear una empresa desde cero, company-as-code, bundles OKF y wikis empresariales legibles por IA.
- Sólida en lo operativo: el playbook de 12 fases referenciado define objetivos, preguntas, artefactos generados y pasos de actualización para cada fase, en lugar de apoyarse en un prompt genérico de asesoría empresarial.
- Buen apalancamiento para agentes: las reglas de conformidad OKF, un vocabulario de tipos controlado, plantillas, un bundle de ejemplo y herramientas Python para scaffold, linting y generación de índices hacen que los resultados sean más estructurados y reutilizables.
- No hay README ni comando de instalación en el directorio de la skill, por lo que los usuarios deben deducir la instalación a partir del repositorio o las herramientas generales.
- La estructura del bundle usa nombres de carpetas y archivos en portugués, mientras que la descripción de la skill indica que opera en inglés; conviene aclarar esas expectativas de idioma y nomenclatura antes de adoptarla.
Descripción general de arquiteto-de-empresa skill
Para qué sirve arquiteto-de-empresa
arquiteto-de-empresa es una skill de Company Architect para convertir una idea de negocio inicial de una persona fundadora en un paquete OKF: un árbol de archivos Markdown versionable, con YAML frontmatter, conceptos tipados, enlaces cruzados, paneles index.md y un log.md solo de adición. En lugar de producir un plan de negocio de una sola vez, la skill ejecuta una entrevista por fases y materializa la empresa como conocimiento estructurado que pueden leer tanto personas como agentes de IA.
Usuarios y decisiones para los que encaja mejor
Esta skill es especialmente útil para founders, operadores tipo chief of staff, venture studios, consultores y equipos de planificación estratégica que necesitan una base de conocimiento viva de la empresa, no solo una narrativa para pitch. Encaja con el diseño de empresas en etapas tempranas, la documentación del modelo de negocio, la creación de un sistema operativo empresarial y flujos de trabajo de “company as code”. arquiteto-de-empresa for Strategic Planning resulta especialmente valioso cuando quieres conectar en un mismo repositorio decisiones de estrategia, mercado, finanzas, ventas, marketing, producto, operaciones, tecnología, personas, legal y gobernanza.
Qué hace diferente a esta skill
El principal diferenciador es la estructura. La skill sigue un playbook de 12 fases, hace pocas preguntas a la vez y escribe un concepto por cada archivo .md usando un vocabulario controlado de type. Esto hace que el resultado sea más fácil de comparar en Git, validar, indexar y reutilizar por otros agentes. Las referencias incluidas y los scripts de Python ayudan a crear el scaffolding, revisar la conformidad con OKF y regenerar tablas de índice.
Cuándo puede ser demasiado
No instales arquiteto-de-empresa skill si solo necesitas un SWOT rápido, un brief para una landing page o un memo breve para inversores. El método es intencionalmente sistemático. Funciona mejor cuando estás dispuesto a responder preguntas por etapas, mantener archivos y tratar las suposiciones como conocimiento en borrador, no como una verdad final.
Cómo usar arquiteto-de-empresa skill
Instala e inspecciona primero el repositorio
Para un flujo de trabajo de Claude skills, instala desde el repositorio con:
npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa
Si tu herramienta no admite ese comando, copia o referencia la carpeta de la skill desde c-level-advisor/arquiteto-de-empresa/skills/arquiteto-de-empresa. Antes de usarla en serio, lee SKILL.md, luego references/phase_playbook.md, references/okf_conformance.md y references/type_vocabulary.md. Revisa también assets/frontmatter_template.md, assets/index_template.md y assets/log_template.md para entender el contrato de archivos que se espera que el agente cumpla.
Empieza con un prompt de descubrimiento completo
Un buen arquiteto-de-empresa usage empieza con contexto, no con una petición vaga. En lugar de “construye mi empresa”, proporciona los datos iniciales que necesita el descubrimiento de la Fase 0:
- idea de empresa y problema del cliente
- etapa: idea, MVP, operativa o en escalamiento
- modelo de negocio: servicio, SaaS, marketplace, producto, híbrido
- sector, país y jurisdicción legal
- nombre existente, activos, restricciones y supuestos conocidos
- ubicación de salida deseada, por ejemplo
./my-company-okf
Un prompt más sólido sería: “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.”
Sigue el flujo de 12 fases, no pidas un volcado
La skill está diseñada para entrevistar en orden: descubrimiento, fundamentos, estrategia, mercado, finanzas, ventas, marketing, producto, operaciones, tecnología, personas, legal y gobernanza. Pide al agente que complete una fase, confirme los conceptos generados, actualice el index.md raíz y añada una entrada a log.md antes de pasar a la siguiente. Esto evita resultados superficiales o inconsistentes y mantiene trazables las decisiones estratégicas.
Usa los scripts auxiliares para controlar la calidad
El repositorio incluye scripts/scaffold_bundle.py, scripts/okf_linter.py y scripts/index_generator.py. Úsalos como apoyo de implementación después de que el agente redacte el contenido. El linter es importante porque la calidad de OKF depende de detalles concretos: cada concepto debe estar en un archivo Markdown separado, el frontmatter debe incluir un type válido y los enlaces deben formar un grafo útil, no documentos aislados.
FAQ de arquiteto-de-empresa skill
¿arquiteto-de-empresa es solo para empresas nuevas?
No. Es más potente para crear una empresa desde cero, pero también puede documentar una empresa existente si proporcionas la estrategia actual, procesos, herramientas, finanzas y detalles de la organización. Para una empresa en operación, pide a la skill que distinga entre “estado actual”, “estado objetivo” y elementos [ASSUMPTION] para que el paquete no reescriba la realidad como si fuera una aspiración.
¿En qué mejora a un prompt normal de plan de negocio?
Un prompt normal suele devolver un documento pulido pero plano. arquiteto-de-empresa produce un sistema de conocimiento navegable: conceptos Markdown tipados, índices reservados, registros de decisiones y enlaces cruzados. Eso importa si quieres que agentes futuros recuperen conocimiento de la empresa, actualicen un concepto sin reescribirlo todo o rastreen cómo cambiaron las decisiones con el tiempo.
¿Necesito conocer OKF antes de usarla?
No, pero conviene leer la referencia de conformidad OKF antes de confiar en el resultado. Las reglas clave son simples: un concepto por archivo, YAML frontmatter con un type válido, index.md y log.md reservados, enlaces relativos entre conceptos y supuestos marcados con claridad. Las personas principiantes pueden usar bien la skill si siguen la entrevista por fases en lugar de pedir todos los archivos de una vez.
¿Cuándo no debería usar esta skill?
Evita esta skill cuando la velocidad importe más que la estructura, cuando el negocio sea demasiado confidencial para compartirlo en un entorno de IA o cuando necesites asesoría legal vinculante. Puede organizar conceptos legales y de gobernanza, pero no sustituye a abogados, contadores ni revisiones de cumplimiento específicas de una jurisdicción.
Cómo mejorar arquiteto-de-empresa skill
Mejora los inputs de arquiteto-de-empresa antes de generar archivos
La mayor palanca de calidad es la especificidad del input. Proporciona restricciones reales: rango de presupuesto, cliente objetivo, geografía, habilidades del equipo fundador, tracción actual, hipótesis de precios, modelo de ventas, riesgos regulatorios y preferencias tecnológicas. Si algo se desconoce, dilo. La convención [ASSUMPTION] de la skill solo es útil cuando el agente sabe qué datos faltan.
Evita los fallos comunes de OKF
Presta atención a archivos que mezclan varios conceptos, valores type ausentes, descripciones genéricas, enlaces relativos rotos y afirmaciones estratégicas que no estén conectadas con supuestos de mercado o financieros. Pide al agente que haga una revisión de conformidad después de cada fase: “Check every generated concept against references/okf_conformance.md and references/type_vocabulary.md; list fixes before rewriting.”
Itera los resultados de cada fase con criterios de decisión
Después de cada fase, revisa si el resultado ayuda a decidir. Una buena fase de fundamentos debe aclarar propósito, problema, valores y supuestos. Una buena fase financiera debe exponer el modelo de ingresos, la estructura de costos, la economía unitaria, los precios y las proyecciones. Una buena fase de operaciones debe producir procesos y runbooks que alguien pueda ejecutar. Si el resultado suena a copy de marketing, pide tradeoffs más claros, dependencias y alternativas descartadas.
Extiende la skill para tu modelo operativo
Para mejorar arquiteto-de-empresa en tu organización, añade plantillas específicas de la empresa, extensiones del vocabulario de tipos o checklists de revisión sin romper los fundamentos de OKF. Por ejemplo, una startup de salud regulada podría añadir campos de evidencia de cumplimiento; un venture studio podría añadir el estado ante el comité de inversión; un equipo SaaS podría enlazar PRD con archivos de roadmap y arquitectura. Mantén las extensiones explícitas para que futuros agentes puedan entender el paquete sin depender de convenciones ocultas.