ahnyongjooandClaude Sonnet 5.5
964a841de1
- Code\rebar_pipeline, review_pipeline, pier-program을 정션에서 실제 폴더로 전환 - Code\rhino_mcp 및 CLAUDE_rhino배경.md 추가, .mcp.json은 PYTHONPATH로 새 위치 사용 - pier-program 내부 .git 제거(이력은 backup\pier-program_20261028.bundle에 보관) - worktree 가이드 반영(CLAUDE.local.md, HANDOFF.md) - D:\Rhino-MCP 경로 참조를 새 위치로 치환 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
44 lines
3.7 KiB
Markdown
44 lines
3.7 KiB
Markdown
# HMCMkit (Human-Machine Collaboration Model Kit)
|
|
|
|
> **Antigravity 등 범용 멀티 에이전트 시스템을 위한 표준화된 협업 프레임워크**
|
|
|
|
## 1. 소개 (Introduction)
|
|
HMCMkit은 AI 어시스턴트(Antigravity 등) 세션을 단순한 코드 질문/답변기에서 **구조화되고 맥락을 완벽히 인지하는(Context-Aware) 지능형 개발 환경**으로 변환해주는 초경량 "에이전트 이식형(Portable) 코어 엔진"입니다.
|
|
|
|
**"No Plan, No Code"** 원칙 하에 **PDCA (Plan-Design-Do-Check-Act)** 방법론을 강제하며, 9단계의 전문 개발 파이프라인 모델을 통해 마치 숙련된 시니어 개발팀과 함께 일하는 것 같은 경험을 제공합니다.
|
|
|
|
---
|
|
|
|
## 2. 새 프로젝트 시작하기 (How to Use in a New Project)
|
|
|
|
HMCMkit은 복잡한 설치 단계나 패키지 없이, **단 2개의 필수 요소만 복사**하면 어떤 프로젝트 폴더에서든 즉시 작동하는 Zero-Touch 초기화를 지원합니다!
|
|
|
|
### 📦 복사해서 가져가야 할 필수 파일 & 폴더
|
|
새로운 프로젝트(빈 폴더 또는 기존 코드베이스)에서 HMCMkit 환경을 구성하려면 아래 항목들을 새 프로젝트의 최상위 계층(Root Directory)에 그대로 복사하세요.
|
|
|
|
1. **`agents.md` 파일** (필수)
|
|
- Antigravity 에이전트가 폴더를 열자마자 가장 먼저 읽어들이는 전역 시스템 룰북(규범) 및 부트스트랩 트리거 파일입니다.
|
|
2. **`.hmcmkit/` 폴더 전체** (필수)
|
|
- 프레임워크가 작동하는 데 필요한 코어 엔진 스크립트와 지식 파일들이 모두 담겨있는 숨김 디렉토리입니다.
|
|
- 내부의 `knowledge` (37종 스킬, 32종 에이전트 역할, 16종 템플릿 문서) 영역과 `tools` 영역 스크립트를 변경 없이 모두 포함해야 합니다.
|
|
|
|
*(※ 주의: `.hmcmkit` 내부의 `blueprint.md`와 `state.json`은 에이전트가 첫 부팅 시 새 프로젝트 속성을 감지하면 자동으로 초기화(Reset)해 줍니다.)*
|
|
|
|
---
|
|
|
|
### 🚀 사용 절차 (Workflow)
|
|
1. **복사 완료**: 새 프로젝트 폴더에 `agents.md` 파일과 `.hmcmkit/` 디렉토리를 복사해 둡니다.
|
|
2. **환경 시작**: 해당 프로젝트 폴더를 타겟으로 하여 Antigravity(또는 IDE 에이전트 플러그인)를 실행합니다.
|
|
3. **자동 부트스트랩 (Zero-Touch)**: 에이전트는 시작과 동시에 `agents.md` 지침에 따라 아래의 초기화/부트 시퀀스를 사용자의 개입 없이 병렬로 자율 실행합니다.
|
|
- `python .hmcmkit/tools/bootup.py`를 호출하여 장기 미사용 기능(Stale) 감지 등 컨텍스트를 주입합니다.
|
|
- `.hmcmkit/knowledge/skills`의 프로젝트 전용 지식을 네이티브 시스템으로 동기화합니다.
|
|
4. **대화 시작**: 시스템 부팅 세팅이 끝나면, 에이전트가 개발 현황을 파악하고 "다음 개발할 기능 파악 및 PDCA 설계 단계" 진입을 유도합니다.
|
|
|
|
---
|
|
|
|
## 3. 핵심 아키텍처 (Architecture)
|
|
|
|
* **Dual Skill Layer (이중 지식층)**: 로컬 `.hmcmkit/knowledge/skills` 영역을 최우선 참조하여 HMCMkit 전용의 방법론을 따르고, 필요시 Antigravity 글로벌 스킬 풀을 자동으로 병합 활용합니다.
|
|
* **코어 가드레일 (Guardrails)**: 내장된 파이썬 기반 상태 전이 엔진(`state_engine.py`)을 통해 "무한 루프(Loop)"를 차단하고 오류 발생 시 에이전트가 혼자 폭주하지 않도록 중재합니다.
|
|
* **컨텍스트 엔지니어링**: 작업 이력 기반의 상태 관리 파일(`state.json`)과 진실 공급원(`blueprint.md`)을 사용하여 여러 개의 태스크나 세션이 변경되어도 컨텍스트가 증발하지 않고 영구 유지됩니다.
|