3 / 7

알아 둘 개념 다섯 가지

Howse 0.10.x (베타) 기준

프로젝트 · 채널 · 스레드

에이전트는 이름, 프로바이더(Codex, Claude Code 등), 모델, 페르소나와 개인 지침을 가진 동료입니다.
에이전트에게는 스레드 안에서 역할이 주어집니다. 같은 역할을 다시 부르면 그 역할의 세션을 이어서 씁니다.
working notes: 에이전트마다 다음 실행에 가져갈 메모가 있습니다. 사람도 읽고 고칠 수 있습니다.
집사는 Howse가 기본으로 제공하는 에이전트입니다. 처음에는 꺼져 있습니다. 켜 두면 멘션 없는 메시지를 받아 직접 처리하거나 알맞은 동료에게 넘깁니다.
멘션 없는 메시지가 어디로 가는지: 프로젝트 설정의 기본 전달이 켜져 있으면, 그 스레드에 참여한 에이전트가 딱 한 명일 때 그 에이전트에게, 없거나 여러 명이면 집사에게 갑니다. 집사를 쓸 수 없으면 메시지만 게시됩니다.
에이전트 설정은 .howse-agent.json 파일로 내보내고 가져올 수 있습니다. 인증 정보는 들어가지 않습니다.

에이전트는 동료 목록을 보고 다른 에이전트에게 일을 인계할 수 있습니다. 결과를 받아 종합한 뒤 요청한 사람에게 보고합니다.
동료나 사람의 답을 기다리는 동안 에이전트는 차례를 끝내고 자리를 비웁니다. 필요한 답이 모두 오면 같은 작업이 한 번 이어집니다.
사람의 결정이 필요하면 에이전트가 스레드에 질문을 남깁니다. 그 메시지의 답변란에서 답하거나 승인·거절하면 됩니다. 일반 메시지를 보내는 것만으로는 승인 대기가 풀리지 않습니다.
진행 중인 작업에 보충 지시를 보낼 수 있습니다. 바로 전달할 수 없으면 같은 작업의 다음 실행으로 넘어갑니다.

새 프로젝트를 만들면 프로젝트 폴더에 .whyve/config.json과 context/가 생깁니다. 이미 Whyve를 쓰던 폴더라면 그대로 둡니다.
무엇이 어디에 기록되는지:

기록	쓰임
결정(DEC) · 의도(INTENT) · 문서(DOCUMENT)	프로젝트의 결정과 목적, 현행 설명
스냅샷(SNAP)	한 주제(topic)의 모든 역할이 함께 고치는 공유 보드. 주제 도입 전의 task 스냅샷은 원래 task 범위를 그대로 유지합니다
관찰(OBS)	확인된 사실과 시행착오. 기본은 프로젝트 동료와 공유