fireauto

---

이게 뭔가요?

fireauto는 Claude Code를 위한 AI 개발 하네스예요.

하네스가 뭐냐면, 말에게 씌우는 마구(고삐)처럼 AI에게 방향을 잡아주는 시스템이에요. 설치만 하면 AI가 알아서:

• 프로젝트를 체계적으로 관리해요 (PRD -> 마일스톤 -> 태스크)
• 작업 기록을 자동으로 축적해요 (지식 DB)
• 실수에서 배워요 (자동 규칙 업데이트)
• 세션마다 복기해요 (실수는 크게, 성공은 조용히)
• 다음 세션에 "오늘 할 일"을 알려줘요
• 반복 패턴을 감지해서 스킬로 자동 생성해요

Andrej Karpathy의 LLM Knowledge Base 패턴과 Claude Code 팀의 하네스 관리 원칙에 따라 설계됐어요.

---

어떻게 동작하나요?

설치 후 자동으로 일어나는 일

시점	자동 동작	기술
세션 시작	프로젝트 상태 + 주의사항 알려줌	SessionStart Hook
코드 수정	작업 기록 자동 축적 + AI 요약	PostToolUse Hook + Haiku
실수 시	Haiku가 자동으로 실수 감지 + CLAUDE.md 규칙 추가	PostToolUse Hook + Agent SDK
코드 수정 후	자동 린트 (성공은 조용히, 에러만 시끄럽게)	PostToolUse Hook
패턴 반복	3회 이상 반복되면 스킬 자동 생성	PostToolUse Hook
CLAUDE.md 비대	80줄 초과 시 자동으로 Wiki로 이동	PostToolUse Hook
세션 종료	자동 복기 (실수 크게, 성공 조용히) + 세션 요약 저장	Stop Hook

사용자가 할 일: 없음. 그냥 코딩하면 돼요.

---

시작하기

1단계: fireauto 설치

# Claude Code 안에서 실행
/plugin marketplace add imgompanda/fireauto
/plugin install fireauto@fireauto
/reload-plugins

설치 끝. /reload-plugins까지 해야 MCP 도구와 훅이 활성화돼요.

GitHub에서 안 되면: git clone https://github.com/imgompanda/fireauto.git -> /plugin marketplace add ./fireauto -> /plugin install fireauto@fireauto

2단계: 원클릭 세팅

/freainer

이것만 실행하면 전부 알아서 해줘요:

항목	설명
Context7 MCP	라이브러리 최신 문서를 AI가 실시간 참조
Playwright MCP	브라우저 자동화 + E2E 테스트
Draw.io MCP	아키텍처도, 플로우차트, ERD 자동 생성
LSP 설정	코드 탐색 속도와 정확도 극대화
알림 훅	작업 완료 시 macOS 알림
에이전트 팀	여러 AI가 동시 작업
스킬 자동 트리거	상황에 맞게 스킬 자동 활성화
메모리 시스템	개발 지식 자동 축적 + AI 분석
프로젝트 세팅 (선택)	PRD, CLAUDE.md, Wiki, 마일스톤 자동 생성

전부 무료, API 키 불필요.

3단계: 보일러플레이트 (선택)

새 프로젝트를 시작하려면 **FireShip Starter Kit**을 추천해요.

/fireship-install

인증, 결제(Paddle/Toss), AI, 이메일, 다국어가 다 들어있어요.

데모 보기 · 보일러플레이트 자세히 보기

---

대시보드

http://localhost:37888 에서 모든 걸 볼 수 있어요.

메모리 시스템이 설치되면 Worker 서버가 자동으로 시작되고, 대시보드가 바로 열려요.

탭	내용
프로젝트	마일스톤 진행률 + 칸반 보드 (다음 할 일 / 진행 중 / 완료)
타임라인	AI가 자동 요약한 지식 카드 (세션별 그룹핑)
Wiki	패턴, 주의사항, 결정 사항 페이지
스킬	자동 생성된 스킬 + 실수 기록
검색	축적된 지식 전문 검색 (FTS4 한국어 지원)
설정	Haiku/Sonnet/Opus 모델 선택

대시보드에서 프로젝트 진행률을 한눈에 확인하고, 마일스톤을 클릭하면 태스크가 펼쳐져요.

---

핵심 기능

프로젝트 관리 -- 코딩 전에 계획부터

/freainer   # 프로젝트 시작 시 PRD 자동 생성
/project    # 프로젝트 대시보드
/next       # 다음 태스크 시작 (AI가 관련 지식도 알려줌)

PRD를 작성하면 AI가 자동으로:

• 마일스톤으로 나누고
• 태스크로 분해하고 (1-4시간 단위로 쪼개요)
• 칸반 보드에 배치해요

태스크는 pending -> in_progress -> completed 순서로 진행돼요. /next를 실행하면 AI가 다음 할 일을 찾아서, 관련 지식까지 함께 알려줘요. "시작할게"라고 하면 바로 코딩을 시작해요.

대시보드: http://localhost:37888 (프로젝트 탭)

지식 축적 -- 코딩하면 자동으로 쌓여요

코드를 수정할 때마다 AI(Haiku)가 자동으로:

• "이건 버그 수정이고, 원인은 이거다" 분석
• "이건 반복할 패턴이다" 축적
• "이건 주의사항이다" 태깅
• 지식끼리 자동 관계 연결 (같은 파일, 같은 태그, 시간적 연속)

~/.fireauto-mem/wiki/에 프로젝트 지식이 자동으로 정리돼요:

파일	내용
patterns.md	코딩 패턴, 모범 사례
gotchas.md	삽질 기록, 주의사항
decisions.md	설계 결정 + 이유
skills-catalog.md	자동 생성된 스킬 목록
retrospective.md	세션별 복기
index.md	자동 생성 목록

사용자가 할 일: 없음. 코딩만 하면 지식이 알아서 쌓여요.

대시보드: http://localhost:37888 (타임라인 탭)

자기 학습 -- AI가 실수에서 배워요

AI가 실수하면:

1. Haiku가 자동으로 실수를 감지해서 DB에 기록 (PostToolUse Hook + Agent SDK)
2. gotchas.md에 주의사항 추가
3. CLAUDE.md에 방지 규칙 추가
4. 다음에 같은 실수 안 함

같은 작업이 3회 이상 반복되면:

1. 반복 패턴을 자동 감지 (PostToolUse Hook이 3회마다 체크)
2. 스킬로 자동 생성
3. skills-catalog.md에 등록

CLAUDE.md는 80줄 이내로 자동 관리돼요. (Anthropic 권장: 200줄 이하, 최적: 60-80줄) 초과하면 자동으로 Wiki로 이동해요. "이 줄을 제거하면 Claude가 실수할까?" -- 아니면 삭제.

복기 -- 세션 끝나면 자동으로 정리

세션이 끝나면 Stop Hook이 자동으로 복기를 실행해요:

===============================
세션 복기

  실수 (2건):
1. Paddle API 타임아웃 미처리 -> 수정 완료
2. DB 쿼리 파라미터 불일치 -> 수정 완료

  배운 점:
  - Paddle 웹훅은 멱등성 키 필수
  - DB 타임스탬프는 UTC로 통일

  완료: 결제 연동, 웹훅 처리
  다음: 테스트 작성
===============================

실수는 크게, 성공은 조용히. 복기 결과는 retrospective.md에 자동 저장되고, 실수는 gotchas.md에, 배운 점은 patterns.md에 각각 기록돼요.

세션 시작 -- 어제 어디까지 했는지 자동으로 알려줘요

세션을 시작하면 SessionStart Hook이 자동으로:

• 프로젝트 상태와 진행률을 표시해요
• 최근 실수/주의사항을 알려줘요
• "오늘 할 일"을 제안해요

[fireauto] 프로젝트: SaaS 대시보드 (45% 완료)
[fireauto] 현재 마일스톤: Phase 2 - 결제 연동
[fireauto] 주의사항:
  - Paddle API 타임아웃 3초로 설정할 것
  - DB 마이그레이션 전 백업 필수

사용자가 할 일: 없음. 세션을 시작하면 자동이에요.

교차 프로젝트 -- 이전 프로젝트 지식이 이어져요

새 프로젝트를 시작하면 AI가:

• 이전 프로젝트의 스킬을 검색해서 추천 (skill-search)
• 이전 프로젝트의 실수/주의사항을 자동으로 알려줌 (mistake-search)
• "이전 프로젝트에서 이런 스킬/주의사항이 있어요. 적용할까요?" 물어봐요

---

어떤 상황에서 뭘 쓰면 되나요?

Claude Code 처음 쓴다면 (먼저 이거!)

/freainer  # 추천 MCP + LSP + 알림 훅 + 메모리 + 스킬 자동 트리거를 한번에 설치해요

프로젝트를 체계적으로 관리하고 싶다면

/project new   # PRD를 마일스톤과 태스크로 자동 분해
/next          # 다음 해야 할 일을 AI가 제안 + 관련 지식 표시
/project       # 프로젝트 대시보드 확인

AI가 매 세션 시작 시 "어제 여기까지 했어요, 오늘 이거 하면 돼요" 라고 알려줘요. 대시보드: http://localhost:37888

서비스를 만드는 중이라면

/planner        # 아이디어를 기획서로 만들어요
/researcher     # 레딧에서 진짜 고객이 있는지 확인해요
/designer       # DaisyUI로 UI를 만들어요
/uiux-upgrade   # 내 서비스 UI/UX를 자동으로 점검하고 고쳐줘요

서비스를 거의 다 만들었다면

/seo-manager     # SEO가 제대로 되어있는지 점검해요
/security-guard  # 보안 구멍이 없는지 확인해요

규모가 큰 작업이라면

/team   # 여러 AI가 동시에 작업하고 서로 대화해요

영상 콘텐츠가 필요하다면

/video-maker  # React 코드로 영상을 만들어요

프롬프트를 잘 못 쓰겠다면

/loop  # 프롬프트 하나만 던지면 AI가 알아서 반복하며 완성해요

---

전체 커맨드

커맨드	한 줄 설명
/freainer	원클릭 세팅 (MCP + LSP + 메모리 + 스킬 트리거 + 프로젝트)
/project	프로젝트 대시보드 / PRD -> 마일스톤 -> 태스크 자동 분해
/next	다음 태스크 시작 + 관련 지식
/planner	아이디어 한 줄 -> 상세 PRD 문서
/researcher	레딧 수요조사 + 리드 스코어링
/team	AI 팀 병렬 작업 + 에이전트 간 대화
/team-status	팀 진행 상황 확인
/seo-manager	SEO 7개 영역 점검
/security-guard	보안 8개 카테고리 점검
/designer	DaisyUI UI 구축 / 마이그레이션 / 테마
/uiux-upgrade	UI/UX 감사 + 자동 수정
/video-maker	React 코드로 영상 제작 (Remotion)
/lsp-install	LSP 설정 (/freainer에 포함)
/memory-install	메모리 시스템 설치 (/freainer에 포함)
/loop	AI 반복 실행
/cancel-loop	루프 중단
/fireship-install	FireShip 보일러플레이트

---

MCP 도구 (AI가 자동으로 사용)

설치 후에는 AI가 상황에 맞게 알아서 사용해요. 직접 호출할 필요 없어요.

메모리

도구	설명
memory-search	축적된 지식에서 관련 항목 검색
memory-save	가치 있는 지식을 능동적으로 저장
memory-timeline	시간순 지식 축적 이력
memory-detail	지식 상세 조회
memory-related	관련 지식 그래프 탐색
memory-compile	프로젝트 지식을 문서로 종합

프로젝트

도구	설명
project-status	프로젝트 진행률 조회
project-task-update	태스크 상태 변경
project-next	다음 태스크 제안

Wiki

도구	설명
wiki-read	Wiki 페이지 읽기
wiki-write	Wiki 페이지 작성/업데이트
wiki-search	Wiki 검색
wiki-index	Wiki 목록 조회

자기 학습

도구	설명
skill-save	스킬 저장
skill-search	스킬 검색
mistake-log	실수 기록
mistake-search	실수 검색
retrospect	세션 복기

---

커맨드 vs 스킬(가이드)

fireauto에는 커맨드와 스킬(가이드) 두 종류가 있어요.

• 커맨드 = 내가 시키는 것 (/seo-manager -> SEO 점검해!)
• 스킬(가이드) = AI가 알아서 참고하는 것 (SEO 점검할 때 이렇게 하면 잘 돼요~)

구분	커맨드	스킬(가이드)
이름 예시	/team, /seo-manager	fireauto-team-guide, fireauto-seo-guide
실행 방법	/ 입력해서 직접 실행	AI가 상황에 맞게 자동 실행
역할	특정 작업을 수행	AI가 더 잘 작업하도록 배경 지식 제공

스킬은 이름에 -guide가 붙어있어요. / 메뉴에 보이지만 직접 실행할 필요 없어요.

v2.1에서 추가된 자동 트리거 스킬

스킬	자동 트리거 상황
fireauto-harness-guide	세션 시작 시 프로젝트 상태 자동 파악
fireauto-init-guide	새 프로젝트 시작 시 PRD/Wiki/마일스톤 자동 생성
fireauto-project-guide	마일스톤/태스크 관리
fireauto-wiki-guide	패턴, 주의사항, 결정사항 Wiki 자동 기록
fireauto-retro-guide	세션 종료 시 자동 복기
fireauto-self-learn-guide	실수 감지 + 스킬 자동 생성
fireauto-mem-search-guide	과거 지식 자동 검색
fireauto-mem-save-guide	가치 있는 지식 자동 저장
fireauto-mem-compile-guide	프로젝트 지식 종합
fireauto-self-heal-guide	에러 발생 시 최대 3회 자동 수정 시도
fireauto-knowledge-hierarchy-guide	CLAUDE.md → Wiki → Skills 탐색 순서

---

각 기능 상세

/freainer -- 원클릭 세팅

Claude Code 처음 쓰는 사람도 커맨드 하나로 프로급 환경을 만들 수 있어요.

/freainer

8단계를 자동으로 진행해요:

단계	내용
Step 1	추천 MCP 3개 자동 설치 (Context7, Playwright, Draw.io)
Step 2	LSP 설치 (카테고리 선택: 웹/백엔드/iOS/안드로이드/시스템/게임)
Step 3	알림 훅 설정 (작업 완료 시 macOS 알림)
Step 4	에이전트 팀 활성화
Step 5	스킬 자동 트리거 설정 (CLAUDE.md에 규칙 추가)
Step 6	메모리 시스템 설치 (개발 지식 DB)
Step 7	프로젝트 세팅 (선택 -- PRD, CLAUDE.md, Wiki, 마일스톤 자동 생성)
Step 8	최종 확인 + 재시작 안내

전부 무료예요. API 키도 필요 없어요.

/project -- 프로젝트 대시보드

프로젝트의 전체 상태를 한눈에 보여주고, 새 프로젝트를 쉽게 만들 수 있어요.

/project        # 대시보드 표시
/project new    # 새 프로젝트 생성

새 프로젝트를 만들면 AI가 PRD를 분석해서:

• "구현 로드맵" 또는 "Phase" 섹션을 마일스톤으로 변환해요
• 각 마일스톤 안의 작업 항목을 1-4시간 단위 태스크로 쪼개요
• 의존 관계가 있으면 순서를 자동 지정해요

PRD가 없으면 /planner로 먼저 만들 수 있어요.

대시보드: http://localhost:37888 (프로젝트 탭)

/next -- 다음 태스크 시작

다음에 해야 할 태스크를 자동으로 찾아서, 관련 지식과 함께 보여줘요.

/next

동작 순서:

1. project-next MCP 도구로 다음 태스크 조회
2. memory-search MCP 도구로 관련 지식 자동 검색
3. 태스크 + 관련 지식을 함께 보여줌
4. "시작할게"라고 하면 태스크 상태를 in_progress로 변경하고 바로 코딩 시작
5. 작업 완료 시 completed로 변경 + 발견한 지식 자동 저장

/planner -- 기획자

"이런 서비스 만들고 싶은데..." 한 줄만 적으면 상세한 기획서가 나와요.

/planner

9개 섹션을 자동으로 만들어요: 프로젝트 개요, 핵심 기능(P0/P1/P2), 실현 가능성 조사, 외부 API 가격 비교, 경쟁사 분석, 기술 스택 추천, 수익 모델, 구현 로드맵, 성공 지표

docs/prd/ 폴더에 마크다운으로 저장돼요.

/researcher -- 리서처

레딧에서 관련 게시글을 찾아서, 누가 진짜 고객인지 1~10점으로 점수를 매겨줘요.

/researcher

결과물:

• 리드 점수표 (CSV) -- hot/warm/cold/not_a_lead 4단계 분류
• 고충 분류 -- 비용, 시간, 복잡성, 규제, 스케일 카테고리별 정리
• 요약 리포트 -- 마크다운 문서

/team -- 팀 리더 (컴퍼니 모델)

여러 AI가 동시에 작업하고, 서로 대화하며 협업해요.

/team

• AI끼리 SendMessage로 실시간 논의
• 각자 독립된 공간(git worktree)에서 작업 -> 코드 충돌 없음
• 작업 완료 후 수동으로 순차 병합 (자동 병합이 아니에요 -- 충돌 방지를 위해)

팀 상태 확인: /team-status

/seo-manager -- SEO 관리자

코드 기반으로 SEO 7개 영역을 점검해요. 빌드하지 않아도 돼요.

/seo-manager

점검 항목: robots.txt, sitemap, JSON-LD 구조화 데이터, 메타 태그, pSEO 라우트, 리다이렉트 체인, 성능 SEO

결과는 P0(긴급) ~ P3(개선 권장)으로 정리돼요.

/security-guard -- 보안 담당

코드에 보안 구멍이 없는지 8개 카테고리로 점검해요.

/security-guard

점검 항목: 시크릿 노출, 인증/인가 누락, Rate Limiting, 파일 업로드, 스토리지 보안, Prompt Injection, 정보 노출, 의존성 취약점