0 Fork 0

Files

T

ahnyongjooandClaude Sonnet 5.5 964a841de1 chore(rebar): Pier_T_rebar 작업 폴더 초기 구성 및 외부 의존 파일 통합

- 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>

2026-10-28 11:20:18 +09:00

3.7 KiB

Raw Blame History

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)에 그대로 복사하세요.

agents.md 파일 (필수)
- Antigravity 에이전트가 폴더를 열자마자 가장 먼저 읽어들이는 전역 시스템 룰북(규범) 및 부트스트랩 트리거 파일입니다.
.hmcmkit/ 폴더 전체 (필수)
- 프레임워크가 작동하는 데 필요한 코어 엔진 스크립트와 지식 파일들이 모두 담겨있는 숨김 디렉토리입니다.
- 내부의 knowledge (37종 스킬, 32종 에이전트 역할, 16종 템플릿 문서) 영역과 tools 영역 스크립트를 변경 없이 모두 포함해야 합니다.

(※ 주의: .hmcmkit 내부의 blueprint.md와 state.json은 에이전트가 첫 부팅 시 새 프로젝트 속성을 감지하면 자동으로 초기화(Reset)해 줍니다.)

🚀 사용 절차 (Workflow)

복사 완료: 새 프로젝트 폴더에 agents.md 파일과 .hmcmkit/ 디렉토리를 복사해 둡니다.
환경 시작: 해당 프로젝트 폴더를 타겟으로 하여 Antigravity(또는 IDE 에이전트 플러그인)를 실행합니다.
자동 부트스트랩 (Zero-Touch): 에이전트는 시작과 동시에 agents.md 지침에 따라 아래의 초기화/부트 시퀀스를 사용자의 개입 없이 병렬로 자율 실행합니다.
- python .hmcmkit/tools/bootup.py를 호출하여 장기 미사용 기능(Stale) 감지 등 컨텍스트를 주입합니다.
- .hmcmkit/knowledge/skills의 프로젝트 전용 지식을 네이티브 시스템으로 동기화합니다.
대화 시작: 시스템 부팅 세팅이 끝나면, 에이전트가 개발 현황을 파악하고 "다음 개발할 기능 파악 및 PDCA 설계 단계" 진입을 유도합니다.

3. 핵심 아키텍처 (Architecture)

Dual Skill Layer (이중 지식층): 로컬 .hmcmkit/knowledge/skills 영역을 최우선 참조하여 HMCMkit 전용의 방법론을 따르고, 필요시 Antigravity 글로벌 스킬 풀을 자동으로 병합 활용합니다.
코어 가드레일 (Guardrails): 내장된 파이썬 기반 상태 전이 엔진(state_engine.py)을 통해 "무한 루프(Loop)"를 차단하고 오류 발생 시 에이전트가 혼자 폭주하지 않도록 중재합니다.
컨텍스트 엔지니어링: 작업 이력 기반의 상태 관리 파일(state.json)과 진실 공급원(blueprint.md)을 사용하여 여러 개의 태스크나 세션이 변경되어도 컨텍스트가 증발하지 않고 영구 유지됩니다.

3.7 KiB Raw Blame History