npm 출시 준비 완료 · 6 패키지 · MIT

프롬프트를 잘 쓰는 법, 내 PC 안에서 배우다.

Think-Prompt는 Claude Code에 친 프롬프트를 자동으로 기록하고, 18개 안티패턴 룰로 0-100점을 매겨 어디가 부족한지 조용히 알려주는 로컬-전용 오픈소스 도구입니다.

30초 설치 가이드 GitHub에서 보기

Node 20+ · macOS · Linux

~/projects/my-app — zsh 

        

        
↑ 실제로 돌렸을 때 나오는 출력 그대로

      

    

  


  
  

    

      

        
왜 Think-Prompt 인가

        
운동 앱 같은 프롬프트 코치, 단 서버는 없습니다.

        

          로깅도, 채점도, 리뷰도 전부 내 컴퓨터 안에서. 필요할 때만 마스킹된 사본이 외부에 나갑니다.
        

      


      

        
        

          

            

              
            

            
로컬-전용 저장

          

          

            훅으로 수집된 모든 프롬프트는 ~/.think-prompt/prompts.db SQLite에만 저장됩니다. 서버 동기화 모드는 기본 OFF.
          

          
    
            
  • · SQLite WAL + JSONL 큐
    • 
            
  • · 이메일 / RRN / API 키 자동 마스킹
    • 
            
  • · wipe --yes 한 줄로 완전 삭제
    • 
          

        


        
        

          

            

              
            

            
18개 룰 자동 진단

          

          

            R001~R018 안티패턴 룰로 모든 프롬프트에 0-100점 자동 부여. 룰 70% + 실사용 30% 복합 공식.
          

          

            
0

            
예시 세션 평균

          

        


        
        

          

            

              
            

            
Fail-open 안전 설계

          

          

            훅이 다운되거나 느려져도 Claude Code 자체는 절대 멈추지 않습니다. 150ms 타임아웃 안에서만 동기 작업, 나머지는 비동기 워커.
          

          
    
            
  • · 2-Tier 캡처 아키텍처
    • 
            
  • · Fastify 127.0.0.1:47823 리시버
    • 
            
  • · 워커 + 큐 분리 (D-028)
    • 
          

        


        
        

          

            

              
            

            
로컬 웹 대시보드

          

          

            :47824에 올라가는 서버-렌더 대시보드로 티어 분포·TOP 5 낮은 점수·세션 타임라인을 한눈에. 5개 언어 i18n 내장.
          

          
    
            
  • · eta + Alpine + Tailwind (no bundler)
    • 
            
  • · 기간 선택기 / 실시간 폴링
    • 
            
  • · KO · EN · JA · ZH · ES
    • 
          

        


        
        

          

            

              
            

            
LLM 리라이트 (옵트인)

          

          

            Anthropic API 키가 있으면 낮은 점수 프롬프트를 Haiku가 더 나은 버전으로 다시 써줍니다. 이때만 마스킹된 사본이 외부로.
          

          
    
            
  • · think-prompt rewrite <id>
    • 
            
  • · 동의 기반 심화 분석 (D-032)
    • 
            
  • · 인라인 코칭 모드 (기본 OFF)
    • 
          

        


        
        

          

            

              
            

            
브라우저 확장 (Phase 2)

          

          

            ChatGPT · Claude · Gemini · Perplexity · Genspark에도 같은 코칭을. v0.3.1 하드닝 완료, 스토어 제출 준비.
          

          
    
            
  • · Manifest V3 · SPA 내비 지원
    • 
            
  • · 메시지 스키마 검증
    • 
            
  • · 로컬-전용 원칙 동일
    • 
          

        

      

    

  


  
  

    

      

        
작동 방식

        
훅 3개, 150ms 안, 내 컴퓨터 안.

        

          Claude Code가 프롬프트를 보내는 순간부터 대시보드에서 보는 순간까지 — 전 구간이 로컬입니다.
        

      


      
    
        
  1. 
          
    
            STEP 01
          
    
          
    Tier 1 — 동기 캡처
    
          
    
            UserPromptSubmit, SessionStart, SubagentStart 훅이 127.0.0.1:47823 에이전트에 프롬프트를 전달. LLM·네트워크 호출 금지, SQLite append + 큐 push만.
          
    
        
    2. 
        
  2. 
          
    
            STEP 02
          
    
          
    Tier 2 — 비동기 워커
    
          
    
            Stop · PostToolUse가 큐에 작업을 던지면 워커가 transcript JSONL을 파싱해 모델 응답·서브에이전트 프롬프트까지 복원, 룰 스코어를 계산.
          
    
        
    3. 
        
  3. 
          
    
            STEP 03
          
    
          
    회고 · 코칭
    
          
    
            think-prompt open으로 로컬 대시보드. 낮은 점수 프롬프트는 룰 설명과 함께 표시, 옵션으로 LLM 리라이트 제안까지.
          
    
        
    4. 
      

    

  


  
  

    

      

        
18개 안티패턴 룰

        
"프롬프트 엔지니어링"을 숫자로.

        

          한 / 영 / 일 / 중(간체·번체) 키워드 사전을 갖춘 규칙들이 모든 프롬프트를 자동으로 검사합니다.
        

      


      

        
      


      

    

  


  
  

    

      

        
npm 패키지 6종

        
모놀리식 아닙니다. 각각 필요한 것만 써도 됩니다.

        

          provenance 서명된 6개 @think-prompt/* 패키지. 일반 사용자는 @think-prompt/cli 하나면 충분합니다.
        

      


      

    

  


  
  

    

      

        

        

          

            
            Privacy Pledge · D-004
          

          

            원문 프롬프트는 여러분 PC 밖으로 나가지 않습니다.
          

          

            
✓ 서버 전송 모드 없음 (v0.1 기준)

            
✓ PII 7종 (이메일·전화·RRN·카드·API 키·JWT·IP) 저장 전 마스킹

            
✓ LLM 기능은 전부 옵트인 · 마스킹본만 전송

            
✓ think-prompt wipe --yes 한 줄 = 모든 데이터 + 훅 제거

          

        

      

    

  


  
  

    

      

        
빠른 시작

        
두 줄이면 끝납니다.

        

          Node 20 이상 · macOS 또는 Linux. Windows 지원은 Phase 2에서.
        

      


      
      

        

          
          
        


        

          

            
            
$ npm install -g @think-prompt/cli
  # 또는: pnpm add -g @think-prompt/cli
  # 또는: npx @think-prompt/cli install

$ think-prompt install
  ✓ hook 블록을 ~/.claude/settings.json 에 병합
  ✓ agent · worker · dashboard 데몬 기동
  ✓ 대시보드: http://127.0.0.1:47824

$ think-prompt open
  # 브라우저에서 대시보드 열기

          

          

            note · 태그 v*.*.* 가 GitHub에 푸시되면 release 워크플로가 6 패키지를 npm에 자동 배포합니다
          

        


        
      


      

        📘 완전 입문 가이드
        결정 로그
        기여 가이드