알아 둘 개념 다섯 가지
프로젝트 · 채널 · 스레드
- 프로젝트는 에이전트가 일하는 폴더 하나입니다. 모든 채널의 작업은 이 프로젝트 폴더에서 실행됩니다.
- 작업 폴더(워크스페이스): 프로젝트 밖의 다른 폴더도 연결해 에이전트가 함께 다루게 할 수 있습니다.
- 채널은 프로젝트 안의 대화 공간입니다. 채널에 메시지를 보내면 새 스레드가 열립니다.
- 사람과 에이전트의 메시지는 같은 스레드에 함께 남습니다.
- 프로젝트·채널·동료는 보관했다가 되살릴 수 있습니다. 보관해도 파일과 원문은 지워지지 않습니다. 보관된 대화는 읽기 전용입니다.
작업(task)과 실행(run)
- 한 스레드 안에서도 일은 작업 단위로 나뉩니다. 같은 에이전트가 한 스레드에서 여러 작업을 동시에 맡을 수 있습니다.
- 실행은 한 작업을 한 번 시도한 것입니다. 이어서 하거나 다시 시도하면 같은 작업의 새 실행이 됩니다.
- 설정 → 에이전트 도구에서 도구별로 세션 유지, 유휴 시간 후 새 세션, 매번 새 세션을 선택합니다. 시스템 기본값은 Claude Code 60분 유휴 후 교체이며 다른 도구는 세션 유지입니다. 작업 완료·체크포인트·복구 입력과 충분히 작은 새 컨텍스트 조건을 충족해야 교체하며 재시도와 이어지는 작업은 세션을 유지합니다. 저장한 설정은 다음 실행부터 적용됩니다.
- 동시에 도는 실행은 기본 4개까지입니다.
- 토큰 사용량은 각 프로바이더가 보고한 값을 집계합니다. Claude Code와 Codex는 캐시된 입력을 계산하는 방식이 달라 입력 토큰 합계를 직접 비교할 수 없습니다.
에이전트 · 역할 · 집사
- 에이전트는 이름, 프로바이더(Claude Code, Codex 등), 모델, 페르소나와 개인 지침을 가진 동료입니다. 에이전트 설정에서 12색 팔레트나 직접 선택으로 아바타 색을 고를 수 있으며, 글자가 잘 읽히도록 글자색은 자동으로 맞춥니다. 기본색으로를 누르면 지정한 색이 해제됩니다.
- 에이전트에게는 스레드 안에서 역할이 주어집니다. 같은 역할을 다시 부르면 그 역할의 세션을 이어서 씁니다.
- 멘션 선택기에서 같은 에이전트의 여러 역할이나 모든 역할을 함께 고를 수 있습니다. 각 역할은 자신의 세션을 이어갑니다. 역할 칩의 X로 하나씩 취소하며, 마지막 역할을 지우면 멘션도 빠집니다. 구버전 앱은 여러 역할로 보낸 메시지와 초안을 읽지 못합니다.
- working notes: 에이전트마다 다음 실행에 가져갈 메모가 있습니다. 사람도 읽고 고칠 수 있습니다.
- 집사는 Howse가 기본으로 제공하는 에이전트입니다. 처음에는 꺼져 있습니다. 켜 두면 멘션 없는 메시지를 받아 직접 처리하거나 알맞은 동료에게 넘깁니다.
- 대화에서 집사에게 에이전트와 Howse 설정을 확인하거나 변경해 달라고 요청할 수 있습니다. 에이전트를 만들거나 비활성화·보관할 때, 프로바이더·모델을 바꾸거나 자동 실행을 켤 때, 실행 모드나 동시 실행 한도를 변경할 때는 승인이 필요합니다. 집사가 메시지를 받을 동료를 고르는 중에는 설정을 관리할 수 없습니다.
- 자동 멘션은 스레드 입력창에서 최근 대화 상대를 미리 선택합니다. 채널별로 켜거나 끌 수 있으며, 멘션 없는 메시지를 처리하는 기본 전달·집사 자동전달과 독립적입니다.
- 기본 전달이 켜져 있으면 멘션 없는 메시지를 원문 그대로 자동 전달합니다. 해당 주제에서 대화해 온 역할이 하나면 그 역할로, 여러 개면 집사가 그중 하나를 고릅니다. 대화 상대가 없으면 채널 기본 응답자가 받고, 없으면 집사가 동료를 고르거나 직접 답합니다. 집사 자동전달을 끄면 여러 대화 상대 중 가장 최근 상대로 이어 보냅니다. 기본 전달을 끄면 멘션 없는 메시지는 자동 실행하지 않습니다.
- 에이전트 설정은
.howse-agent.json파일로 내보내고 가져올 수 있습니다. 인증 정보는 들어가지 않습니다.
- 에이전트 설정의 담당 범위에는 어떤 일을 맡는지 적습니다. 이 프로젝트에서 함께 일할 수 있는 동료에게 이름·역할·담당 범위를 공유하며, 페르소나와 메모는 공유하지 않습니다.
- 지침은 Howse 프로토콜 → 역할 페르소나 → 프로젝트별 역할 지침 → 프로젝트 공통지침과 적용 범위의 규칙 파일 → 프로젝트 공통 역할 작업지침 → 에이전트 공통지침 순으로 우선합니다. 하위 지침은 프로토콜이 위임한 기본값만 조정할 수 있습니다. 동료 화면에서 모든 프로젝트·동료에 적용할 에이전트 공통지침을 편집할 수 있으며, 저장한 변경은 다음 실행부터 적용됩니다.
- 지원되는 Claude Code·Codex 세션에는 연결 작업영역에 처음 접근한 것을 관찰한 뒤 해당 영역의 규칙 파일을 공급합니다. 사용하지 않는 규칙 공급을 줄이지만 첫 도구 접근 전에 전달되는 것은 보장하지 않습니다. 다른 프로바이더는 시작 프롬프트 공급을 유지합니다. 작업영역별 규칙 공급 영수증과 계측도 기록합니다.
인계와 대기
- 에이전트는 동료 목록을 보고 다른 에이전트에게 일을 인계할 수 있습니다. 결과를 받아 종합한 뒤 요청한 사람에게 보고합니다.
- 더 적합한 동료가 있으면 에이전트가 인계를 제안할 수 있습니다. 질문의 동료에게 인계 또는 현재 에이전트가 계속 버튼으로 선택합니다. 집사·서기는 인계 제안 대상에서 제외됩니다. 명시적으로 지목한 동료나 내부 지원 위임에는 이 선택을 다시 묻지 않는 것이 기본 동작이며, 개인·프로젝트 지침으로 조정할 수 있습니다.
- 동료나 사람의 답을 기다리는 동안 에이전트는 차례를 끝내고 자리를 비웁니다. 필요한 답이 모두 오면 같은 작업이 한 번 이어집니다.
- 사람의 결정이 필요하면 에이전트가 스레드에 질문을 남깁니다. 그 메시지의 답변란에서 답하거나 승인·거절하면 됩니다. 일반 메시지를 보내는 것만으로는 승인 대기가 풀리지 않습니다.
- 진행 중인 작업에 보충 지시를 보낼 수 있습니다. 바로 전달할 수 없으면 같은 작업의 다음 실행으로 넘어갑니다.
- 질문·아이디어·불편 제기나 계획 채택만으로 코드 변경·배포·외부 전송까지 승인한 것으로 보지 않습니다. 위임은 정해진 범위와 제약을 유지하며 기존 작업을 보존합니다.
Whyve 컨텍스트
- 새 프로젝트를 만들면 프로젝트 폴더에
.whyve/config.json과context/가 생깁니다. 이미 Whyve를 쓰던 폴더라면 그대로 둡니다. - 무엇이 어디에 기록되는지:
| 기록 | 쓰임 |
|---|---|
| 결정(DEC) · 의도(INTENT) · 문서(DOCUMENT) | 프로젝트의 결정과 목적, 현행 설명 |
| 스냅샷(SNAP) | 기존 스레드와 Windows에서 한 주제(topic)의 모든 역할이 함께 고치는 공유 보드. 주제 도입 전의 task 스냅샷은 원래 task 범위를 그대로 유지합니다 |
| 관찰(OBS) | 확인된 사실과 시행착오. 기본은 프로젝트 동료와 공유 |
- macOS 앱에서 새로 만든 스레드는 공유 스냅샷 대신 주제별 협업 기록을 로컬 파일로 남기고, 각 역할은 자신이 마지막으로 읽은 위치부터 필요한 기록과 메시지를 이어받습니다. 기존 스레드와 Windows 앱은 스냅샷 방식을 유지합니다. 이 협업 기록은 에이전트 작업에 쓰이며 별도 화면으로 제공되지 않습니다.
- 기록을 남길 때는 프로젝트의 Whyve 승인 방식(
explicit/auto/adaptive)을 따릅니다. - 컨텍스트 화면에서 프로젝트·에이전트별로, 기록 종류와 현재/이력으로 찾아볼 수 있습니다.
- Whyve 자체에 대한 설명은 Whyve 저장소 문서를 보세요.
- 자동 기록은 작업 뒤에도 남는 효력, 잊었을 때의 판단 손실, 코드·설정·문서 대비 추가 의미를 기준으로 선별합니다. 일회성 실행 지시·반복 승인·완료 보고는 보통 남기지 않습니다. “기록해 둬”처럼 명시적으로 요청하면 원래 의미와 범위대로 보존하며, 기존 기록이 있으면 참조하거나 통합합니다.
집사의 수신자 선별 과정은 대화 화면에 표시하지 않습니다. 전달 후에는 실제 받은 동료와 그 동료의 수신·실행 상태를 표시합니다. 집사가 직접 답하거나 선별이 실패·정체되면 해당 활동은 계속 표시됩니다.
자동전달은 해당 메시지에 제시된 수신 후보를 기준으로 처리하며 중복 전달을 방지합니다. 재시도로 복구된 내부 선별 오류는 대화에 표시하지 않지만, 최종 실패나 사용자의 선택이 필요한 경우는 계속 표시합니다.
HTML·PDF 문서는 앱 내부의 격리된 미리보기로 엽니다. PDF 미리보기는 보기 전용이며 앱 창 이동과 권한 요청을 제한합니다. 다른 패널이 미리보기를 덮는 동안에는 문서의 정지 이미지를 남겨 빈 화면을 방지합니다.
새로 만드는 프로젝트의 Whyve 저장소는 결정·의도·문서와 함께 가정과 용어를 기본 활성화합니다. 이미 Whyve를 사용하는 폴더의 설정은 유지합니다.
에이전트는 동료의 대상 역할을 지정하고 수신 역할과 참조 역할을 구분합니다. 복구는 역할의 초점과 활성 기록을 우선 전달하며 inbox와 후속 페이지 진행을 보존합니다. 관리 문서는 목차·절·줄 범위 읽기, 고정 개정 안의 검색, 순차 부분 수정과 멱등 개정을 지원합니다.