프로젝트 소개

Pro Workflow는 기존 AI 코딩 에이전트 위에 영구 메모리, 지식 관리, 워크플로 오케스트레이션을 계층화하는 오픈소스(MIT) 플러그인입니다. Claude Code를 기본 지원하며, `skills add` 설치 프로그램을 통해 Cursor, Codex CLI, Gemini CLI, Windsurf, OpenCode, Kiro, Goose, Roo 및 기타 27개 에이전트로 확장됩니다. 핵심 기능: - 자가 교정 메모리: 모든 사용자 교정 사항이 FTS5 전문 인덱스를 갖춘 SQLite 데이터베이스에 규칙으로 캡처됩니다. 규칙은 세션 시작 시 자동 로드되므로 실수가 세션 간에 반복되지 않습니다. `/learn-rule` 명령으로 교정 사항을 캡처하고, `/wrap-up`으로 세션 종료 시 학습 내용을 저장합니다. - 지식 플레인(v3.3): 디스크에 마크다운으로 저장되고 섀도 FTS5 인덱스를 갖춘 영구 연구 위키입니다. 위키는 9가지 유형(연구, 논문, 도메인, 제품, 인물, 조직, 프로젝트, 코드베이스, 사고)을 지원합니다. 예산 제한 BFS 자동 연구 루프는 웹, arXiv, GitHub 소스에서 위키를 밤새 확장할 수 있습니다. 하이브리드 검색은 BM25와 선택적 벡터 임베딩(OpenAI 또는 Voyage)을 Reciprocal Rank Fusion을 통해 결합합니다. 다중 제공자 LLM 협의회(Anthropic, OpenAI, OpenRouter, Fireworks)는 고위험 결정에 대해 3단계 심의를 실행하고, 기록을 위키 페이지로 저장합니다. - 품질 게이트: LLM 기반 사전 커밋 및 비밀 검사 훅, 결정적 git 영향 범위 가드, 압축 인식 상태 보존, 예산 알림이 포함된 비용 추적, MCP 오버헤드 감사. 구조: 41개 스킬, 8개 에이전트(플래너, 리뷰어, 스카우트, 오케스트레이터, 디버거, 컨텍스트 엔지니어, 권한 분석가, 비용 분석가), 23개 슬래시 명령, 22개 수명 주기 이벤트(SessionStart, UserPromptSubmit, PreToolUse, PreCompact, FileChanged 등)에 걸친 33개 훅 스크립트. 주요 워크플로 패턴으로는 다단계 개발(검증 게이트가 있는 Research → Plan → Implement → Review), 대규모 변경을 위한 병렬 git worktree 오케스트레이션, 컨텍스트 엔지니어링(Write/Select/Compress/Isolate 프레임워크), 공유 작업 목록이 있는 에이전트 팀, 배치 오케스트레이션이 있습니다. 저장소는 ~/.pro-workflow/ 아래에 위치합니다: 학습 내용, 세션, 위키 레지스트리, 임베딩을 보관하는 단일 SQLite data.db, 전역 위키 디렉터리, 협의회 기록, 모든 자동 루프를 중지하기 위한 STOP 킬 스위치 파일. 프로젝트 범위 위키는 저장소의 .claude/wikis/ 디렉터리에 커밋할 수 있습니다. 설치: 네이티브 Claude Code 플러그인 마켓플레이스(`/plugin install pro-workflow@pro-workflow`) 또는 `npx skills add rohitg00/pro-workflow`를 통한 크로스 에이전트 설치. 임의 에이전트 설정을 위한 수동 클론 및 복사 경로도 문서화되어 있습니다. 설치 후 `/doctor`가 SQLite 저장소, 훅, 스킬이 올바르게 로드되는지 확인합니다. 구성은 권한, 샌드박스 규칙, 자동 압축, 출력 스타일에 대한 settings.json, 선택적 MCP 서버(context7, Playwright, GitHub), 임베딩 제공자, 협의회 LLM 백엔드, 연구 루프 예산에 대한 환경 변수를 허용합니다.