AlpacaLabsLLC/skills-for-architects

Arch Studio – 건축 사무소를 위한 AI 지원 워크플로우 프레임워크

정의

• OpenAI Codex 또는 Anthropic Claude Code 환경에 거버넌스 계층 및 영구 스튜디오/프로젝트 메모리를 추가하는 로컬 우선 플러그인(as).
• 구역 분석, 지속 가능성 검사, FF&E 사양, 프로젝트 기록 관리와 같은 일반적인 건축-엔지니어링-시공(AEC) 작업을 위한 기성 '스킬'(AI 기반 절차) 및 '에이전트'(전문가 프로필) 카탈로그를 제공합니다.
• 기업은 자체 맞춤 스킬을 개인 작업 공간에 유지하고, 기업 전체에 공유하거나 오픈소스 저장소에 기여할 수 있습니다.

핵심 개념

기둥	책임
스튜디오	계정/액세스 제어, 구성, 표준, 보증 – 기업의 AI 지원 워크플로우를 위한 제어 평면.
툴링	실제 스킬, 전문 에이전트, 통합 기능. 호스트(Codex/Claude)가 이를 실행합니다.
지식	권위 있는 소스 자료(코드, 표준, 제품 데이터)에 대한 링크 및 출처 추적.
메모리	로컬 스튜디오/프로젝트 파일에 저장된 영구적 사실, 결정, 선호도, 증거.

구성

• corpus/ – 소스 탐색 및 기능 검색.
• tools/ – 관리자 유틸리티.
• skills/ – 번들로 제공되는 참조 스킬(예: spec-writer, product-cut-sheet).
• agents/ – 전문 에이전트 정의(사이트 플래너, 구역 전문가, 지속 가능성 전문가 등).
• studio/ – 기업 수준(.agents/skills/) 및 프로젝트 수준(<project>/.agents/skills/) 맞춤 스킬이 포함된 사용자 소유 작업 공간.

설치 및 첫 사용

• Codex: Git 마켓플레이스를 추가하고 as@skills-for-architects를 설치한 후 codex를 실행하고 $studio를 호출합니다.
• Claude Code: Claude 마켓플레이스에서 설치한 후 /as:studio를 실행합니다.
• 플러그인은 사용자가 대상 디렉토리를 승인할 때까지 파일을 생성하지 않으므로 설정이 완전히 로컬로 유지되고 기업이 통제할 수 있습니다.

일반적인 워크플로우

1. 스튜디오 시작 ($studio / /as:studio) – 계정, 표준, 기본 정책을 구성합니다.
2. 에이전트에게 작업 요청 (예: Norma): /as:norma task chair, mesh back, under $800.
3. 스킬 직접 호출 (원하는 경우): $environmental-analysis 123 Main St (Codex) 또는 /as:environmental-analysis 123 Main St (Claude).
4. 맞춤 스킬 생성 (/as:skill-maker): 도구가 기업 거버넌스 정책을 검증하고 적절한 작업 공간 계층에 스킬을 작성합니다.
5. 레코드 유지 – 스튜디오는 프로젝트 기록 관리를 위해 CSV 파일(DOCUMENTS.csv, TASKS.csv, INVOICES.csv 등)을 자동으로 생성합니다.

번들로 제공되는 에이전트 및 스킬

• 에이전트: 사이트 플래너, NYC 구역 전문가, 워크플레이스 전략가, 제품 및 자재 연구원, FF&E 디자이너, 지속 가능성 전문가, 브랜드 매니저, 선택적 코디네이터 'Norma'.
• 스킬 그룹: 기업 운영(디스패처, 학습), 프로젝트 관리(레코드, 작업 계획, 청구서), 전문 실무(AIA 용어, CSI/NCS 참조), 설계 작업(실사, 구역, 프로그래밍, 사양, 지속 가능성, FF&E, 프레젠테이션)을 다룹니다.
• 스킬 엔트리 포인트 예시: spec-writer, product-cut-sheet, ffe-spec-book, epd-to-spec.

확장성

• 스튜디오 수준 스킬: studio/.agents/skills/(Claude의 경우 .claude/skills/)에 있으며 기업 전체 표준을 나타냅니다.
• 프로젝트 수준 스킬: 각 프로젝트의 .agents/skills/ 디렉토리에 있으며 클라이언트별 절차를 다룹니다.
• 기여는 업스트림에 제출하여 공유 카탈로그를 풍부하게 할 수 있습니다.

중요성

• 대규모 언어 모델 어시스턴트와 고도로 규제되고 문서 중심적인 건축 세계 사이의 격차를 해소합니다.
• 모든 데이터를 온프레미스로 유지하여 독점 도면이나 계약을 클라우드 서비스에 노출할 수 없는 기업을 지원합니다.
• 각 작업에 맞춤 코드를 작성하지 않고 AI 증강 AEC 파이프라인을 구축할 수 있는 재사용 가능한 오픈소스 패턴을 제공합니다.

---

TL;DR: Arch Studio는 건축 사무소가 Codex 또는 Claude Code를 지능형 어시스턴트로 실행할 수 있게 해주는 오픈소스 플러그인으로, 기성 AI 스킬 및 전문 에이전트 라이브러리, 로컬 거버넌스 계층, 기업별 워크플로우를 제작하는 간단한 방법을 제공하며 모든 데이터를 기업이 통제할 수 있게 합니다.