refboard/AI 어시스턴트
최근 수정 시각: 2026-07-11 00:13:16
1. 무엇을 하려는 기능인가
AI 어시스턴트는 프로젝트의 GDD와 레퍼런스를 문맥으로 삼고, 답변에서 관련 문서나 블록을 인용하는 기획 대화를 목표로 한다. Gemini 호출 클라이언트와 채팅 메시지·인용 필드는 코드에 정의돼 있다.
2. 현재 화면 상태
우측 패널의 기본 탭은 챗이지만, 현재는 “AI 챗은 M4에서 살아나”라는 자리 표시자만 나온다. 메시지를 입력하거나 답변을 받는 사용자 인터페이스가 노출돼 있지 않다. 따라서 현재 라이브를 정상적인 AI 기획 도우미로 사용할 수 있다고 설명하면 안 된다.
3. 현재 API 동작
채팅 API는 메시지 조회와 저장 구조를 갖지만, POST 요청 시 Gemini에 문서 문맥을 보내는 대신 “M4에서 documents 트리 기반으로 다시 살아난다”는 고정 안내 응답을 저장한다. 인용 배열도 빈 상태다.
일반 사용자는 이 API를 우회 호출할 이유가 없다. 현재 확인 가능한 화면 동선은 다음까지다.
- 프로젝트를 연다.
- 우측 챗 탭을 선택한다.
- 후속 마일스톤 안내를 확인한다.
4. 현재 대안
AI와 함께 검토할 기획 내용은 먼저 GDD 문서에 구조화해 둔다. 문서 트리가 안정적으로 쌓여야 향후 문맥 주입과 문서 인용이 구현됐을 때도 출처를 명확히 제시할 수 있다.
5. 향후 활성화 확인 항목
- 채팅 입력창과 대화 기록 UI가 실제로 노출되는가
- 선택한 프로젝트의 문서 트리가 프롬프트 문맥에 포함되는가
- 답변의
[doc:ID]또는 블록 인용이 클릭 가능한 출처로 연결되는가 - Gemini 미설정·실패·빈 응답이 사용자에게 안전하게 표시되는가
- 인증된 프로젝트 경계를 넘어 다른 자료가 섞이지 않는가
이 항목이 라이브와 소스에서 확인된 뒤에야 구체적인 프롬프트 사용법을 문서화한다.