arquiteto-de-empresa

arquiteto-de-empresa skill 개요

arquiteto-de-empresa의 용도

arquiteto-de-empresa는 창업자의 거친 사업 아이디어를 OKF 번들로 바꾸기 위한 Company Architect skill입니다. OKF 번들은 YAML frontmatter가 있는 Markdown 파일 트리로, 버전 관리가 가능하며 typed concepts, cross-links, index.md 대시보드, append-only 방식의 log.md를 포함합니다. 사람과 AI agent가 별도 해석 없이 함께 읽을 수 있는 회사 지식 베이스를 만들고 싶은 창업자, 운영 리더, 컨설턴트, 전략기획팀에 특히 잘 맞습니다.

가장 잘 맞는 사용 사례와 사용자

전략, 시장, 재무, 영업, 마케팅, 제품, 운영, 기술, 인사, 법무, 거버넌스를 하나의 연결된 구조 안에서 “company as code”처럼 구축하거나 재정리해야 할 때 arquiteto-de-empresa skill을 사용하면 좋습니다. 초기 스타트업 설계, 비즈니스 모델 문서화, 사내 company wiki, AI가 읽을 수 있는 operating system, 시간이 지나도 의사결정의 맥락을 추적해야 하는 Strategic Planning용 arquiteto-de-empresa에 적합합니다.

일반 프롬프트와 다른 점

일반적인 프롬프트는 긴 사업계획서를 만들어낼 수 있습니다. 반면 이 skill은 단계별 인터뷰를 진행하고, 그 답변을 실제 파일로 구체화합니다. 즉 .md 파일 하나에 concept 하나, 통제된 type 값, 상대 링크, 예약된 index.md와 log.md, 결정론적인 helper script가 포함됩니다. 핵심 차별점은 단순한 사업 조언이 아니라, lint, index 생성, Git commit, 다른 agent의 확장이 가능한 반복 가능한 문서화 형식이라는 데 있습니다.

도입 시 고려할 점

이 skill은 단계별 질문에 차근차근 답할 준비가 되어 있을 때 가장 강력합니다. 한 장짜리 pitch deck, 법률 자문, 재무적 보장, 창업자 입력 없이 완성된 회사 전략을 원한다면 적합하지 않습니다. 일부 폴더와 파일 이름은 Portuguese 스타일이고 skill 언어는 English이므로, 팀은 초기에 원래 구조를 유지할지 naming convention을 현지화할지 결정하는 것이 좋습니다.

arquiteto-de-empresa skill 사용 방법

arquiteto-de-empresa 설치와 repository 확인

다음 명령으로 설치합니다.

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

그다음 source path를 확인합니다.

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

먼저 SKILL.md를 읽어 persona, trigger conditions, operating rules, 12-phase flow를 이해하세요. 이어서 references/phase_playbook.md, references/okf_conformance.md, references/type_vocabulary.md를 확인합니다. 이 파일들은 agent가 무엇을 질문해야 하는지, Markdown 번들이 어떤 형태를 가져야 하는지, frontmatter의 어떤 type 값이 유효한지를 정의합니다. 실제 회사 파일을 생성하기 전에 assets/frontmatter_template.md, assets/index_template.md, assets/log_template.md도 미리 살펴보세요.

더 나은 결과를 만드는 입력

arquiteto-de-empresa 사용 패턴은 첫 요청에 Phase 0을 시작할 수 있을 만큼 충분한 비즈니스 맥락이 포함될 때 가장 잘 작동합니다. stage, business model, sector, jurisdiction, customer, current assets, 원하는 output location을 포함하세요.

약한 프롬프트:

“Help me structure my startup.”

더 나은 프롬프트:

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

이렇게 작성하면 skill이 적절한 phase를 선택하고, 성급한 세부사항 생성을 피하며, OKF rules에 맞는 파일을 만들 수 있습니다.

완전한 OKF 번들을 위한 권장 workflow

Phase 0 discovery부터 시작한 뒤 12-phase playbook을 순서대로 진행하세요. 각 phase에서 3–5개의 질문을 던지고, 창업자의 답변을 확인한 다음 concept files를 생성하고, 해당 folder의 index.md를 업데이트하며, log.md에 decision entry를 추가합니다. 아주 거친 prototype만 필요한 경우가 아니라면 모든 phase를 한 번에 쏟아내라고 요청하지 마세요. 이 skill은 작성 전에 인터뷰를 진행함으로써 환각에 가까운 전략 생성을 줄이도록 설계되어 있습니다.

Strategic planning 목적이라면 foundation, strategy, market, financial model, sales, marketing, product, operations, tech, people, legal, governance 순으로 의사결정 흐름에 맞춰 phase를 실행하세요. 아직 해결되지 않은 주장은 [ASSUMPTION]으로 드러내 두어야 합니다. 그래야 번들이 가짜 확신을 만들어내는 도구가 아니라 실제 planning system이 됩니다.

helper script 사용하기

이 repository에는 output의 신뢰도를 높이는 Python 도구가 포함되어 있습니다. scripts/scaffold_bundle.py로 skeleton을 만들고, scripts/okf_linter.py로 conformance를 확인하며, scripts/index_generator.py로 index.md의 concept table을 다시 생성하세요. 이 script들은 standard-library 중심이며 Git workflow를 지원합니다. 즉 generate, review diffs, lint, commit 순서로 작업하기 좋습니다. agent가 파일을 수동으로 만들었더라도, 해당 번들을 canonical로 취급하기 전에 반드시 linter를 실행하세요.

arquiteto-de-empresa skill FAQ

arquiteto-de-empresa는 신규 회사에만 쓰나요?

아닙니다. 처음부터 회사를 만드는 흐름을 중심으로 설계되어 있지만, 문서, 스프레드시트, 채팅, 창업자의 기억 속에 흩어져 있는 기존 회사의 지식을 정리하는 데도 사용할 수 있습니다. 운영 중인 비즈니스라면 먼저 이미 존재하는 자료를 agent에게 알려주고, legacy facts, assumptions, missing evidence를 구분해 표시하라고 요청하세요.

business plan generator와 어떻게 다른가요?

business plan generator는 보통 하나의 서술형 문서를 만들어냅니다. arquiteto-de-empresa skill은 OKF knowledge graph를 생성합니다. 즉 일관된 metadata와 link를 가진 작은 Markdown concept file 여러 개를 만듭니다. 그래서 장기 유지관리, AI retrieval, Git diffs, cross-functional planning에 더 유리합니다. 다만 투자자에게 바로 보여줄 polished PDF만 필요하다면 덜 편리할 수 있습니다.

초보자도 OKF를 먼저 이해해야 하나요?

아닙니다. 다만 운영 개념은 이해해야 합니다. concept 하나당 파일 하나, typed frontmatter, 관련 파일 간 link, decision log라는 구조입니다. 본격적으로 사용하기 전에 references/okf_conformance.md를 읽으면 여러 concept을 한 파일에 합치거나 일관되지 않은 type label을 사용하는 흔한 실수를 줄일 수 있습니다.

언제 이 skill을 쓰지 말아야 하나요?

법률, 세무, 회계, 규제 산업 관련 전문가 검토를 대체하는 용도로 사용하면 안 됩니다. 팀이 기본적인 discovery 질문에도 답할 수 없거나, 목표가 오직 branding copy뿐이거나, 안전한 실행 환경 없이 confidential financial modeling이 필요한 경우에도 피하는 것이 좋습니다. 이 skill은 의사결정을 구조화하지만, 시장의 진실을 스스로 검증하지는 않습니다.

arquiteto-de-empresa skill 개선 방법

더 강한 context로 arquiteto-de-empresa 결과 개선하기

가장 큰 효과를 내는 개선 방법은 입력 품질을 높이는 것입니다. budget, runway, geography, target customer, sales motion, pricing hypotheses, team capacity, technology stack, regulatory exposure, existing documents처럼 실제 제약조건을 제공하세요. 각 concept file 안에서 “known,” “assumed,” “to validate” 섹션을 분리하도록 agent에게 요청하는 것도 좋습니다. 이렇게 해야 OKF 번들이 단순한 설명 문서가 아니라 strategic planning에 쓸 수 있는 도구가 됩니다.

자주 발생하는 실패 패턴

파일이 지나치게 압축되는 경우, frontmatter가 빠지는 경우, 유효하지 않은 type 값이 쓰이는 경우, 상대 링크가 약한 경우, index.md 페이지가 실제 folder contents를 반영하지 않는 경우를 주의하세요. 또 다른 흔한 문제는 창업자가 근거를 제공하지 않았는데도 지나치게 확신에 찬 business language가 생성되는 것입니다. [ASSUMPTION] marker를 요구하고, 중요한 결정이 바뀔 때마다 log.md를 업데이트하세요.

첫 번째 생성 번들 이후 반복 개선하기

첫 번째 pass가 끝나면 번들을 product backlog처럼 검토하세요. 어떤 concept이 너무 큰가? 어떤 claim에 근거가 부족한가? 어떤 decision에 alternative와 rationale이 필요한가? 미래의 agent가 strategy에서 finance, product, operations로 이동할 때 어떤 link가 도움이 될까? 그런 다음 skill에게 oversized file을 분리하고, 누락된 concept link를 추가하고, index를 다시 생성하고, 변경사항을 decision log에 기록하게 하세요.

조직에 맞게 skill 확장하기

팀은 company-specific template, jurisdiction checklist, industry vocabulary, validation gate를 추가해 arquiteto-de-empresa를 개선할 수 있습니다. 다만 core OKF rules는 안정적으로 유지하세요. 파일 하나당 concept 하나, 필수 type, 상대 링크, 예약된 index.md와 log.md, script-based checks가 그 핵심입니다. folder name을 현지화하거나 새로운 concept type을 추가한다면, 이후 agent들이 일관성을 유지할 수 있도록 references/type_vocabulary.md를 업데이트하세요.