uditgoenka/autoresearch

<div align="center">

Autoresearch

Claude Code, OpenCode, 또는 OpenAI Codex를 끊임없는 개선 엔진으로 바꾸세요.

Karpathy의 autoresearch 기반 — 제약 조건 + 기계적 지표 + 자율 반복 = 복리 효과.

<br>

"목표를 설정하세요 → 에이전트가 루프를 실행합니다 → 결과를 보고 깨어나세요"

AGI가 필요하지 않습니다. 목표, 지표, 그리고 포기하지 않는 루프만 있으면 됩니다.

Claude Code, OpenCode, OpenAI Codex를 지원합니다. 14개의 명령어. 9개의 안전 후크. 호출당 토큰 95% 감소.

v2.2.0 — 자율 오케스트레이터: /autoresearch에 일반 언어로 된 목표를 입력하면 목표를 분류하고, 성공 조건을 도출하고, 한 번 확인한 후, 완료될 때까지 하위 명령어를 반복합니다. 수동 체이닝이 필요하지 않습니다. Metric:/Verify: 호출은 클래식 루프를 변경 없이 실행합니다. guide/autoresearch-orchestrator.md를 참조하세요.

<br>

작동 방식 · 명령어 · 빠른 시작 · 가이드 · FAQ

</div>

     PLAN             LOOP            DEBUG             FIX             SECURE            SHIP
 ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
 │   Goal   │     │  Modify  │     │   Find   │     │   Fix    │     │  STRIDE  │     │  Stage   │
 │  Metric  │────▶│  Verify  │────▶│   Bugs   │────▶│  Errors  │────▶│  OWASP   │────▶│  Deploy  │
 │  Scope   │     │Keep/Drop │     │  Trace   │     │  Repair  │     │ Red Team │     │ Release  │
 └──────────┘     └──────────┘     └──────────┘     └──────────┘     └──────────┘     └──────────┘
 /autoresearch:   /autoresearch    /autoresearch:   /autoresearch:   /autoresearch:   /autoresearch:
   plan                              debug            fix              security         ship

 ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
 │  Probe   │     │ Scenario │     │ Predict  │     │  Reason  │
 │ Require- │     │   Edge   │     │ 5-Expert │     │  Debate  │
 │  ments   │     │  Cases   │     │  Swarm   │     │ Converge │
 └──────────┘     └──────────┘     └──────────┘     └──────────┘
 /autoresearch:   /autoresearch:   /autoresearch:   /autoresearch:
   probe            scenario         predict          reason

 ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
 │  Learn   │     │ Improve  │     │   Eval   │     │ Baseline │
 │   Docs   │     │ Research │     │ Analyze  │     │   Diff   │
 │   Gen    │     │   PRDs   │     │ Results  │     │ Verdict  │
 └──────────┘     └──────────┘     └──────────┘     └──────────┘
 /autoresearch:   /autoresearch:   /autoresearch:   /autoresearch:
   learn            improve          evals            regression

존재 이유

Karpathy의 autoresearch는 630줄의 Python 스크립트가 간단한 원칙(하나의 지표, 제한된 범위, 빠른 검증, 자동 롤백, git을 메모리로 사용)을 따라 하룻밤 사이에 ML 모델을 자율적으로 개선할 수 있음을 보여주었습니다 — 밤새 100번의 실험.

Claude Autoresearch는 이러한 원칙을 모든 도메인으로 일반화합니다. ML뿐만 아니라 코드, 콘텐츠, 마케팅, 영업, HR, DevOps 또는 측정 가능한 숫자가 있는 모든 것에 적용됩니다.

v2.1.0은 주요 아키텍처 재구축입니다. 모놀리식 SKILL.md(813줄, 호출당 ~100K 토큰)는 얇은 41줄 라우팅 파일과 12개의 자체 포함 명령어 파일(각 94–120줄, 호출당 ~5–8K 토큰)로 대체되었습니다. 이는 동일한 기능 표면에서 95% 토큰 감소입니다.

작동 방식

루프 (N회 반복 또는 완료될 때까지):
  1. 현재 상태 + git 히스토리 + 결과 로그 검토
  2. 다음 변경 사항 선택 (작동한 것, 실패한 것, 시도되지 않은 것 기반)
  3. 하나의 집중된 변경 수행
  4. Git 커밋 (검증 전)
  5. 기계적 검증 실행 (테스트, 벤치마크, 점수)
  6. 개선됨 → 유지. 악화됨 → git 되돌리기. 충돌 → 수정 또는 건너뛰기.
  7. 결과 기록
  8. N회 반복 완료 또는 목표 달성까지 반복.

모든 개선은 누적됩니다. 모든 실패는 자동으로 되돌려집니다. 진행 상황은 TSV 형식으로 기록됩니다.

설정 단계

루핑 전에 Claude는 일회성 설정을 수행합니다:

1. 컨텍스트 읽기 — 범위 내 모든 파일 읽기
2. 목표 정의 — 기계적 지표 추출 또는 요청
3. 범위 정의 — 수정 가능한 파일 vs 읽기 전용 파일
4. 기준 설정 — 현재 상태에서 검증 실행 (반복 #0)
5. 확인 및 시작 — 설정을 표시한 후 루프 시작

8가지 중요 규칙

후크 및 안전

v2.1.1은 세션을 자동으로 보호하는 9-후크 안전 시스템을 제공합니다. 후크는 autoresearch 명령어 중에만이 아니라 모든 세션에서 실행됩니다.

보호되는 항목

구성

모든 후크는 기본적으로 켜져 있습니다. 개별적으로 비활성화:

# 특정 후크 비활성화
export AR_DISABLE_SCOUT_BLOCK=1
export AR_DISABLE_PRIVACY_BLOCK=1
export AR_DISABLE_DANGEROUS_CMD_BLOCK=1
#... 각 후크 이름에 대해 동일

세션 완료 알림을 위한 선택적 웹훅:

export AR_NOTIFY_WEBHOOK=https://hooks.slack.com/services/...

프로젝트 루트에 .ckignore 파일(gitignore 구문)을 사용하여 차단된 디렉토리 사용자 정의.

전체 참조는 guide/hooks.md를 참조하세요.

명령어

범용 플래그: Iterations: N, Iterations: unlimited, --evals, --evals-interval N, --chain <targets>, --<subcommand> 단축.

모든 명령어는 인수 없이 호출될 때 대화형 설정을 사용합니다. 명령어를 입력하기만 하면 에이전트가 코드베이스를 기반으로 스마트 기본값과 함께 필요한 것을 묻습니다.

OpenCode 사용자: 명령어는 밑줄 명명법(/autoresearchdebug, /autoresearchfix 등)을 사용합니다. 14개 명령어 모두 사용 가능.

>

Codex 사용자: $autoresearch 멘션 구문을 통해 호출합니다. 하위 명령어는 키워드입니다: $autoresearch debug, $autoresearch plan 등.

빠른 결정 가이드

빠른 시작

Claude Code

옵션 A — npx 설치 (권장):

npx skills add uditgoenka/autoresearch

Claude Code를 다시 시작하면 14개 명령어를 모두 사용할 수 있습니다.

옵션 B — 플러그인 설치:

/plugin marketplace add uditgoenka/autoresearch
/plugin install autoresearch@autoresearch

참고: 설치 후 새 Claude Code 세션을 시작하세요. 참조 파일은 설치가 발생한 동일한 세션에서 확인할 수 없습니다. 이는 Claude Code 플랫폼 제한 사항입니다.

업데이트 (재설치 불필요):

/plugin update autoresearch

/reload-plugins를 실행하여 활성화하세요. 제거하거나 다시 클론할 필요가 없습니다.

옵션 C — 수동 복사:

git clone https://github.com/uditgoenka/autoresearch.git

# 스킬 + 하위 명령어를 프로젝트에 복사
cp -r autoresearch/.claude/skills/autoresearch.claude/skills/autoresearch
cp -r autoresearch/.claude/commands/autoresearch.claude/commands/autoresearch
cp autoresearch/.claude/commands/autoresearch.md.claude/commands/auto

[...truncated...]