| name | ideation |
| model | opus |
| effort | max |
| description | 사용자와의 대화를 raw/agents/에 저장하고, 핵심 결정·제약·열린 질문을 docs/note/에 아이디에이션 노트로 정리한다. sources/entities/concepts/analyses는 생성하지 않는다. "아이디에이션 정리해줘", "ideation", "지금 대화 노트로 남겨줘" 등의 요청에 반응한다. |
| argument-hint | <주제 slug (선택)> |
Ideation
사용자와의 탐색적 대화를 보존하는 경량 skill이다. /ingest와 달리 지식 그래프(sources/entities/concepts/analyses)를 건드리지 않고, 대화 원본을 raw/agents/에, 정제된 아이디에이션 노트를 docs/note/에만 남긴다. 생성된 노트는 LanceDB에 인덱싱되어 /search 대상이 된다.
언제 사용하나
- 사용자가 결정을 확정하지 않은 탐색 단계의 대화를 보존할 때
/ingest로 올리기엔 아직 지식 그래프에 편입하기 이른 주관적/잠정적 내용일 때- 사용자의 제약, 선택, 열린 질문이 향후 리서치·설계의 맥락이 될 때
/ingest와의 차이:
| 관점 | /ideation | /ingest |
|---|
| 성격 | 주관적 탐색, 결정 중 | 객관적 지식, 정제됨 |
| 출력 | raw/agents/ + docs/note/ | raw/ + docs/{sources,entities,concepts,analyses}/ |
| 기존 노드 | 참조만 (읽기 전용) | 수정/확장 |
| 인덱싱 | LanceDB 포함 | LanceDB 필수 |
| 충돌 처리 | 사용자 의견으로 기록 | 지식 모순 보고 절차 |
사용법
/ideation # 현재 대화 전체를 자동 주제 추출로 정리
/ideation 2d-pixel-topdown-pipeline # 주제 slug 지정
Instructions
Step 1: 주제 slug 결정
- 인자로 주어지면 그대로 사용
- 없으면 대화의 핵심 주제를 kebab-case로 도출 (예:
2d-pixel-topdown-pipeline, character-chat-monetization)
- 파일명에 사용되므로 영문 kebab-case 필수
Step 2: 대화 원본을 raw/agents/에 저장
경로: raw/agents/YYYY-MM-DD_{topic-slug}-dialogue.md
내용 구성:
- 메타: 날짜, 주제, 형태("사용자-Agent 대화 기록")
- 대화 흐름: 각 유저 질문(Q1, Q2 …)과 Agent 답변 요약을 순서대로 기록
- 사용자 발언은 원문 인용
- Agent 답변은 핵심만 압축 (표/코드 블록은 보존)
- 추출된 사용자 의사결정: 번호 매긴 리스트
- 열린 질문: 사용자가 아직 결정하지 못한 항목
raw 파일은 불변 기록이다. 이후 생각이 바뀌어도 원본은 남긴다.
Step 3: docs/note/에 아이디에이션 노트 생성
경로: docs/note/{topic-slug}.md
Frontmatter 스키마
---
id: "주제-slug (파일명과 동일)"
title: "사람이 읽는 제목 — 아이디에이션"
type: "ideation"
group: "note/{카테고리}"
tags: ["태그1", "태그2", ...]
dialogue: "raw/agents/YYYY-MM-DD_{topic-slug}-dialogue.md"
links:
- "[[기존-노드-id-1]]"
- "[[기존-노드-id-2]]"
created: "YYYY-MM-DD"
updated: "YYYY-MM-DD"
status: "exploring | decided | archived"
summary: "한 줄 요약"
---
주의사항:
type은 항상 "ideation"group은 note/{카테고리} 형식 (예: note/gamedev, note/infra) — 검색/시각화 그룹화용dialogue 필드는 Step 2에서 생성한 raw 파일 경로links는 기존 지식 노드를 참조 (다른 노드 타입과 동일한 wikilink 배열 — fan-out에서 traversal됨)status는 exploring(탐색 중) / decided(결정 완료) / archived(보류)
본문 구조
다음 5개 섹션을 순서대로 작성한다.
# {제목}
## 목표
사용자가 왜 이 주제를 탐색하는지, 무엇을 달성하려 하는지 한두 단락으로.
## 핵심 아이디어
대화에서 도출된 모든 사고를 담는 섹션. 다음을 포함한다:
- **현재 선택 / 파이프라인**: 이미 채택한 도구, 구조, 방법
- **선택 사항 (옵션 비교)**: 검토한 대안과 트레이드오프
- **비범한 발상 / 메타 통찰**: 단축 경로, 우회 전략, 일반론을 깨는 관점
- **구현 전략**: Phase 분할, 점진적 확장 계획, 핵심 알고리즘 스케치
- **참조 패턴**: 차용한 외부 사례·표준 (예: RPG Maker A2 quadrant 방식)
자유롭게 하위 ### 헤딩으로 분할하되, 모든 사고가 이 섹션 안에 모이도록 한다.
## 주요 결정 및 제약
각 결정마다:
- **결정**: 무엇을 선택했는지
- **이유**: 왜 그 결정을 내렸는지
- **트레이드오프**: 알려진 장단점
- **대응 전략**: 단점을 어떻게 보완하는지
## 추가 과제
체크박스 리스트. 아직 결정·구현되지 않은 항목, 다음 세션에서 다룰 후속 작업.
## 관련 노드
- [[node-id]] — 이 아이디에이션과의 관계 (한 줄 설명)
frontmatter `links`와 본문 `[[wikilink]]`는 **양방향 일관성** 유지 (validator가 체크).
Step 4: 기존 노드는 수정하지 않는다
/ingest와 달리 기존 sources/entities/concepts/analyses 파일을 편집하지 않는다links 필드로 참조만 하고, 대상 노드에는 backlink를 추가하지 않는다 (단방향 참조)- 단, 아이디에이션이
decided 상태로 전환되어 지식화가 필요해지면 그때 /ingest를 별도로 실행
Step 5: 검증
make validate-file FILE=docs/note/{topic-slug}.md
확인 항목:
id = 파일명 (확장자 제외)type = "ideation"status ∈ exploring | decided | archived- frontmatter
links의 모든 target이 본문 [[wikilink]]에 존재
- 본문에
## 관련 노드 섹션 존재
Step 6: LanceDB 인덱싱
make index-file FILE=docs/note/{topic-slug}.md
이로써 /search로 아이디에이션 노트도 검색되고, fan-out으로 연결된 지식 노드까지 탐색 가능.
아이디에이션 상태 전이
exploring ──(결정 확정)──▶ decided ──(지식화 완료)──▶ archived
│
└─(/ingest로 지식 그래프 편입)
- exploring: 기본 상태. 결정이 유동적
- decided: 주요 결정이 확정됨. 이제
/ingest로 지식화 가능
- archived: 보류되거나 방향이 바뀌어 더 이상 추적하지 않음
산출물 요약
/ideation 실행 후:
raw/agents/YYYY-MM-DD_{topic}-dialogue.md — 대화 원본 (불변)docs/note/{topic}.md — 정제된 아이디에이션 노트 (LanceDB 인덱싱, 업데이트 가능)
건드리지 않는 것: docs/sources/, docs/entities/, docs/concepts/, docs/analyses/
