PulseFramework: AI 지원 소프트웨어 개발을 위한 통합 도구 키트

PULSE는 방법론, CLI 명령어, Cursor IDE용 MCP 서버, 자동 안전장치 및 루프 감지 기능을 포함하는 통제된 AI 지원 소프트웨어 개발을 위한 완벽한 툴킷입니다.

# Quick Start
npm install && npm run build
npm link -w packages/pulse-cli -w packages/pulse-mcp
...

대상 사용자: 구조화되고 안전한 AI 지원 개발을 원하는 시니어 개발자 및 테크 리드.

Status → Run → Build → Doctor → Checkpoint → 반복

시각적 체크포인트 알림 – 마지막 커밋 이후 경과 시간을 정확히 확인합니다.
색상 코드 경고 – 시간이 지남에 따라 녹색(Green) → 노란색(Yellow) → 빨간색(Red)으로 변경됩니다.
원클릭 접근 – 클릭 한 번으로 체크포인트 메뉴를 즉시 열 수 있습니다.

자동 감지 (Auto-detection) – Pulse는 초기화되지 않은 프로젝트를 자동으로 인식합니다.
풀스택 프리셋 (Fullstack preset) – 대부분의 프로젝트에 적합한 합리적인 기본값을 제공합니다.
제로 설정 (Zero config) – MCP 서버, Git 훅(Git hooks), Cursor 규칙이 한 번의 클릭으로 설치됩니다.

컨텍스트 인식 (Context-aware) – AI가 채팅 기록을 기반으로 커밋 메시지를 생성합니다.
복사/붙여넣기 불필요 (No copy-paste) – 코딩과 커밋 사이에 마찰이 없습니다.
Git 모범 사례 (Git best practices) – 매번 의미 있고 구조화된 커밋 메시지를 만듭니다.

방해받지 않는 알림 (Non-intrusive reminders) – 커밋되지 않은 변경 사항이 있을 때만 알립니다.
1시간 일시 중지 (Snooze 1 hour) – 스팸 없이 휴식을 취할 수 있습니다.
스톱 워처 (Stop Watcher) – 깊은 집중이 필요할 때 완전히 비활성화합니다.

Pulse가 여러분의 작업 흐름에 도움이 되었다면, 저장소(Repository)를 ⭐ 스타(Star)해주세요.

AI 에이전트는 대화 중에 자동으로 PULSE 도구를 호출합니다. 그 모습은 다음과 같습니다:

자동 (Automatic) – 에이전트가 응답하기 전에 pulse_status를 호출합니다.
체크포인트 추적 (Checkpoint tracking) – 마지막 커밋 이후 시간을 보여줍니다.
범위 인식 (Scope awareness) – 변경된 파일과 라인을 추적합니다.

30분 규칙 (30-minute rule) – 체크포인트가 지연되면 에이전트를 중지시킵니다.
작업 보호 (Protects your work) – 계속하기 전에 강제로 저장하게 합니다.
명확한 동작 (Clear action) – 에이전트가 자동으로 체크포인트를 생성합니다.

사전 커밋 스캔 (Pre-commit scan) – API 키가 유출되기 전에 포착합니다.
커밋 차단 (Blocks commit) – 비밀 정보를 푸시할 수 없게 합니다.
해결책 제시 (Shows solution) – 정확히 어떻게 수정해야 하는지 알려줍니다.

Fix-chain 감지 – 해결에 막혔을 때를 포착
파일 변경 추적(File churn tracking) – 같은 파일을 5회 이상 수정
상황 보고서 제안(Suggests escalation) – 새로운 관점 얻기

자동 트리거(Automatic trigger) – 2~3번의 해결 시도 실패 후
맥락 내보내기(Context export) – GPT-5/Claude를 위한 전체 문제 설명
루프 탈출(Breaks the loop) – 추측 대신 전문가 도움 받기

솔루션 저장(Save solutions) – 까다로운 버그 수정 후
규칙 자동 업데이트(Auto-updates rules) – 다음 세션에서 기억하기
프로젝트 지식 기반(Project knowledge base) – 시간이 지날수록 스마트해지기

브랜치 생성(Branch creation) – 기능 브랜치를 자동으로 생성
작업 지시서(Work order) – 구조화된 프롬프트를 생성
프로필 활성화(Profile activation) – 적절한 안전장치 적용

품질 체크리스트(Quality checklist) – 자동 병합 전 검토
범위 유효성 검사(Scope validation) – 파일, 라인, 테스트 확인
명확한 권고(Clear recommendation) – 승인 / 검토 / 차단

방향 변경(Direction change) – 요구사항이 바뀔 때
안전 점검(Safety checkpoint) – 수정 전에 저장
앞으로 나아갈 명확한 경로(Clear path forward) – 새로운 구현 계획

PULSE는 이론이 아닙니다. 2025년 14.22 Billion Tokens와 21.9K Agentic Sessions에서 추출된 경험의 정수입니다.

**글로벌 상위 3%**에 속하는 AI 지원 개발 속도 – 복잡한 리팩토링, 그린필드 빌드, 에스컬레이션 루프 전반에 걸쳐 테스트됨

• Claude, GPT-4, Cursor를 사용한 실제 프로덕션 경험을 바탕으로 구축

# 1. 클론 및 빌드
git clone https://github.com/manuelfussTC/PulseFramework.git
cd PulseFramework
...

Cursor 재시작(Cmd+Shift+P → "Developer: Reload Window") - MCP 상태 확인:
설정(Settings) → 기능(Features) → MCP에서 pulse가 녹색이어야 합니다. - 테스트: Cursor에게 무언가를 질문해 보세요. 그러면 자동으로 pulse_status를 호출할 것입니다.

Git 저장소: Pulse는 프로젝트가 Git 저장소여야 합니다. 워크스페이스당 하나의 저장소: 여러 저장소를 포함하는 상위 폴더가 아닌, .git을 포함하는 특정 프로젝트 폴더를 여세요.

your-project/
├── .pulse/
│ ├── state.json
...

pulse status # 빠른 프로젝트 개요 확인
pulse run # 워크플로우 시작 (브랜치 생성 + 프롬프트 제공)
pulse checkpoint -m "메시지" # 안전장치 검사를 포함한 Git 커밋
...

--mcp를 사용하여 Cursor를 사용할 때, 에이전트는 자동으로 다음을 호출합니다:

• ⏱️ 30분 규칙: 자율 작업 후 30분이 지나면 중단하고 체크포인트를 만드세요. - 🗑️ 삭제 방지 장치(Delete Guard): 확인 없이는 파일 삭제 불가 - 📤 푸시 방지 장치(Push Guard): 확인 없이는 git push 불가 - 🔐 비밀 정보 방지 장치(Secrets Guard): 코드에 API 키나 비밀번호를 포함할 수 없음 - 📋 체크포인트(Checkpoint): 5~10분마다 Git 커밋

PulseFramework/
├── packages/
│ ├── pulse-cli/ # CLI 도구 키트 (13개 명령어)
...

pulse init을 실행할 때, 프로젝트에 맞는 프리셋을 선택하세요:

# 1. 새로운 기능 시작하기
pulse run
# → 브랜치 생성, 프롬프트 생성, 워처 시작
...

PULSE가 여러분의 작업 흐름에 도움이 되었다면, ⭐ 저장소에 별표를 눌러주세요.

작성자: Manuel Fuß

웹사이트: manuel-fuss.de/pulse

이메일: [email protected]

MIT 라이선스 – 자세한 내용은 LICENSE 참조.

기여 환영! 이슈, PR, 피드백을 부탁드립니다.