fireauto

fireauto

설치 한 번이면 AI가 알아서 해요.
PRD 작성, 마일스톤 관리, 지식 축적, 실수 학습, 세션 복기까지.
당신은 코딩만 하세요. 나머지는 fireauto가 할게요.

소개 · 시작하기 · 대시보드 · 핵심 기능 · 전체 커맨드 · 상세 설명 · FAQ

도움이 됐다면 Star를 눌러주세요. 업데이트 소식을 받아볼 수 있어요.

---

이게 뭔가요?

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

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

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

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

---

어떻게 동작하나요?

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

시점	자동 동작	기술
세션 시작	프로젝트 상태 + 주의사항 알려줌	SessionStart Hook
코드 수정	작업 기록 자동 축적 + AI 요약	PostToolUse Hook + Haiku
실수 시	"아니 그거 아니야" -> 실수 자동 기록 + CLAUDE.md 규칙 추가	UserPromptSubmit 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

설치 끝. 이제 커맨드를 바로 쓸 수 있어요.

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 한국어 지원)

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

---

핵심 기능

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

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

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

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

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

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

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

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

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

.claude/wiki/에 프로젝트 지식이 자동으로 정리돼요:

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

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

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

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

사용자가 "아니 그거 아니야"라고 하면:

1. 실수를 자동으로 DB에 기록 (UserPromptSubmit Hook이 감지)
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로 통일