태양 및 우주환경연구실(SSWL) AI 하네스 운용 저장소.
연구실에서 개발된 모델들을 아카이빙·관리하고, 연구자의 요청에 따라 데이터 수집·모델 실행·결과 보고를 수행하며, 연구 아이디어를 빠른 실험 결과로 전환하는 AI 하네스.
SSWL-harness-ops/
├── .claude/ ← 루트 하네스 (연구 업무 범용)
│ ├── CLAUDE.md
│ ├── agents/ (5개)
│ └── skills/ (3개)
│
├── 01-research-production/ ← 연구 생산 하네스 (논문 파이프라인)
│ └── .claude/
│ ├── CLAUDE.md
│ ├── agents/ (5개)
│ └── skills/ (3개)
│
├── 02-conference-presentation-generator/ ← 학회 발표 PPT 생성 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ ├── agents/ (5개)
│ └── skills/ (3개)
│
├── 03-paper-writer/ ← 논문 작성 및 피어리뷰 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ ├── agents/ (5개)
│ └── skills/ (4개)
│
├── 04-paper-mate/ ← 논문 번역 및 분석 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ ├── agents/ (6개)
│ └── skills/ (1개)
│
├── 05-symbolic-regression/ ← Symbolic Regression 연구 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ ├── agents/ (4개)
│ └── skills/ (3개)
│
├── 06-paper-editor/ ← 논문 교정 및 모의 피어리뷰 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ └── agents/ (5개)
│
├── 07-idl2python/ ← IDL→Python 코드 변환 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ ├── agents/ (4개)
│ └── skills/ (3개)
│
├── 08-DEM-calc/ ← DEM 계산 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ ├── agents/ (4개)
│ └── skills/ (1개)
│
├── 09-tex-editor/ ← LaTeX 원고 컴파일·검토·수정 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ └── agents/ (4개)
│
├── 99-SSWL-skill-collector/ ← 연구실 코드 → 스킬 변환 하네스
│ └── .claude/
│ ├── CLAUDE.md
│ ├── agents/ (6개)
│ └── skills/ (4개)
│
├── docs/ # 프로젝트 참고 문서
└── PPT/ # 팜플렛/발표 자료
Claude Code는 claude 명령을 실행한 디렉토리의 .claude/만 읽습니다.
cd 위치에 따라 다른 하네스가 활성화됩니다.
cd /home/youn_j/SSWL-harness-ops
claude데이터 수집, 모델 실행, 모델 아카이빙 등 범용 연구 업무를 처리합니다.
| 에이전트 | 역할 |
|---|---|
| research-planner | 요청 분석, 실험 설계, 실행 계획 |
| data-engineer | 데이터 수집/검증, 모델 등록 |
| research-executor | 파이프라인 실행, 모델 실행 |
| paper-writer | 결과 보고, 논문 초안 |
| reviewer | 품질 검토, 교차 검증 |
> "최근 1달 SDO/HMI 데이터로 synoptic map 만들어줘"
> "코로나홀 탐지 모델을 등록해줘"
cd /home/youn_j/SSWL-harness-ops/02-conference-presentation-generator
claude연구 결과를 입력하면 콘텐츠 추출 → 스토리 설계 → 슬라이드 구성 → PPTX 생성 → 발표 코칭까지 수행합니다.
| 에이전트 | 역할 |
|---|---|
| content-extractor | 논문/결과에서 핵심 메시지, Figure 추출 |
| story-architect | 발표 내러티브 설계, 시간 배분 |
| slide-composer | 슬라이드별 콘텐츠/레이아웃 구성 |
| pptx-engineer | python-pptx로 실제 .pptx 파일 생성 |
| deck-reviewer | 품질 검토 + 발표자 가이드/Q&A 준비 |
> "01-research-production의 태양 플레어 연구 결과로 15분 AGU 발표 PPT 만들어줘"
cd /home/youn_j/SSWL-harness-ops/03-paper-writer
claude연구 결과를 입력하면 논문 초안 작성 → 에디터 접수 → 리뷰어 병렬 심사 → 리비전 → 판정까지 실제 저널 피어리뷰 프로세스를 시뮬레이션합니다. 최대 3회 리비전 후 Accept 시 저널 템플릿 기반 LaTeX + PDF를 생성합니다.
| 에이전트 | 역할 |
|---|---|
| researcher | 연구 결과 정리, 논문 초안 + 커버레터 작성, 리비전 수행 |
| co-worker | 한 문장씩 검토: 논리 흐름, 용어 통일, 팩트체크, 내부 용어 차단 |
| editor | 논문 접수, 리뷰어 배정(전문분야/성격), 리뷰 취합, 판정 |
| reviewer-1 | 한줄씩 팩트체크, 전문분야 중심 리뷰 |
| reviewer-2 | 한줄씩 팩트체크, reviewer-1과 다른 전문분야 중심 리뷰 (병렬) |
> "이 연구 결과로 ApJ에 투고할 논문 써줘"
> "01-research-production의 태양 플레어 연구 결과로 논문 만들어줘"
cd /home/youn_j/SSWL-harness-ops/04-paper-mate
claude영어 논문을 입력하면 챕터별 병렬 번역 → 용어 통일 → 참고문헌 분석 → Q&A 답변까지 수행합니다.
| 에이전트 | 역할 |
|---|---|
| paper-fetcher | 논문 확보, 구조 분석, 그림 목록 추출 |
| chapter-translator | 챕터/섹션을 한국어로 병렬 번역 |
| figure-analyst | 그림의 시각적 내용·인사이트를 한국어로 상세 설명 |
| context-harmonizer | 병렬 번역 챕터 통합, 용어 통일, 문맥 조정 |
| reference-analyst | 참고문헌 중요도 분류, 필수 논문 요약 |
| qa-companion | 번역 완료 후 사용자 Q&A 답변 |
> "이 논문 번역해줘" (DOI, 제목, 파일 경로 제공)
cd /home/youn_j/SSWL-harness-ops/01-research-production
claude연구 주제를 던지면 문헌조사 → 설계 → 실행 → 검토 → 논문까지 자동 수행합니다.
| 에이전트 | 역할 |
|---|---|
| literature-reviewer | arXiv/ADS 문헌조사, 연구 갭 식별 |
| research-designer | 가설/실험/평가지표 설계 |
| research-executor | Python 코드 작성/실행, Figure/Table |
| paper-writer | 논문 초안 (Figure+Table 5개 이내) |
| reviewer | PASS/REVISE 판정, 레퍼리 심사 |
> "GOES XRS 데이터를 이용한 태양 플레어 전구체 패턴 분석 연구를 해줘"
cd /home/youn_j/SSWL-harness-ops/05-symbolic-regression
claude데이터와 연구 질문을 입력하면 데이터 진단 → 도구 라우팅 → 다중 SR 도구 병렬 실행 → SymPy 후처리 → Pareto/LaTeX 보고까지 수행합니다. PySR을 디폴트로 두고, 데이터 형태와 단위 정보 유무에 따라 PySINDy(시계열), AI Feynman(단위 정보 보유), NeSymReS·KAN·DSO(비교군) 등을 자동 라우팅합니다.
| 에이전트 | 역할 |
|---|---|
| sr-planner | 데이터 진단, 도구 라우팅, 실행 계획, 사용자 승인 |
| sr-executor | 선택 도구(PySR/DSO/NeSymReS/KAN/Feynman/SINDy/DEAP) 병렬 실행 |
| expression-analyst | SymPy 단순화, 동등성 클러스터링, Pareto front, 차원 분석 |
| sr-reporter | Figure(Pareto/fit/residual), LaTeX 수식, 한국어 해석 보고서 |
> "data/measurement.csv 의 y와 x1, x2 사이 관계를 찾아줘"
> "이 시계열 데이터에서 ODE를 발견해줘"
> "단위가 있는 물리 데이터로 경험식을 찾아줘 (AI Feynman 활용)"
설치는 cd 05-symbolic-regression && bash install.sh (PyPI는 requirements.txt, GitHub 기반 도구는 자동 clone).
cd /home/youn_j/SSWL-harness-ops/06-paper-editor
claude기존 논문(.tex, .pdf, .md)의 문법 교정, 팩트체크, 모의 피어리뷰, 구조 개선을 수행합니다. 작업 모드를 선택하면 해당 에이전트가 실행됩니다.
| 에이전트 | 역할 |
|---|---|
| grammar-editor | 문법·표현·일관성 교정 |
| fact-checker | 수치·주장을 코드/데이터/Figure와 대조 검증 |
| structure-advisor | 섹션 구성·논리 흐름·Figure/Table 배치 분석, 개선안 제시 |
| reviewer | 한줄씩 팩트체크 + 방법론/데이터/해석 평가 (모의 리뷰) |
| reference-finder | NASA ADS/arXiv에서 참고문헌 검색·추천 |
> "이 논문 문법 교정해줘"
> "모의 피어리뷰 돌려줘"
cd /home/youn_j/SSWL-harness-ops/07-idl2python
claudeIDL .pro 파일을 Python으로 변환하고, 테스트를 통해 정확성을 검증합니다. 배열 인덱싱 자동 전치(column-major→row-major), SSW→SunPy/Astropy 매핑, 테스트 데이터 자동 확보를 지원합니다. 다중 파일은 병렬 변환/테스트합니다. dnidever/idl2py 참고.
| 에이전트 | 역할 |
|---|---|
| idl-analyzer | .pro 파싱, 의존성 분석, 변환 계획 수립 |
| python-translator | IDL→Python 구문 변환, 라이브러리 매핑 |
| test-engineer | 테스트 작성, 데이터 확보, 병렬 테스트 실행 |
| conversion-reviewer | 변환 정확성 검증, PASS/REVISE 판정 |
> "solar_prep.pro를 Python으로 변환해줘"
> "이 디렉토리의 IDL 코드를 전부 Python으로 마이그레이션해줘"
cd /home/youn_j/SSWL-harness-ops/08-DEM-calc
claude6개 파장(SDO/AIA 94, 131, 171, 193, 211, 335 Å) 이미지와 온도 응답 함수를 입력받아 DEM(Differential Emission Measure) 맵을 계산하고 시각화합니다. DEMreg(GSVD+Tikhonov)와 SITES(반복적 가중 역산) 두 가지 역산 방법을 지원합니다.
| 에이전트 | 역할 |
|---|---|
| data-validator | 6채널 이미지, 응답 함수 검증 |
| dem-calculator | DEM 역산 (DEMreg / SITES) |
| result-visualizer | DEM 맵 시각화, 멀티 패널 Figure |
| quality-reviewer | 품질 검토, PASS/REVISE 판정 |
> "이 AIA 데이터로 DEM 계산해줘 (DEMreg)"
> "DEMreg와 SITES 양쪽으로 비교 분석해줘"
cd /home/youn_j/SSWL-harness-ops/09-tex-editor
claudeLaTeX 원고(.tex + 보조 파일)를 입력하면 컴파일 → 시각·문법 검토 → 수정된 .tex 출력까지 수행합니다. GPT Prism과 유사한 AI LaTeX 편집기 역할을 로컬 에이전트 팀으로 구현했습니다. 로그 경고뿐 아니라 PDF 페이지를 PNG로 렌더해 실제로 시각 문제(표 잘림, 그림 마진 초과, 캡션 분리 등)를 관찰합니다.
| 에이전트 | 역할 |
|---|---|
| latex-compiler | latexmk 컴파일, 로그 파싱(에러·경고·미해결 참조), pdftoppm으로 페이지 PNG 렌더링 |
| visual-inspector | PNG를 직접 관찰해 시각 문제 탐지 (표 잘림, 그림 overflow, 캡션 분리, 페이지 경계 이상 등) |
| grammar-checker | 영문 문법 오류·오탈자만 보수적으로 검토 (내용·문체 불간섭) |
| tex-editor | 3개 리포트 통합하여 revised.tex 생성 (컴파일 에러 해소 최우선) |
> "이 tex 파일 편집해줘: /home/youn_j/papers/my_paper/main.tex"
cd /home/youn_j/SSWL-harness-ops/99-SSWL-skill-collector
claude연구실에 축적된 코드, 스크립트, 유틸리티를 분석·분류하여 재사용 가능한 Claude Code 스킬로 변환합니다. 로컬 또는 원격 서버의 코드를 수집할 수 있습니다.
| 에이전트 | 역할 |
|---|---|
| remote-collector | SSH 기반 원격 서버 코드 탐색, 버전 선별, 로컬 전송 |
| code-archaeologist | 원본 코드 분석, 목적·의존성·I/O 패턴 파악 |
| taxonomy-architect | 기능별 클러스터링, 중복 식별, 분류 체계 설계 |
| code-refactorer | 중복 병합, 모듈화, 인터페이스 표준화 |
| skill-builder | 모듈 → skill.md 변환, description 작성 |
| integration-tester | 스킬 트리거 검증, 실행 테스트, 충돌 확인 |
> "내 연구 코드를 스킬로 변환해줘"
> "원격 서버 /home/user/scripts/ 에 있는 코드 수집해서 스킬로 만들어줘"
pip install sunpy astropy aiapy drms pandas numpy scipy matplotlib scikit-learn- 루트 하네스:
.claude/CLAUDE.md - 연구 생산 하네스:
01-research-production/.claude/CLAUDE.md - 학회 발표 PPT 하네스:
02-conference-presentation-generator/.claude/CLAUDE.md - 논문 작성 하네스:
03-paper-writer/.claude/CLAUDE.md - 논문 번역 하네스:
04-paper-mate/.claude/CLAUDE.md - Symbolic Regression 하네스:
05-symbolic-regression/.claude/CLAUDE.md - 논문 교정 하네스:
06-paper-editor/.claude/CLAUDE.md - IDL→Python 변환 하네스:
07-idl2python/.claude/CLAUDE.md - DEM 계산 하네스:
08-DEM-calc/.claude/CLAUDE.md - LaTeX 편집 하네스:
09-tex-editor/.claude/CLAUDE.md - 스킬 변환 하네스:
99-SSWL-skill-collector/.claude/CLAUDE.md - 프로젝트 시나리오:
docs/scenarios.md