arquiteto-de-empresa

Descripción general de la skill arquiteto-de-empresa

Para qué sirve arquiteto-de-empresa

arquiteto-de-empresa es una skill de Company Architect para convertir una idea de negocio inicial de un fundador en un paquete OKF: un árbol de archivos Markdown versionable, con YAML frontmatter, conceptos tipados, enlaces cruzados, paneles index.md y un log.md de solo anexado. Es especialmente útil para fundadores, operadores, consultores y equipos de planificación estratégica que necesitan una base de conocimiento de empresa legible tanto para personas como para agentes de IA, sin tener que “traducir” la información a otro formato.

Casos de uso y perfiles donde encaja mejor

Usa la skill arquiteto-de-empresa cuando necesites construir o reorganizar una empresa “as code”: estrategia, mercado, finanzas, ventas, marketing, producto, operaciones, tecnología, personas, legal y gobernanza dentro de una estructura conectada. Encaja bien en el diseño de ventures en etapas tempranas, la documentación de modelos de negocio, wikis internas de empresa, sistemas operativos legibles por IA y arquiteto-de-empresa para Strategic Planning, donde las decisiones deben poder rastrearse a lo largo del tiempo.

Qué la diferencia de un prompt normal

Un prompt genérico puede generar un plan de negocios largo. Esta skill, en cambio, guía una entrevista por fases y materializa la respuesta como archivos: un concepto por .md, valores de type controlados, enlaces relativos, index.md y log.md reservados, y scripts auxiliares deterministas. El diferenciador principal no es solo el asesoramiento de negocio, sino un formato de documentación repetible que se puede validar con linting, indexar, confirmar en Git y ampliar con otros agentes.

Consideraciones antes de adoptarla

La skill funciona mejor cuando estás dispuesto a responder preguntas fase por fase. No es la opción ideal si buscas un pitch deck de una página, asesoramiento legal, garantías financieras o una estrategia de empresa terminada sin intervención del fundador. Algunos nombres de carpetas y archivos siguen un estilo portugués, mientras que el idioma de la skill es inglés, por lo que conviene que el equipo decida desde el inicio si mantendrá la estructura original o si localizará las convenciones de nombres.

Cómo usar la skill arquiteto-de-empresa

Instalación de arquiteto-de-empresa y revisión del repositorio

Instala con:

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

Luego revisa la ruta de origen:

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

Lee primero SKILL.md para entender la persona, las condiciones de activación, las reglas de operación y el flujo de 12 fases. Después revisa references/phase_playbook.md, references/okf_conformance.md y references/type_vocabulary.md; estos archivos definen qué debe preguntar el agente, cómo debe estructurarse el paquete Markdown y qué valores de type son válidos en el frontmatter. Antes de generar archivos reales de empresa, previsualiza assets/frontmatter_template.md, assets/index_template.md y assets/log_template.md.

Entradas que producen mejores resultados

El patrón de uso de arquiteto-de-empresa funciona mejor cuando la primera solicitud incluye suficiente contexto de negocio para iniciar la Phase 0. Incluye etapa, modelo de negocio, sector, jurisdicción, cliente, activos actuales y ubicación deseada de salida.

Prompt débil:

“Help me structure my startup.”

Prompt más sólido:

“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.”

Esto mejora los resultados porque la skill puede elegir la fase adecuada, evitar detalles prematuros y crear archivos que respeten las reglas de OKF.

Flujo de trabajo recomendado para un paquete OKF completo

Empieza con el descubrimiento de Phase 0 y avanza después por el playbook de 12 fases en orden. En cada fase, formula de 3 a 5 preguntas, confirma las respuestas del fundador, genera los archivos de concepto, actualiza el index.md de la carpeta y añade una entrada de decisión a log.md. No le pidas al agente que vuelque todas las fases de una vez salvo que solo necesites un prototipo aproximado; la skill está diseñada para reducir estrategias alucinadas mediante entrevistas antes de escribir.

Para planificación estratégica, ejecuta las fases en orden de decisión: foundation, strategy, market, financial model, sales, marketing, product, operations, tech, people, legal y governance. Mantén visibles las afirmaciones no resueltas con [ASSUMPTION] para que el paquete funcione como un sistema de planificación, no como un generador de certezas falsas.

Uso de los scripts auxiliares

El repositorio incluye herramientas en Python que hacen más fiable la salida. Usa scripts/scaffold_bundle.py para crear un esqueleto, scripts/okf_linter.py para comprobar la conformidad y scripts/index_generator.py para regenerar las tablas de conceptos en index.md. Los scripts están orientados a la biblioteca estándar y admiten un flujo de trabajo con Git: generar, revisar diffs, ejecutar linting y luego hacer commit. Si tu agente crea archivos manualmente, aun así ejecuta el linter antes de tratar el paquete como canónico.

FAQ de la skill arquiteto-de-empresa

¿arquiteto-de-empresa es solo para empresas nuevas?

No. Está planteada alrededor de la construcción de una empresa desde cero, pero también puede documentar una empresa existente cuyo conocimiento esté disperso entre documentos, hojas de cálculo, chats y memoria de los fundadores. Para un negocio en operación, empieza indicando al agente qué ya existe y pídele que separe hechos heredados, supuestos y evidencia faltante.

¿En qué se diferencia de un generador de planes de negocio?

Un generador de planes de negocio suele producir un único documento narrativo. La skill arquiteto-de-empresa produce un grafo de conocimiento OKF: muchos archivos Markdown pequeños de conceptos, con metadatos y enlaces consistentes. Eso la hace más adecuada para mantenimiento a largo plazo, recuperación por IA, diffs en Git y planificación transversal entre áreas. Es menos conveniente si solo necesitas un PDF pulido para inversores.

¿Los principiantes necesitan entender OKF primero?

No, pero deberían entender la idea operativa: un archivo por concepto, frontmatter tipado, enlaces entre archivos relacionados y un registro de decisiones. Leer references/okf_conformance.md antes de un uso intensivo ayuda a evitar errores comunes, como mezclar varios conceptos en un solo archivo o usar etiquetas type inconsistentes.

¿Cuándo no debería usar esta skill?

No la uses como sustituto de una revisión profesional legal, fiscal, contable o propia de industrias reguladas. Evítala cuando el equipo no pueda responder preguntas básicas de descubrimiento, cuando el objetivo sea solo copy de marca o cuando necesites modelado financiero confidencial sin un entorno de ejecución seguro. La skill estructura decisiones; por sí sola no valida la verdad del mercado.

Cómo mejorar la skill arquiteto-de-empresa

Mejorar los resultados de arquiteto-de-empresa con más contexto

La mejora con mayor impacto es aumentar la calidad de la entrada. Aporta restricciones reales: presupuesto, runway, geografía, cliente objetivo, movimiento de ventas, hipótesis de precios, capacidad del equipo, stack tecnológico, exposición regulatoria y documentos existentes. Pide al agente que separe secciones de “known”, “assumed” y “to validate” dentro de cada archivo de concepto. Así el paquete OKF resulta útil para planificación estratégica, no solo como documentación descriptiva.

Fallos comunes que conviene vigilar

Presta atención a archivos demasiado comprimidos, frontmatter faltante, valores de type inválidos, enlaces relativos débiles y páginas index.md que no reflejan el contenido real de la carpeta. Otro problema frecuente es el lenguaje de negocio demasiado seguro cuando el fundador no aportó evidencia. Exige marcadores [ASSUMPTION] y actualiza log.md cada vez que cambie una decisión importante.

Iterar después del primer paquete generado

Después de la primera pasada, revisa el paquete como si fuera un backlog de producto. Pregunta: ¿qué conceptos son demasiado grandes? ¿Qué afirmaciones carecen de evidencia? ¿Qué decisiones necesitan alternativas y razonamiento? ¿Qué enlaces ayudarían a un agente futuro a navegar desde estrategia hacia finanzas, producto u operaciones? Luego pide a la skill que divida archivos sobredimensionados, añada enlaces de conceptos faltantes, regenere índices y registre los cambios en el log de decisiones.

Extender la skill para tu organización

Los equipos pueden mejorar arquiteto-de-empresa añadiendo plantillas específicas de la empresa, checklists por jurisdicción, vocabulario de la industria y puertas de validación. Mantén estables las reglas centrales de OKF: un concepto por archivo, type obligatorio, enlaces relativos, index.md y log.md reservados, y comprobaciones basadas en scripts. Si localizas nombres de carpetas o añades nuevos tipos de conceptos, actualiza references/type_vocabulary.md para que los agentes futuros sigan siendo consistentes.