Keep the thread.작업의 맥락을 이어갑니다.

02memory 플러그인이 하나 더 필요한 게 아닙니다.

memory 도구는 "무슨 일이 있었지?"에 답합니다. Whyve는 "우리가 왜 이렇게 정했고, 이걸 바꿔도 되나?"에 답합니다.

claude-mem과 Claude Code 내장 auto memory는 세션에서 일어난 일을 자동으로 담습니다. Whyve가 남기는 것은 그보다 좁습니다. 조용히 뒤집히면 안 되는 선택을, 이유와 적용 범위, 무엇이 무엇을 대체했는지까지 함께 기록합니다. 무엇을 남길지는 사람이 승인하거나, 알아서 기록하는 모드를 고르면 됩니다.

둘은 함께 씁니다. 쓰던 memory 도구는 그대로 두고, 결정만 Whyve에 맡기세요.

claude-mem은 무슨 일이 있었는지를 기억합니다. Whyve는 왜 그렇게 정했는지를 지킵니다.

03결정 하나를 두 세션, 세 번의 요청에 걸쳐 따라가 봅니다.

README에 있는 예제 그대로입니다. 설치한 뒤 내 프로젝트에서 직접 해 보세요. 어두운 상자는 녹화에 쓴 실제 실행의 답을 고치지 않고 옮긴 것입니다. 녹화는 영어로 진행했습니다.

1. 1. 첫 세션에서 정하기

   이 체험판은 CSV만 지원하고 Excel은 다음으로 미루기로 결정했어. 첫 사용 흐름을 빨리 검증하려는 선택이야. 이 결정을 기억해 줘.

   $ claude -p "I decided this trial will support CSV only and leave Excel for later. I want to validate the first-use flow quickly. Remember this decision."
   I saved this as a project decision: the trial will support CSV only, and Excel is left for later. The reason is to validate the first-use flow quickly. There was no earlier decision on file formats, so nothing conflicts with it.
   
   - File: context/decision/Trial-supports-CSV-only-Excel-deferred.md
   - Scope: trial-importer, with the decision key trial-import-file-formats
   
   You didn't say when to come back to Excel support, so I didn't record a condition for that. If you want one, such as "once the first-use flow is validated," tell me and I'll add it.
   
   $ ls context/decision
   Trial-supports-CSV-only-Excel-deferred.md
   decision.index.md

   Whyve가 무엇을 기록했는지, 결정과 이유를 확인해 줍니다.

2. 2. 새 세션에서 이유 묻기

   우리가 Excel 지원을 미룬 이유가 뭐였지?

   $ claude -p "Why did we postpone Excel support?"
   Excel support was postponed to validate the first-use flow quickly.
   
   The current decision for trial-importer (context/decision/Trial-supports-CSV-only-Excel-deferred.md) says:
   
   - Decision: This trial supports CSV only. Excel support is left for later.
   - Rationale: Validate the first-use flow quickly.
   - Rejected alternatives: Supporting Excel in this trial (deferred to later).
   
   The record doesn't set a condition for when to revisit Excel. It is deferred, not ruled out, so bringing it back is still an open choice for later.

   새 세션은 앞의 대화를 모릅니다. 저장된 이유를 읽어서 답합니다.

3. 3. 같은 세션에서 나중에 바꿔 보자고 하기

   Excel도 이번 체험판에 넣는 건 어떨까? 아직 결정 변경은 아니야.

   $ claude -p --continue "What about including Excel in this trial too? I haven't decided to change the decision yet."
   This would conflict with the current decision for trial-importer (trial-import-file-formats):
   
   - Decision: "This trial supports CSV only. Excel support is left for later."
   - Rationale: "Validate the first-use flow quickly."
   - Rejected alternatives: "Supporting Excel in this trial (deferred to later)."
   
   The record has no condition for revisiting it, so nothing in it signals that now is the time. Since you haven't decided, I'm treating this as discussion only. I won't change any code or the decision record.
   
   Reasons to keep CSV only:
   - It still fits the stated goal. The first-use flow gets validated with fewer moving parts.
   - Excel adds work that isn't about the flow itself: sheets, merged cells, dates stored as numbers, formulas, encoding quirks, and a new parsing library.
   - If the trial goes badly, you'll know the cause is the flow, not the file parsing.
   
   Reasons to add Excel now:
   - If most target users keep their data in .xlsx, a CSV-only trial may measure people giving up at the export step, not the flow itself.
   - If the import pipeline is already format-neutral, adding Excel later may cost about the same as adding it now.
   
   A middle option: keep CSV only, but track how often users try to upload .xlsx or ask for it. That gives you evidence for when to revisit without changing scope.
   
   When you're ready to decide: keep CSV only for this trial, or supersede the decision and include Excel? If you choose supersede, I'll update the decision record and then start the implementation work.

   Whyve는 이 제안을 기존 결정과 그 이유 옆에 나란히 놓습니다. 아무것도 바뀌지 않습니다. 사람이 정하기 전까지 제안은 제안일 뿐입니다.

세션 ID와 버전까지 담긴 전체 기록: assets/demo/transcript.txt

04기록 규칙을 내가 고르는 Markdown 기록.

기록은 context/ 폴더의 Markdown 파일입니다. Git은 쓰든 안 쓰든 괜찮습니다. 별도 서버도, 데이터베이스도, API 키도 필요 없습니다.

프로젝트에서 $whyve:init을 실행해 어떤 기록 종류를 쓸지, 기록을 어떻게 승인할지 고릅니다. 처음에는 Decision과 explicit으로 시작합니다.

어떤 모드에서도 모델이 자기 선호를 사람의 결정으로 기록하지 않습니다.

05이미 쓰는 에이전트에 명령 두 줄이면 됩니다.

$ codex plugin marketplace add https://github.com/swimit-io/whyve.git
$ codex plugin add whyve@whyve

$ claude plugin marketplace add https://github.com/swimit-io/whyve.git --scope user
$ claude plugin install whyve@whyve --scope user

플러그인, 라이브러리, CLI 모두 Node.js 20.20.0 이상이 필요합니다.

설치한 뒤 호스트를 다시 불러오거나 새 세션을 열고, 프로젝트에서 $whyve:init(Codex) 또는 /whyve:init(Claude Code)을 실행하세요.

TypeScript 라이브러리나 CLI를 직접 쓰려면 설치·라이브러리 API 문서를 참고하세요.

기존 context-* 플러그인을 쓰고 있다면 먼저 비활성화하세요. 두 세대를 함께 돌리지 않습니다.

06확인한 것과 아직 확인하지 못한 것.

07문서는 코드와 같은 저장소에 있습니다.

• 설치와 라이브러리 APIdocs/node-api.ko.md
• 호환성과 전환 절차 (영문)docs/compatibility.md
• 기록 종류별 안내docs/modules/
• Bobbin에서 옮겨 오기 (영문)MIGRATION.md
• 변경 기록 (영문)CHANGELOG.md

09Whyve Cloud를 준비하고 있습니다.

어느 기기에서 작업하든 같은 컨텍스트를, Git 없이 맞춰 둡니다. Whyve 자체는 지금처럼 오픈소스이고 로컬에서 동작합니다.

10이름에 담은 뜻

Whyve와 Howse는 한 가지 믿음에서 나왔습니다. 에이전트와 함께 일할 때, 그 일의 이유와 팀이 일하는 방식은 내가 가진 파일로 남아 있어야 한다는 것입니다.

Whyve = why + weave

Whyve는 why(왜)와 weave(엮다)를 합친 이름입니다. 선택의 이유를 한 올로 엮어 세션에서 세션으로 이어 갑니다. 형제 제품 Howse는 how(어떻게)와 house(품다)를 합친 이름으로, 에이전트들이 일하는 방식을 한 집에 품습니다.

Whyve가 바탕이고, Howse는 그 위에 지은 첫 제품입니다.

만든 사람: Jinwuk Lee · @Jeis-Jw