Community라이팅 & 에디팅github.com

lukehalley/introspect

에이전트에 구애받지 않는 자기 개선 스킬: Claude Code, Codex 및 Cursor 스레드를 읽고 반복되는 수정 사항을 CLAUDE.md / AGENTS.md / .cursor/rules에 규칙으로 변환합니다. /insights의 쓰기 반쪽입니다.

introspect란 무엇인가요?

Introspect는 여러 AI 코딩 에이전트(Claude Code, OpenAI Codex, Cursor)의 대화 기록을 분석하여 반복되는 사용자 선호도, 설정 누락, 재사용 가능한 워크플로를 찾아내고, 사용자 승인 후 해당 에이전트의 설정 파일(CLAUDE.md, AGENTS.md, .cursor/rules)에 직접 기록하는 스킬입니다. 핵심 아이디어는 '일회성 전술이 아닌 반복되는 패턴'에 집중하여 시스템이 지속적으로 개선되도록 하는 것입니다. 도입부에서 언급된 바와 같이 '시스템을 한 번 고쳐서 출력을 천 번 고칠 필요 없게 만드는 것'이 목표입니다. 파이프라인은 수집(Collect) → 추출(Extract) → 차이 분석(Diff) → 변경 제안(Propose) → 승인(Approve) → 적용 및 로깅(Apply + Log)의 6단계로 구성되며, 각 단계마다 사용자의 제어와 안전 장치가 마련되어 있습니다. 특히 안전 모델이 잘 정의되어 있어, 제안-승인 게이트, 반복 임계값, 최대 5개 변경 제한, 기존 규칙 강화/병합을 통한 수렴, 가역적 로깅 등을 통해 무분별한 변경을 방지합니다. 또한 에이전트 간 교차 팁으로 AGENTS.md를 통해 여러 에이전트가 공통 설정을 공유할 수 있도록 하고, 스케줄러를 통한 정기 실행, 무인 실행 시에는 승인 없이 변경하지 않고 보고서만 생성하는 방식으로 안전성을 보장합니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor
npx skills add lukehalley/introspect

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Introspect (자기 성찰)

AI 코딩 스레드에서 일어난 일을 가져와 에이전트가 당신을 위해 작동하는 방식을 변경하세요. 그래서 당신의 설정은 매 세션마다 리셋되는 대신 축적됩니다.

이 스킬은 에이전트에 구애받지 않습니다(agent-agnostic). Claude Code, OpenAI Codex, Cursor의 스레드를 읽고, 변경할 가치가 있는 몇 가지를 찾아내며, 사용자의 승인 하에 향후 세션을 실제로 제어하는 에이전트의 설정에 다시 기록합니다. Claude Code는 이미 /insights를 제공하여 지난 30일을 읽고 보고서를 보여줍니다. 그것이 읽기 반쪽이며, Claude 전용입니다. Introspect는 쓰기 반쪽이며, 사용하는 모든 에이전트에 적용됩니다. 이 아이디어가 나온 스레드에서 Youssef가 잘 표현했습니다: 출력을 천 번 고칠 필요 없도록 시스템을 한 번 고치십시오.

이를 작동하게 만드는 한 가지 아이디어: 전술(tactics)이 아닌 패턴(patterns)

"내가 더 잘할 수 있었던 것은 무엇일까?"라는 질문의 실패 패턴은 전술을 표면화한다는 것입니다. 즉, 하나의 명령에 더 나은 플래그, 하나의 버그에 대한 더 영리한 접근법 같은 것들입니다. 그것들은 축적되지 않습니다. 내일이면 사라집니다.

축적되는 것은 당신이 계속 부딪히는 습관입니다. 세 가지 다른 스레드에서 똑같은 교정을 반복하거나, 매주 다시 말하는 같은 선호도, 또는 테스트 설정을 건드릴 때마다 에이전트가 항상 잘못된 방향으로 가는 경우 같은 것들입니다. 따라서 전체 스킬은 재발에 편향되어 있습니다:

변경 후보는 두 번 이상 나타나고, 이미 어딘가에 기록되어 있지 않으며, 결과를 바꿨을 법한 경우에만 자격을 얻습니다. 그 외 모든 것은 노이즈입니다 — 기록만 하고 실행하지 마십시오.

이것은 해당 스레드에서 사람들이 제기한 두 가지 우려에 대한 정직한 답변이기도 합니다:

  • "잘못된 결정이 축적되거나 내 워크플로가 멍청해질까 걱정됩니다." → 정확한 diff를 보고 승인하지 않으면 아무것도 기록되지 않습니다. 모든 적용된 변경은 기록되고 되돌릴 수 있습니다. 의심스러우면 더 적은 것을 제안하십시오.
  • "매일 스킬을 영원히 업데이트하기만 하는 건가요? 수렴(converge)하나요?" → 수렴해야 합니다. 규칙이 이미 존재하면 강화하거나 병합합니다. 두 번째 규칙을 추가하지 않습니다. 조용한 날에는 빈 변경 세트가 생성되며, 그것은 실패가 아니라 성공입니다.

파이프라인

수집(Collect)  →  추출(Extract)  →  기존 설정과 비교(Diff)  →  변경 세트 제안(Propose)  →  승인(Approve)  →  적용 및 로깅(Apply + Log)
(스크립트)      (사용자)           (사용자, 현재 설정 읽기)       (사용자, 증거 포함)            (사용자)      (사용자, 되돌릴 수 있게)

1. 수집 — 스크립트를 실행하고, 수동으로 다시 구문 분석하지 마십시오

scripts/collect_threads.py는 각 에이전트의 스레드 저장소(Claude의 JSONL, Codex의 롤아웃 파일, Cursor의 SQLite)를 읽고, 기간을 필터링하며, 비밀을 삭제하고, 하나의 공통 다이제스트를 내보냅니다. 세션별로 어떤 에이전트였는지, 사람이 입력한 프롬프트, 사용된 도구, 도구에서 오류가 발생한 위치, 그리고 가벼운 "마찰" 신호(수정처럼 읽히는 프롬프트, 연속으로 여러 번 호출된 도구)를 태그합니다.

python3 scripts/collect_threads.py --days 1               # 오늘, 설치된 모든 에이전트 (자동)
python3 scripts/collect_threads.py --agent all --days 7   # 지난 주, 세 가지 모두 강제
python3 scripts/collect_threads.py --agent codex --format md
python3 scripts/collect_threads.py --since 2026-07-01 --until 2026-07-05 --format json
python3 scripts/collect_threads.py --project ~/dev/myproject   # 하나의 프로젝트
python3 scripts/collect_threads.py --selftest             # 세 파서 모두 정상 작동 확인

--agent 기본값은 auto입니다(설치된 에이전트를 감지). 직접 읽을 때는 --format md를 사용하고, 후처리할 때는 --format json을 사용하십시오. 스크립트는 아무것도 결정하지 않습니다 — 세 가지 다른 대화록 형식을 구문 분석하는 대신 중요한 것에 판단력을 쏟을 수 있도록 깨끗하고 정규화된 원자재를 제공합니다.

2. 추출 — 다이제스트를 읽고 세 가지 종류의 항목을 뽑아내십시오

마치 모든 도구에서 하루를 검토하는 사용자의 비서실장인 것처럼 다이제스트를 읽으십시오. 사용자의 선호도가 가장 우선입니다 — 이 스킬은 주로 에이전트의 기본 행동을 단속하는 것이 아니라 그들이 어떻게 일하기를 좋아하는지 학습하는 것입니다. 다음을 구분하십시오:

  1. 지속적인 선호(핵심 이벤트) — 사용자가 기본값을 수정하거나 자신의 방식을 다시 진술하는 경우("아니요, pnpm 사용", "주석 추가 중단", "항상 먼저 development에서 브랜치를 따세요", "워크트리를 건드리지 마세요"). Claude와 Codex 스레드 모두에서 나타나는 선호는 특히 강력한 신호입니다 — 도구에 관한 것이 아니라 사용자에 관한 것입니다.
  2. 에이전트가 작업을 반복하게 만든 설정 격차 — 여러 세션에 걸쳐 에이전트가 다시 유도하거나 막혔지만, 어떤 것이 기록되지 않았기 때문에 발생한 경우: 빌드 명령을 다시 학습하거나, 항상 같은 위치에 있는 파일을 다시 찾거나, 프로젝트 컨텍스트의 일부가 누락된 경우. 해결책은 누락된 것을 사용자의 설정에 기록하는 것입니다 — 에이전트를 꾸짖는 규칙을 추가하는 것이 아닙니다. 반복이 사용자별 수정 사항이 없는 일반적인 에이전트 행동인 경우(예: "편집하기 전에 파일 읽기"), 그것은 규칙이 아니며 노이즈입니다. 제외하십시오.
  3. 재사용 가능한 워크플로 — 사용자가 두 번 이상 실행한 다단계 작업으로, 스킬이나 명령이 되어 다음 번에는 한 단계로 줄일 가치가 있는 것.

각 후보에 대해 증거를 기록하십시오: 어떤 에이전트, 어떤 세션, 몇 번, 짧은 인용문. 재발 증거가 없으면 → 전술이지 패턴이 아님 → 삭제하십시오.

3. 기존 설정과의 차이 — bloating 방지 / 수렴 단계

무엇이든 제안하기 전에, 관련 에이전트(들)에 대해 이미 무엇이 있는지 읽어서 시스템을 bloating 대신 강화하십시오. references/routing.md에 각 에이전트의 정확한 읽기/쓰기 위치와 형식이 있습니다. 간단한 버전:

에이전트읽을(그리고 나중에 쓸) 기존 설정
Claude~/.claude/CLAUDE.md (전역), ./CLAUDE.md, 프로젝트별 메모리 ~/.claude/projects/<dir>/memory/, ~/.claude/skills/, ~/.claude/commands/
Codex~/.codex/AGENTS.md (전역), <repo>/AGENTS.md (프로젝트), ~/.agents/skills/ 내 스킬
Cursor.cursor/rules/*.mdc (프로젝트), 레거시 .cursorrules, AGENTS.md

각 후보에 대해 질문하십시오: 이미 포함되어 있는가? 그렇다면 → 삭제하거나, 기존 규칙을 날카롭게 하는 작은 편집을 제안하십시오. 거의 같은 내용을 말하는 두 번째 규칙을 절대 추가하지 마십시오. 두 후보가 겹치면 병합하십시오. 추가보다 편집을 선호하십시오.

에이전트 간 팁: AGENTS.md는 Codex와 Cursor가 읽으며, 많은 사람들이 이를 CLAUDE.md에 심볼릭 링크합니다. 선호도가 정말 보편적이라면, 세 번 복제하는 대신 모든 에이전트가 볼 수 있는 곳(하나의 AGENTS.md 또는 CLAUDE.md↔AGENTS.md 심볼릭 링크)에 기록하는 것을 선호하십시오. 쓰기 전에 항상 심볼릭 링크를 확인하여 실제로 어떤 파일을 편집하고 있는지 알 수 있도록 하십시오.

4. 변경 세트 제안 — 증거가 있는 구체적인 diff, 제한됨

변경 세트를 제시하십시오: 각 항목에 대상 에이전트 + 파일, 정확한 편집(diff 또는 명확하게 표시된 before/after), 증거 및 신뢰도가 있는 정렬되고 훑어보기 쉬운 목록입니다. references/changeset-format.md의 형식을 사용하십시오. 두 가지 규칙이 이를 합리적으로 유지합니다:

  • 제한하십시오. 실행당 최대 약 5개의 변경 사항을 표시하고, 신뢰도가 가장 높은 것부터 먼저 표시합니다. 그 외의 것은 "백로그" 섹션으로 이동합니다 — 기록만 하고 적용하지 않습니다. 편집이 범람하면 워크플로가 멍청해질 수 있습니다.
  • 재발률 × 영향으로 순위를 매기십시오. 세 번 언급되어 매 세션마다 수정을 절약할 수 있는 선호도는 영리한 일회성보다 항상 우선합니다.

아무것도 적용되지 않더라도 항상 변경 세트를 날짜가 있는 보고서에 저장하여 나중에 참고할 수 있는 기록을 남기십시오(이는 스레드의 "출력을 어딘가에 저장합니까, 아니면 그냥 읽고 넘어갑니까?" 질문에 답합니다). ~/.introspect/reports/YYYY-MM-DD.md에 기록하십시오.

5. 승인 — 게이트

변경 세트를 표시하고 사용자가 적용할 항목(모두, 일부, 또는 없음)을 선택하도록 하십시오. 기본값은 제안 및 승인입니다 — 명시적인 동의 없이 에이전트의 설정을 편집하지 마십시오. 여러 항목이 있을 때 사용자가 선택할 수 있도록 AskUserQuestion(다중 선택)을 사용하십시오. 사용자가 명시적으로 무인/예약 실행을 요청한 경우 아래의 "무인 실행"을 참조하십시오.

6. 적용 및 로깅 — 되돌릴 수 있게

승인된 각 항목에 대해 올바른 표면에 기록하십시오(전체 형식은 references/routing.md에 있음):

  • Claude — CLAUDE.md: 올바른 ## 섹션 아래에 추가하거나 규칙을 제자리에서 편집합니다. 하우스 스타일(짧고, 명령형이며, 이유를 설명)을 유지하십시오.
  • Claude — 메모리: 노드 파일을 생성/추가하고 MEMORY.md에 인덱스 줄 하나를 추가합니다. feedback_* / project_* / reference_* 규칙 및 [[wikilink]] 교차 링크와 일치시킵니다.
  • Claude — 스킬/명령: ~/.claude/skills/<name>/SKILL.md 또는 ~/.claude/commands/<name>.md를 생성/편집합니다. 여러 세션이 동일한 도우미 스크립트를 다시 작성한 경우 번들로 묶습니다.
  • Codex — AGENTS.md: 관리되는 블록(<!-- introspect:begin --> … <!-- end -->) 내에 추가하여 재실행 시 멱등성을 유지합니다. 간결하게 유지하십시오(Codex는 AGENTS.md를 약 32KiB에서 자릅니다). 프로젝트 루트 AGENTS.md를 선호하십시오(데스크톱 앱이 전역 파일을 안정적으로 로드하지 않음).
  • Cursor — .cursor/rules/*.mdc: YAML 머리말(alwaysApply: true는 항상 켜짐 선호도, 또는 description: + alwaysApply: false)이 있는 규칙 파일을 작성하십시오. Cursor의 클라우드 "Memories"를 쓰려고 시도하지 마십시오. 규칙 파일을 사용하십시오. Cursor가 실행 중인 동안 라이브 state.vscdb를 쓰지 마십시오.

그런 다음 원장 ~/.introspect/ledger.jsonl에 한 줄을 추가하십시오 — 적용된 변경당 하나의 JSON 객체: {date, agent, target_file, kind, summary, evidence, sessions, undo_hint}. 원장을 사용하면 (a) 설정이 시간이 지남에 따라 어떻게 축적되었는지 보여주고, (b) 나중에 변경을 취소할 수 있습니다. 기존 파일을 편집하기 전에 undo_hint에 이전 상태를 기록하거나 .bak을 유지하십시오.

안전 모델 (이것을 읽으십시오 — 이것이 매일 실행해도 안전한 이유입니다)

  • 강요하지 말고 제안하십시오. 승인 게이트가 기본으로 켜져 있습니다. 사용자는 모든 diff를 봅니다.
  • 재발 임계값. 단일 발생에서 제안하지 마십시오. 습관, 전술이 아닙니다.
  • 수렴하고, 변동하지 마십시오. 거의 중복되는 항목을 추가하는 대신 기존 규칙을 강화/병합하십시오. 아무것도 변경하지 않는 실행은 괜찮으며 조용한 날에는 예상됩니다.
  • 블래스트 반경을 제한하십시오. 실행당 최대 ~5개 변경. 나머지는 백로그로.
  • 규칙은 사용자에 관한 것이지, 에이전트에 관한 것이 아닙니다. 사용자가 어떻게 일하기를 원하는지 포착하십시오. 에이전트의 기본 역량을 다시 진술하는 규칙(예: "편집하기 전에 읽기")을 만들어 내지 마십시오 — 그것은 bloat입니다. "에이전트가 막혔다 / 스스로를 반복했다" 신호는 사용자 설정의 일부를 기록하는 것이 반복을 방지할 수 있는 경우에만 변경 자격을 얻습니다.
  • 비밀을 절대 저장하지 마십시오. 수집기는 일반적인 키/토큰 형태를 삭제하지만, 경계를 늦추지 마십시오: API 키, 비밀번호, .env 값 또는 토큰을 규칙이나 보고서에 복사하지 마십시오. 발견하면 제외하고 (라이브처럼 보이면) 사용자에게 알리십시오.
  • 되돌릴 수 있습니다. 적용된 모든 것은 실행 취소 힌트와 함께 원장에 있습니다.
  • 올바른 표면, 올바른 범위. 사용자 전체 선호도 → 해당 에이전트의 전역 파일. 프로젝트별 사실 → 해당 프로젝트의 설정. 프로젝트 세부 사항을 전역 파일에 넣지 마십시오.

트리거 — 실행하는 세 가지 방법

  1. 요청 시. "내 스레드 검토", "introspect 실행", "이번 주에 Claude와 Codex에서 내가 계속 반복한 것은?", "오늘의 수정 사항을 규칙으로 전환". 기본 창: 오늘.
  2. 매일 / 예약됨(하네스 네이티브). 하네스의 네이티브 스케줄러(schedule 스킬 또는 CronCreate 루틴 도구)를 통해 실행을 등록하십시오. OS cron, launchd 또는 쉘 루프가 아닙니다. 네이티브 스케줄링은 동일한 도구와 권한으로 하네스 내에서 루틴을 실행하며, 사용자는 /schedule로 관리합니다. 좋은 기본값은 하루에 한 번 저녁 시간에 해당 날짜의 창에 대해 실행하는 것입니다.
  3. N-세션마다 / 마찰 시(선택 사항). 어떤 사람들(소스 스레드의 buildooor 참조)은 시간 기준보다 문제가 발생했을 때 또는 약 10세션마다 이 트리거를 선호합니다. 호출 횟수를 계산하고 N 후에 알림을 보내는 Stop 후크로 연결하십시오. 제공하십시오. 승인 없이 후크를 설치하지 마십시오.

무인 실행

사람이 없는 일정/루틴에 의해 호출된 경우, 에이전트의 설정에 변경 사항을 자동으로 적용하지 마십시오. 대신 파이프라인을 실행하고, 제안된 변경 세트가 포함된 날짜 보고서를 ~/.introspect/reports/에 기록하고, 사용자가 다음 대화형 세션에서 승인할 수 있도록 (루틴의 알림을 통해) 짧은 요약을 표시하십시오. 무인으로 자동 적용해도 안전한 유일한 범주는 아무것도 복제하지 않는 새로운 Claude 메모리 노드입니다 — 그리고 그 경우에도 기록하십시오. 축적을 인간의 통제 하에 유지하십시오. 그것이 핵심입니다.

참조

  • references/routing.md — 에이전트별 읽기 소스 + 쓰기 표면 + 정확한 디스크 형식(CLAUDE.md, 메모리, AGENTS.md, .cursor/rules/*.mdc) 및 수집기가 사용하는 대화록 스키마.
  • references/changeset-format.md — 변경 세트 + 보고서 + 원장 템플릿.
  • scripts/collect_threads.py — 다중 에이전트 수집기(확인을 위해 --selftest 실행).

전체 내용이므로 핵심 루프를 반복합니다: 모든 에이전트에서 스레드를 수집 → 반복되는 패턴(일회성 전술이 아님) 찾기 → 이미 기록되지 않았는지 확인 → 작고 제한적이며 증거 기반의 변경 세트 제안 → 승인된 것만 올바른 에이전트 설정에 적용 → 되돌릴 수 있게 기록.

관련 스킬