English: ../TUTORIAL.md
Step 1~5만 완료하면 에이전트 팀이 실제 스프린트를 돌리는 것까지 체험합니다. Genasis가 무엇을 하는지 이해하는 가장 빠른 방법입니다.
curl -fsSL https://raw.githubusercontent.com/claude-genasis/genasis/main/install.sh | sh
mkdir marketing-squad && cd marketing-squad
genasis init --trial --name "Marketing Squad"
빈 프로젝트를 생성하고 genasis.toml을 작성합니다 — [plane],
[mattermost], [trial] 섹션이 모두 사용자가 선택한 팀 이름을
담습니다. workspace_slug = "marketing-squad",
team_name = "marketing-squad", [[mattermost.channels]] 아래
scrum-marketing-squad 채널, [trial] 아래 새로 생성된 team_token.
--name을 생략하면 대화형 프롬프트(인터랙티브)나 디렉터리 이름의
사람-읽기 변환(marketing-squad → “Marketing Squad”)으로 채워집니다.
명령 종료 시 복사하기 좋은 ASCII-bar 요약이 팀 토큰 (32자 hex) + 토큰이 pre-fill된 랜딩 URL 을 출력합니다. 이 토큰을 보관하세요 — 이게 사용자 에이전트의 칸반 카드와 채팅 메시지를 사용자의 Live Trial 뷰에 연결하는 유일한 키입니다.
이어서 운영자 호스팅 데모
mmplane-trial.realstory.blog
를 사용자 팀 전용 토큰 URL — /?tab=live&team=<token> — 으로 바로
엽니다. 따라서 칸반 헤더와 채팅 사이드바에 “Marketing Squad”가
표시되고, 공유 샌드박스의 일반 이름이 아닌 사용자 팀이 보입니다.
team_token은 호스팅 인스턴스에서 동시 데모 중인 다른 사용자의 sim
행과 격리합니다 (ADR-016).
만약 도메인만 열렸다면 (URL에 ?team= 없음), Live Trial 화면은
비활성 상태로 렌더되고 상단에 “팀 토큰을 입력하세요” 바가
표시됩니다 — CLI 요약 박스의 토큰을 그 바에 붙여넣고 연결을
클릭하세요. 연결되면 칸반/채팅/쇼케이스 패널이 모두 활성화되고,
trial-app이 토큰을 기억합니다 (쿠키 + localStorage, 1년 max-age)
— 다음 방문에도 연결 상태 유지 (ADR-017 §6).
trial 앱의 실환경 빌리기 탭에서 운영자 공유 인프라의 실제 Plane + Mattermost 프로젝트를 빌릴 수도 있습니다 — 서버 설치 없이 (ADR-017).
genasis example prd
에이전트 팀이 바로 작업할 수 있는 PRD.md를 생성합니다. 레퍼런스 PRD는
“나는 Claude Code 전문가” — 모바일 폰 테두리 안의 자가 진단 퀴즈
앱으로 사용자의 Claude Code 지식을 초급 / 중급 / 고급으로 등급화합니다
(ADR-017).
파일은 로케일 인식 — 한국어로 init한 프로젝트([i18n].active = "ko")는
한국어 PRD를, 영어 프로젝트는 영어 버전을 받습니다. 강제 지정하려면
genasis example prd --lang en|ko.
genasis init
PM 에이전트가 PRD.md를 읽고 Plane 티켓으로 분해, 역할을 배정하고 팀이
작업을 시작합니다. Plane과 Mattermost에서 진행을 볼 수 있습니다 — 또는
trial 모드 프로젝트라면, genasis init --trial이 출력한 URL에서 라이브
trial 앱으로.
에이전트가 빌드를 끝내면:
genasis trial publish
이 명령은 trial-app에서 팀의 app_status를 complete로 전환합니다.
라이브 trial URL을 새로고침하면 LiveBoard의 “에이전트가 만든 앱
보기” 버튼이 활성화되고 — 클릭하면 패널이 좌측에서 슬라이드 인하며
임베드된 퀴즈를 보여줘 에이전트가 방금 ship한 결과물을 그대로
플레이해볼 수 있습니다 (ADR-017 §3-§4).
genasis monitor
Ratatui TUI 대시보드를 열어 실시간으로 확인합니다: 어떤 에이전트가 무슨 작업을 하고 있는지, 토큰 사용량, 티켓 상태, 채팅 활동.
기본을 마스터했습니다. 에이전트 팀이 PRD에서 작동하는 코드까지 스프린트를 돌렸습니다. 아래는 더 탐색하고 싶을 때 시도할 수 있는 선택적 연습입니다.
위에서 만든 프로젝트를 기반으로 진행합니다. 각 연습은 genasis의 다른 기능을 보여줍니다.
genasis example prd2
로그인, 관리자 백오피스, 사용자 관리 등 추가 기능이 담긴 PRD2.md를
생성합니다. 에이전트가 PRD2를 읽고 새 티켓을 만들어 기존 코드를 확장합니다.
에이전트 팀으로 점진적 개발하는 과정을 체험합니다.
genasis example design
genasis design swap --from docs/design-system.md
새로운 디자인 토큰(색상, 타이포그래피, 간격)이 담긴 docs/design-system.md를
생성합니다. swap을 실행하면 영향받는 모든 UI 영역에 대한 Plane 이슈가
자동 생성됩니다. 프론트엔드 에이전트가 이 이슈를 자동으로 가져갑니다.
genasis agents browse
에이전트 카탈로그를 탐색하고 전문가를 추가합니다:
seo-specialist — SEO 감사, 메타 태그 생성sre-engineer — 모니터링, 헬스체크 설정ios-expert — 모바일 앱 지원 추가mkdir another-project && cd another-project
genasis init --bootstrap
이번에는 --trial 없이 — 직접 운영하는 Plane과 Mattermost에 연결합니다
(자체 호스팅 또는 trial 서버).
cd /path/to/existing-project
genasis attach
기존 .claude/agents/*.md 파일을 감지하고 비파괴적으로 Plane/Mattermost
연동을 overlay합니다. marker fence 밖의 에이전트 정의는 그대로 유지됩니다.