feat: Stabilize Company Suite & Self-Reflection logic, integrate new ADRs and bug records

2026-05-14 16:05:28 +09:00
parent f521c3f557
commit 618b8d5b34
33 changed files with 2203 additions and 655 deletions
@@ -0,0 +1,16 @@
+# Bug: 질문이 있어. 논문을 쓰려고해. 논문 주제는 서비스적이 아닌 사용자가 ai에게 구조로 질문을 해야 사용자의 의도에 맞는 답변을 받을 수 있을까야...
+
+## Date
+2026-05-14
+
+## Symptom
+질문이 있어. 논문을 쓰려고해. 논문 주제는 서비스적이 아닌 사용자가 ai에게 구조로 질문을 해야 사용자의 의도에 맞는 답변을 받을 수 있을까야. 다만 여기서 어패가 안맞는 인간의 오류이긴한데. 사람은 의도를 말 안하고 내 마음을 알아주길 바라거나 아니면 내 머리속에 있는 정보의 차이로 상대도 알고 있을 것이다라는 잘못된 판단이 적용이 될 것이란 말이지. 그러면 결국 ai와도 많은 대화를 하고 의도를 충분히 파악할 수 있게 해야하는 절차가 필요한데 초기 입력값을 쓸때 최소한의 질문하는 포멧은 어떻게 해야하는게 좋을까? 그러고 너가 답변해주는 내용을 지원하는 논문 링크도 있으면 찾아주면 좋겠어
+
+## Cause
+Captured automatically from the current conversation. Confirm root cause during follow-up review if needed.
+
+## Fix
+매우 흥란롭고 학술적으로 가치가 높은 주제입니다. 질문자께서 말씀하신 "내 마음을 알아주길 바라는 오류"는 인지 심리학에서 **'투명성의 착각(Illusion of Transparency)'**이라고 부르는 현상과 정확히 일치합니다. 화자는 자신의 의도가 전달되었다고 믿지만, 청자는 전혀 모르는 상태를 말하죠. 이 논문을 구성하기 위해, 초기 입력값(Prompt)의 구조를 설계할 때 고려해야 할 프레임워크와 근거가 될 수 있는 이론적 배경을 정리해 드립니다. --- ## 1. 초기 질문 포맷 설계를 위한 제안: "Context-Goal-Constraint" 모델 사용자의 의도를 파악하기 위해 '최소한의 질문'이 갖추어야 할 구조는 단순히 짧은 것이 아니라, **정보의 결손을 메울 수 있는 최소 단위의 구조(Minimum Viable Prompt)**를 포함해야 합니다. 이를 위해 아래 3요소를 포함한 포맷을 제안합니다. ### [제안하는 프레임워크: C-G-C 모델] 사용자가 이 세...
+
+## Prevention
+Keep automatic records tied to the active project and verify the relevant test or reproduction path.
@@ -0,0 +1,16 @@
+# Bug: Thesis paper를 쓰려고 하는데 아래와 같이 쓰면 좋을까? 이런 식으로 쓰면 되지 않을까 싶음 1. Introduction Thesis ...
+
+## Date
+2026-05-14
+
+## Symptom
+Thesis paper를 쓰려고 하는데 아래와 같이 쓰면 좋을까? 이런 식으로 쓰면 되지 않을까 싶음 1. Introduction Thesis Statement AI와의 의도 불일치는 단순한 AI 성능 문제가 아니라, 사용자가 자신의 의도와 배경지식이 충분히 전달되었다고 착각하는 인간 커뮤니케이션 오류에서 발생할 수 있다. 따라서 이를 줄이기 위해 최소 질의 구조와 확인 질문 절차가 필요하다. Body에서 다룰 3가지 Statement 사용자는 자신의 의도와 배경지식이 AI에게 전달되었다고 착각할 수 있다. 구조화된 질문은 AI가 사용자의 의도를 더 정확히 파악하도록 돕는다. AI의 확인 질문 절차는 사용자의 불완전한 질문을 보완할 수 있다. 2. Body 1: 인간의 인지 오류 Main Idea 사용자는 자신의 생각, 목적, 배경정보가 상대에게 전달되었다고 착각하는 경향이 있다. 다룰 내용 투명성의 착각 지식의 저주 공통 기반 부족 AI와의 대화에서도 같은 문제가 발생함 3. Bo...
+
+## Cause
+Captured automatically from the current conversation. Confirm root cause during follow-up review if needed.
+
+## Fix
+논문의 논리 구조(Outline)가 매우 탄탄합니다. 특히 **'인간의 심리학적 오류(원인) $\rightarrow$ 구조화된 프롬프트(해결책 1) $\rightarrow$ AI의 역질문 프로세스(해결책 2)'**로 이어지는 흐름은 학술적으로 매우 설득력이 있습니다. 이 논문의 완성도를 높이기 위해, 심사위원이나 독자가 제기할 수 있는 날카로운 질문들을 방어할 수 있도록 몇 가지 **'학술적 보완 포인트'**를 제안해 드립니다. --- ## 1. 논리 구조 리뷰 및 강화 제안 ### [Body 1: 인지 오류 레이어] - "현상 분석" 현재 구성된 '투명성의 착각', '지식의 저주'는 완벽합니다. 여기에 **'인지적 편향(Cognitive Bias)'**이라는 용어를 사용하여, 이것이 단순한 실수(Mistake)가 아니라 인간의 뇌 구조에서 기인한 필연적인 현상임을 강조하세요. * **추가 제안**: '자기중심적 편향(Egocentric Bias)'을 언급하면 좋습니다. "내 머릿속...
+
+## Prevention
+Keep automatic records tied to the active project and verify the relevant test or reproduction path.
@@ -0,0 +1,16 @@
+# Bug: 논문 Outline Title 인간-AI 상호작용에서 의도 정렬을 높이기 위한 최소 질의 구조 연구 또는 사용자의 인지적 편향을 보완하는 구조화...
+
+## Date
+2026-05-14
+
+## Symptom
+논문 Outline Title 인간-AI 상호작용에서 의도 정렬을 높이기 위한 최소 질의 구조 연구 또는 사용자의 인지적 편향을 보완하는 구조화된 AI 질의 프레임워크 연구 1. Introduction 1.1 문제 제기 생성형 AI의 성능은 빠르게 발전하고 있지만, 사용자는 여전히 “AI가 내 의도를 제대로 이해하지 못했다”고 느끼는 경우가 많다. 이 문제는 단순히 AI의 성능 부족 때문만은 아니다. 사용자가 자신의 의도, 배경 정보, 판단 기준을 충분히 말하지 않았음에도 AI가 알아서 이해해주기를 기대하는 인간 커뮤니케이션 오류와 관련된다. 1.2 Thesis Statement 본 논문은 생성형 AI와의 의도 불일치가 사용자의 인지적 편향과 불완전한 입력 구조에서 비롯될 수 있다고 보고, 이를 줄이기 위한 C-G-C-F-Q 기반 최소 질의 구조와 AI의 확인 질문 절차를 제안한다. 1.3 Body에서 다룰 3가지 Statement 사용자의 불완전한 질문은 투명성의 착각, 지식의 저...
+
+## Cause
+Captured automatically from the current conversation. Confirm root cause during follow-up review if needed.
+
+## Fix
+제시해주신 논문 Outline은 매우 완성도가 높습니다. 특히 **'현상(인지적 오류) $\rightarrow$ 해결책 1(구조화된 프레임워크) $\rightarrow$ 해결책 2(상호작용 프로세스)'**로 이어지는 논리적 흐름이 학술적 서사(Academic Narrative)로서 완벽한 구조를 갖추고 있습니다. 논문의 제목(Title)을 결정할 때와 내용을 구체화할 때 도움이 될 수 있도록, **학술적 가치를 극대화할 수 있는 전략적 조언**을 드립니다. --- ## 1. 논문 제목 (Title) 결정 가이드 제시하신 두 가지 제목 모두 좋지만, 논문의 성격에 따라 선택이 달라질 수 있습니다. * **옵션 A: [연구 중심형]** > **"인간-AI 상호작연에서 의도 정렬을 높이기 위한 최소 질의 구조 연구"** * **장점:** 연구의 목적(의도 정렬)이 명확하며, '무엇을 연구했는지'가 직관적입니다. 공학 및 HCI(Human-Computer Interaction) 분야 저널에...
+
+## Prevention
+Keep automatic records tied to the active project and verify the relevant test or reproduction path.
@@ -1,11 +1,11 @@
 {
  "projectId": "connectai",
-  "projectName": "ConnectAI",
-  "projectRoot": "/Volumes/Data/project/Antigravity/ConnectAI",
-  "recordRoot": "/Volumes/Data/project/Antigravity/ConnectAI/docs/records/ConnectAI",
+  "projectName": "connectai",
+  "projectRoot": "E:\\Wiki\\connectai",
+  "recordRoot": "E:\\Wiki\\connectai\\docs\\records\\connectai",
  "description": "Auto-created by Project Architecture activation.",
  "corePurpose": "",
  "detailLevel": "standard",
-  "createdAt": "2026-05-13T13:09:33.788Z",
-  "updatedAt": "2026-05-13T17:37:21.922Z"
+  "createdAt": "2026-05-14T00:57:32.245Z",
+  "updatedAt": "2026-05-14T04:39:56.139Z"
 }
@@ -0,0 +1,19 @@
+# ADR: E:\Wiki\connectai self reflection 기능이 있는데 어떻게 SELF REFLECTION이 반영되는지 분석해줘.
+
+## Status
+accepted
+
+## Context
+E:\Wiki\connectai self reflection 기능이 있는데 어떻게 SELF REFLECTION이 반영되는지 분석해줘.
+
+## Decision
+[회의록] 이머시브 스토어 및 AI 스타일링 샵 UI/UX 수정안 리뷰 회의 날짜: 2026년 05월 12일 화요일 참석자: 한지원, 한예성, 한승현 (및 개발/기획팀 인원) 주제 요약: 이머시브 스토어 및 AI 스타일링 샵의 수정된 결과물(모바일/PC UI)을 리뷰하고, 최종 빌드 배포를 위한 개선 사항 및 향후 일정 확정 🔹 요약 보고 * 이머시브 스토어와 AI 스타일링 샵의 최신 빌드를 시연하며 모바일/PC 환경에서의 UI/UX 완성도 점검 * AI 어시스턴트 캐릭터(여성 모델) 도입 및 상품 정보 표시 방식 개선 논의 * 가격 표기 정책을 '정가 기준'으로 통일하여 혼선 방지 결정 * 5월 19일까지 최종 수정 빌드 완료 및 외부 시연용 영상 제작 계획 수동 1. 안건 제목: AI 스타일링 샵 UI/UX 및 이미지 최적화 현황: 썸네일 이미지 해상도 문제로 인한 깨짐 현상 발생 및 캐릭터(제품 중심)와 어시스턴트(사람 중심) 간의 정체성 혼선 핵심 논의: * 이미지 품질: ...
+
+## Reason
+Captured automatically because the conversation contained decision-oriented language.
+
+## Alternatives
+Not captured yet.
+
+## Consequences
+- Future prompts should treat this as project context unless the user changes direction.
@@ -0,0 +1,19 @@
+# ADR: E:\Wiki\connectai self reflection 기능이 있는데 어떻게 SELF REFLECTION이 반영되는지 분석해줘.
+
+## Status
+accepted
+
+## Context
+E:\Wiki\connectai self reflection 기능이 있는데 어떻게 SELF REFLECTION이 반영되는지 분석해줘.
+
+## Decision
+현재 제공된 프로젝트 소스 코드와 아키텍처 문서를 바탕으로, ConnectAI 내에서 **Self-Reflection(자기 성찰)** 기능이 어떤 메커니즘을 통해 구현되어 있고 실제 응답 프로세스에 어떻게 반영되는지 분석하겠습니다. ## 요약 ConnectAI의 Self-Reflection은 단순한 텍록 생성 기능이 아니라, **Multi-Agent Workflow** 단계 중 `Reflector` 에이전트가 개입하여 생성된 계획이나 연구 결과의 결함을 검토하는 **'검증 레이어(Validation Layer)'**로 작동합니다. 이는 `g1nation.enableReflection` 설정에 의해 활성화되며, Planner와 Writer 사이에서 논리적 일관성을 강제하는 역할을 합니다. ## 상세 설명 ### 1. 구현 메커니즘: Multi-Agent Workflow 내의 개입 Self-Reflection은 독립적인 기능이 아니라, 에이전트 협업 프로세스의 중간 단계로 설계되어 있습...
+
+## Reason
+Captured automatically because the conversation contained decision-oriented language.
+
+## Alternatives
+Not captured yet.
+
+## Consequences
+- Future prompts should treat this as project context unless the user changes direction.
@@ -0,0 +1,24 @@
+# Development Log: REFLECTOR 에이전트가 1인 기업 에이전트 목록에는 안보이는데
+
+## Purpose
+Record the implementation or verification outcome from the current conversation.
+
+## Implementation Summary
+맞습니다. 정확한 지적입니다. `src/features/company/agents.ts`에 정의된 **'1인 기업(One-Person Company) 모드'의 9개 전문 에이전트 목록**에는 `Reflector`가 명시적인 독립 에이전트로 존재하지 않습니다. 제가 앞서 설명드린 Self-Reflection은 '1인 기업 모드'의 구성원 목록에 있는 에이전트를 교체하는 것이 아니라, **Multi-Agent Workflow(Planner $\rightarrow$ Researcher $\rightarrow$ Writer)라는 별도의 실행 엔진(Engine) 레이어에서 작동하는 '프로세스 제어 로직'**입니다. 상황을 명확히 정리해 드립니다. ## 요약 `Reflector`는 1인 기업 모드의 '고용된 에이전트(Staff)'가 아니라, 에이전트들이 협업할 때 그 사이에서 감시 역할을 수행하는 **'시스템 워크플로우 레이어(System Workflow Layer)'**의 구성 요소입니다. ...
+
+## Architecture
+Captured automatically from the assistant response and active project context.
+
+## Changed Files
+- src/features/company/agents.ts
+- agents.ts
+- src/lib/engine.ts
+
+## Dependency Notes
+No new dependency note was captured automatically.
+
+## Bugs
+No bugs recorded.
+
+## Lessons
+- Automatic project records should be generated in the background when the turn contains durable project knowledge.
@@ -0,0 +1,16 @@
+# Discussion: 최성연 알아? 칼리버스에서 근무한데
+
+## User Request Summary
+최성연 알아? 칼리버스에서 근무한데
+
+## Interpreted Intent
+Capture a meaningful project discussion automatically instead of requiring manual record selection.
+
+## Questions
+No explicit question was captured.
+
+## Main Discussion
+- 제공해주신 정보와 제가 보유한 지식 범위 내에서는 **'칼리버스(Caliverse)에서 근무하는 최성연'**이라는 특정 개인에 대한 구체적인 프로필이나 공개된 정보를 확인할 수 없습니다. 개인에 대한 정보는 공인(Public Figure)이 아닌 이상 일반적인 데이터베이스나 학습 데이터에 포함되지 않으며, 저의 지식은 공개된 웹 문서, 뉴스, 학술 자료 등을 바탕으로 합니다. 만약 그분이 업계에서 널리 알려진 인물이거나 특정 프로젝트의 핵심 인물로서 언론 등에 보도된 적이 있다면 확인이 가능하겠지만, 현재로서는 알 수 없습니다. 혹시 그분과 관련하여 제가 분석하거나 정리해야 할 문서(예: 인사 기록, 프로젝트 협업 이력 등)가 프로젝트 폴더 내에 있다면, 해당 파일을 읽어 분석해 드릴 수는 있습니다.
+
+## Decisions
+No decisions captured yet.
@@ -126,3 +126,24 @@

 ## 2026-05-13
 - Auto development record created: development/2026-05-13_volumes-data-project-antigravity-connectai-이-프로젝트-작업할거야_implementation.md
+
+## 2026-05-14
+- Auto decision record created: decisions\ADR-0011-e-wiki-connectai-self-reflection-기능이-있는데-어떻게-self-reflection.md
+
+## 2026-05-14
+- Auto decision record created: decisions\ADR-0012-e-wiki-connectai-self-reflection-기능이-있는데-어떻게-self-reflection.md
+
+## 2026-05-14
+- Auto development record created: development\2026-05-14_reflector-에이전트가-1인-기업-에이전트-목록에는-안보이는데_implementation.md
+
+## 2026-05-14
+- Auto bug record created: bugs\BUG-0012-질문이-있어-논문을-쓰려고해-논문-주제는-서비스적이-아닌-사용자가-ai에게-구조로-질문을-해야-사용자의-의도.md
+
+## 2026-05-14
+- Auto bug record created: bugs\BUG-0013-thesis-paper를-쓰려고-하는데-아래와-같이-쓰면-좋을까-이런-식으로-쓰면-되지-않을까-싶음-1-in.md
+
+## 2026-05-14
+- Auto bug record created: bugs\BUG-0014-논문-outline-title-인간-ai-상호작용에서-의도-정렬을-높이기-위한-최소-질의-구조-연구-또는-사.md
+
+## 2026-05-14
+- Auto discussion record created: discussions\2026-05-14_최성연-알아-칼리버스에서-근무한데.md