Skip to content

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

arquiteto-de-empresa

Verified

Use when a founder wants to document or design a whole company as version-controlled markdown (company as code, a company wiki agents can read, an OKF bundle). Runs a 12-phase interview, scaffolds with scaffold_bundle.py and checks it with okf_linter.py.

references/phase_playbook.md

View on GitHub
# 12-phase playbook

The interview script. Run **in order**. In each phase: (a) state the objective in 1 line, (b) ask the questions (3-5 per block, numbered), (c) assemble the concepts, (d) confirm and write, (e) update the root `index.md` and `log.md`. The `type` of each file is in [`type_vocabulary.md`](type_vocabulary.md).

---

## PHASE 0 — Discovery (initial briefing)
**Objective:** understand what company this is before creating any file.
**Questions:**
1. What does the company do (or plan to do)?
2. What stage is it at (idea / MVP / operating / scaling)?
3. Model (service, product, SaaS, marketplace, info-product, hybrid)?
4. Sector and jurisdiction (country/state, entity type if one already exists)?
5. Does it already have a name and brand?
**Generates:** the folder skeleton (`scaffold_bundle.py`), the filled-in root `index.md`, and the 1st entry in `log.md`.

## PHASE 1 — Foundation (`00-fundacao`)
**Objective:** anchor identity and the problem.
**Questions:** Why does the company exist (purpose beyond profit)? What specific pain does it solve and for whom? What is the "better world" it creates? What are the 3–5 non-negotiable values?
**Generates:** `identidade.md`, `problema-solucao.md`, `manifesto.md`.

## PHASE 2 — Strategy & Business Model (`01-estrategia`)
**Objective:** design how the company creates, delivers, and captures value.
**Questions:** Core value proposition (the customer's "before vs. after")? How does revenue come in (one-off, recurring, commission, ticket)? Main cost structure? Advantage that makes copying hard (data, brand, network, process, cost)?
**Generates:** `business-model-canvas.md`, `proposta-de-valor.md`, `posicionamento.md`, `vantagem-competitiva.md`.

## PHASE 3 — Market & Intelligence (`02-mercado`)
**Objective:** size the opportunity and map the terrain.
**Questions:** 3–5 real competitors/alternatives (including "do nothing")? Approximate market size and reachable share? Ideal customer (ICP) in one sentence? Trends for/against?
**Generates:** `analise-mercado.md` (TAM/SAM/SOM), `concorrentes.md`, `icp-personas.md`, `swot.md`.
> If authorized and search is available, validate market size, competitors, and trends; cite sources in the body and record URLs in `resource`.

## PHASE 4 — Financial (`03-financeiro`)
**Objective:** turn the model into numbers.
**Questions:** Price (or range) per product/service and estimated margin? Fixed and variable monthly costs? Revenue target for the first 12 months? Do you need initial capital — how much and from where?
**Generates:** `modelo-receita.md`, `estrutura-custos.md`, `precificacao.md`, `unit-economics.md` (CAC, LTV, payback, margin), `projecoes.md` (conservative / base / aggressive + break-even).

## PHASE 5 — Go-to-Market & Sales (`04-comercial`)
**Objective:** define how the company acquires and closes customers.
**Questions:** How does the customer discover you? Path from first contact to payment? Who sells (you, a team, self-service)? Target of new customers/month?
**Generates:** `funil-vendas.md`, `processo-comercial.md`, `playbook-vendas.md`, `metas-comerciais.md`.

## PHASE 6 — Marketing & Brand (`05-marketing`)
**Objective:** give the company voice, narrative, and channels.
**Questions:** How should the brand "sound" (technical, approachable, premium, irreverent)? 3 content pillars? Which channels is the customer already on? Entry offer (hook/lead magnet)?
**Generates:** `branding.md`, `estrategia-conteudo.md`, `canais.md`, `calendario-editorial.md`.

## PHASE 7 — Product (`06-produto`) — _skip if pure service_
**Objective:** specify what is delivered as a product.
**Questions:** Core product/feature of the MVP? What is out of scope for v1? How does the customer use it day to day? How do you measure that it is working?
**Generates:** `prd.md`, `roadmap.md`, `features.md`.

## PHASE 8 — Operations & Processes (`07-operacoes`)
**Objective:** ensure the company runs without depending only on the founder.
**Questions:** 3–5 processes that cannot fail (delivery, support, billing…)? Tools that sustain the operation? Who does what? Current bottlenecks?
**Generates:** `processos.md`, `stack-ferramentas.md`, `fornecedores.md`, and `sops/SOP-XX-*.md` for the critical processes.

## PHASE 9 — Tech & Infra (`08-tech`) — _only if there is digital infrastructure_
**Objective:** design the technical base.
**Questions:** Current or desired stack? Build vs. buy? Where it runs (cloud/VPS) and what scale is expected? Mandatory integrations?
**Generates:** `arquitetura.md`, `stack.md`, `infraestrutura.md`.

## PHASE 10 — People & Culture (`09-pessoas`)
**Objective:** structure who runs the company.
**Questions:** Who is here today and what role do they hold? 3 next hires by priority? How do you work (model, cadence)? Behaviors that define the culture?
**Generates:** `organograma.md`, `funcoes-responsabilidades.md` (RACI), `cultura.md`, `plano-contratacao.md`.

## PHASE 11 — Legal & Compliance (`10-juridico`)
**Objective:** give the operation legal grounding.
**Questions:** Entity type and ownership split (partners and %)? Partners/collaborators with a contract to formalize? What customer data do you handle (data-protection law — e.g. GDPR / LGPD / CCPA, per jurisdiction)? Do you need a sector license/regulation?
**Generates:** `estrutura-societaria.md`, `compliance.md`, templates in `contratos/`.
> Always include in the body: *"these are base documents; they do not replace review by a lawyer".*

## PHASE 12 — Governance & OKRs (`11-governanca`)
**Objective:** install the steering system.
**Questions:** North-star metric (the single one that best measures value delivered)? 3 objectives for the next quarter? Follow-up rituals? Essential dashboards?
**Generates:** `okrs.md`, `rituais.md`, `metricas.md` (north star + per area) and closes the cycle in `log.md`.

---

## Progress dashboard (keep in the root `index.md`)

| Phase | Area | Status |
|---|---|---|
| 0 | Discovery | ⬜ |
| 1 | Foundation | ⬜ |
| 2 | Strategy | ⬜ |
| 3 | Market | ⬜ |
| 4 | Financial | ⬜ |
| 5 | Sales | ⬜ |
| 6 | Marketing | ⬜ |
| 7 | Product | ⬜ |
| 8 | Operations | ⬜ |
| 9 | Tech | ⬜ |
| 10 | People | ⬜ |
| 11 | Legal | ⬜ |
| 12 | Governance | ⬜ |

Legend: ✅ done · 🚧 in progress · ⬜ pending. The `index_generator.py` regenerates this table from what exists on disk.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall