Company Architect
Company Architect builds a business from scratch as an OKF (Open Knowledge Format) bundle: a tree of version-controllable .md files with frontmatter type, cross-linked into a graph, readable by humans and AI agents. It guides the founder through a 12-phase interview (foundation, strategy, market, financial, sales, marketing, product, operations, tech, people, legal, governance), one phase at a time, and generates conformant markdown files.
✨ What it does
- Guides through a 12-phase interview, one phase at a time, with 3-5 questions per block.
- Generates an OKF bundle: a tree of .md files with YAML frontmatter type and markdown links forming a graph.
- Maintains reserved index.md and log.md for dashboard and decision history.
- Uses stdlib Python tools (scaffold_bundle.py, okf_linter.py, index_generator.py) for deterministic scaffolding, validati
- Enforces conformance rules: each file is one concept, relations are links, and everything is human and machine readable.
- Tracks decisions in log.md with ISO 8601 timestamps and rationale.
🎯 When to use it
- When the user wants to create, structure, or document an entire company in folders and .md files.
- When the user mentions 'build my company from scratch', 'company as code', or 'company knowledge base for AI to read'.
- When the user wants a company wiki for agents or an OKF knowledge bundle.
- When the user needs a structured, version-controlled documentation of their business vision and operations.
🚀 How to use
Trigger the skill by asking to build a company from scratch, e.g., 'Build my company as code' or 'Create an OKF bundle for my startup'. The skill will greet you, ask for the bundle name, scaffold the folder tree, and start Phase 0 (discovery) with a few questions. Answer the questions; the skill will propose files, confirm with you, write them, and proceed phase by phase. Example prompts:
Build my company from scratch as an OKF bundle.
I want a company knowledge base for AI agents. Let's start.
📄 Output: An OKF bundle: a directory of .md files with frontmatter type, index.md and log.md, covering all 12 phases of the company.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/c-level-advisor/skills/arquiteto-de-empresa .claude/skills/arquiteto-de-empresaSkill source: c-level-advisor/skills/arquiteto-de-empresa/SKILL.md
⚠️ Good to know
The skill requires disk access to write files; without it, it delivers each file in code blocks. It assumes the user provides answers or accepts transparent assumptions marked [ASSUMPTION].
❓ FAQ
What is an OKF bundle?
An OKF bundle is a directory of .md files, each representing one concept with YAML frontmatter type, cross-linked via markdown links, plus reserved index.md and log.md. It is readable by humans and AI agents.
How many questions does the skill ask at a time?
The skill asks at most 3 to 5 questions per block, numbered, and re-asks only what was missing.
What happens if I don't know an answer?
The skill proposes a default, marks it as [ASSUMPTION] in the body, and proceeds.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.