ai-workspace-template

Claude Code를 기본 실행 환경으로 삼되, Codex, Cursor 등 다른 AI 에이전트도 함께 사용할 수 있는 팀 공용 AI 작업 공간 스타터 템플릿입니다.

PO, 디자이너, FE, BE 등 역할에 관계없이 이 디렉토리에서 AI 에이전트를 실행하고, 코드 분석, 정책 문서화, 도메인 지식 축적, 기획부터 구현까지 한 곳에서 작업합니다.

빠른 시작 (Quick Start)

Step 3. 초기 세팅

Claude Code를 사용하는 경우 프롬프트에서:

도구 설치, GitHub 인증, 프로젝트 clone을 자동으로 수행합니다.

Codex, Cursor 등 slash command를 실행하지 않는 에이전트는 AGENTS.md를 먼저 읽고, .claude/skills/setup/SKILL.md를 절차 문서로 참고해 실행 가능한 명령으로 옮겨 수행합니다.

Step 4. 도메인 정의

Claude가 몇 가지 질문을 통해 wiki/와 ontology/에 도메인 구조를 자동 생성합니다. 비-Claude 에이전트는 .claude/skills/new-domain/SKILL.md의 절차를 따라 동일한 파일을 직접 생성합니다.

Codex/Cursor 사용 가이드

Claude Code 외의 AI 에이전트는 루트의 AGENTS.md를 우선 규칙으로 사용합니다.

• slash command(/setup, /worktree, /commit, /pull-request 등)는 자동 실행하지 않습니다.
• .claude/skills/*/SKILL.md와 .claude/rules/*.md는 절차 문서로 읽고, 각 에이전트가 실행 가능한 명령과 파일 수정으로 옮겨 수행합니다.
• .claude/hooks/*와 .claude/settings.json의 권한 가드는 Claude Code에서만 자동 실행됩니다. 다른 에이전트는 AGENTS.md의 금지 명령, 브랜치, worktree, PR 규칙을 직접 지켜야 합니다.
• 도메인/정책/기능/코드 변경 요청은 CLAUDE.md의 탐색 순서대로 ontology/index.yaml → 관련 ontology/abox/*.yaml → wiki/ → projects/ 순으로 확인합니다.
• 프로젝트 코드는 projects/{repo}/main/에서 읽고, 수정은 반드시 projects/{repo}/worktrees/{name}/에서 수행합니다.

초기 설정 가이드

1. 워크스페이스 설정 (workspace.json)

.claude/workspace.json에 팀 정보와 코드 레포를 등록하세요: