skills.rest
alirezarezvani
alirezarezvaniCOMMUNITY
Explore all skills by this author →
Website𝕏@RezaRezvaniBlnGitHub

arquiteto-de-empresa

Builds a company knowledge base as a versioned OKF markdown bundle through a 12-phase founder interview.

25.3k|3.6k|Updated Oct 19, 2025
Search Tags:#Markdown#company documentation#founder interview#OKF bundle#Knowledge Graph#venture architecture#business scaffolding
One-click install
npx skills add https://github.com/alirezarezvani/claude-skills --skill arquiteto-de-empresa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arquiteto-de-empresa
Source: https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/skills/arquiteto-de-empresa
Command: npx skills add https://github.com/alirezarezvani/claude-skills --skill arquiteto-de-empresa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Founders struggle to document an entire company in a structured, machine-readable way. This Skill guides a founder through a 12-phase interview and materializes the answers as an OKF (Open Knowledge Format) bundle — a tree of cross-linked markdown files readable by both humans and AI agents.

Core Features & Use Cases

  • 12-Phase Guided Interview: Walks through foundation, strategy, market, financial, sales, marketing, product, operations, tech, people, legal, and governance, asking 3-5 questions per block and confirming before writing files.
  • OKF Conformance Tooling: Ships three stdlib-only Python scripts — scaffold_bundle.py creates the folder skeleton, okf_linter.py validates frontmatter types and links, and index_generator.py regenerates index dashboards.
  • Traceable Decision Log: Maintains a root index.md progress dashboard and an append-only log.md recording every decision with rationale and discarded alternatives.
  • Use Case: A founder says "help me build my company from scratch as a knowledge base for AI agents" — the Skill scaffolds the bundle, interviews phase by phase, and produces conformant markdown concepts like business-model-canvas.md, unit-economics.md, and okrs.md.

Quick Start

Ask the assistant to build your company from scratch as an OKF knowledge bundle, starting with the discovery phase interview.

Frequently Asked Questions about arquiteto-de-empresa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document my company as markdown files for AI agents?▼

Use the OKF bundle approach: each company concept becomes one markdown file with YAML frontmatter containing a mandatory type field, and concepts link to each other via relative markdown links. The Skill interviews you through 12 phases and writes the files for you.

What is the Open Knowledge Format (OKF) bundle structure?▼

An OKF bundle is a directory of markdown files where each file is one concept identified by its path. Every concept carries a type from a controlled vocabulary, index.md and log.md are reserved files without types, and relations form a graph through body links.

How do I validate that my company knowledge base follows OKF rules?▼

Run okf_linter.py against the bundle folder. It checks that every concept has a non-empty type, reserved files carry no type, relative markdown links resolve, and folders with concepts have an index.md, exiting with code 0 when no errors exist.

Does the OKF scaffolding require external Python packages?▼

No. All three scripts — scaffold_bundle.py, okf_linter.py, and index_generator.py — use only the Python standard library. They make no network calls and no LLM calls, so they run deterministically offline.

Can I skip phases that do not apply to my business?▼

Yes. The product phase (06-produto) is skipped for pure service businesses, and the tech phase (08-tech) only runs when digital infrastructure exists. The scaffold script exposes --has-product and --has-tech flags to control folder creation.

Related Skills

Explore More Personal & Entrepreneur Skills→
zjykzkzjykzk

ljg-invest

Generate structured investment analysis reports assessing order creation versus preservation.

Community
Advanced
rijnbrijnb
3

wiki-ground

Ground conversation answers exclusively in curated wiki knowledge base pages.

Community
Intermediate
GTM-StrategistGTM-Strategist
233

collecting-intelligence

Collect structured competitive intelligence to validate market assumptions and guide GTM decisions.

Official
Advanced
Eli5DeFiEli5DeFi
1

cognos-graph

Manage an atomic knowledge graph with Markdown files and wiki-style links.

Community
Intermediate