RinDig/icm-architect

해결하는 문제

멀티 에이전트 설정은 종종 단계, 컨텍스트 및 상태를 정의하기 위해 오케스트레이션 코드에 의존하여 이해하고 디버깅하기 어렵게 만듭니다. icm-architect는 해당 코드를 단순한 폴더 구조로 대체합니다: 번호가 매겨진 폴더가 순서를 설정하고, 계층 구조가 에이전트가 보는 컨텍스트를 제한하며, 마크다운 파일이 상태를 보유합니다. 누구나 폴더를 열어 시스템이 무엇을 하고 있는지 볼 수 있으며, 올바른 시점에 올바른 파일을 읽는 하나의 에이전트가 멀티 에이전트 프레임워크의 작업을 수행할 수 있습니다.

작동 방식

두 가지 모드로 작동합니다. 빌드는 작업을 설명하는 방식에 이미 내재된 구조(단계, 검사, 안정적인 부분과 실행별 부분)를 추출하고 해당 구조를 담는 가장 작은 워크스페이스를 만듭니다. 재구성은 기존 폴더를 감사하고 각 파일을 유형(카탈로그, 계약, 팩토리, 제품, 폐기)으로 분류하고 종속성을 찾고 승인을 위한 마이그레이션 맵을 제안한 다음 마이그레이션하고 검증합니다.

모든 워크스페이스는 세 가지 기본 요소로 구축됩니다: 시퀀스(번호가 매겨진 단계, 각 출력이 다음에 공급), 선반(동일한 모양의 파일 폴더), 카탈로그(아래를 가리키는 작은 파일). 이들은 다섯 가지 형태로 결합됩니다: 파이프라인, 레코드 라이브러리, 지식 번들(모든 인용이 소스에 대해 검증된 트랜스크립트에서 구축된 것을 포함), 컨텍스트 맵, 시스템 맵. 형태는 중첩될 수 있습니다.

각 단계는 검사(사람, 스크립트 또는 작은 모델)로 끝나므로 오류가 증폭되기 전에 포착됩니다. 최종 검증은 워크 테스트입니다: 메모리가 없는 에이전트가 파일만으로 방향을 잡고, 행동하고, 상태를 보고해야 합니다. 워크스페이스는 일반 폴더와 마크다운이며 AGENTS.md를 진입 파일로 사용하고, 다른 파일 이름을 기대하는 에이전트를 위해 한 줄 포인터가 추가됩니다.

대상 사용자

오케스트레이션 코드보다 더 간단하고 투명한 대안을 원하는 에이전트 기반 도구 및 워크플로우를 구축하는 사람들. SKILL.md 파일을 읽는 모든 에이전트(Codex, Gemini CLI, Hermes Agent, Claude Code, Cursor, GitHub Copilot 포함)에서 작동합니다. 또한 팀이 기존 리포지토리나 볼트를 에이전트 친화적이고 해석 가능한 레이아웃으로 재구성하는 데 도움이 됩니다.

주요 특징

• 두 가지 모드: 설명에서 워크스페이스를 구축하거나 감사 및 마이그레이션으로 기존 폴더를 재구성합니다.
• 세 가지 기본 요소와 중첩 가능한 다섯 가지 재사용 가능한 형태를 기반으로 작은 워크스페이스를 최소화합니다.
• 각 단계는 검사로 끝나며, 완성된 워크스페이스는 "워크 테스트"를 통과하여 새 에이전트가 탐색할 수 있음을 보장합니다.
• 벤더 중립적: 일반 폴더와 마크다운에 AGENTS.md를 사용하고 다른 이름을 기대하는 에이전트를 위한 포인터를 제공합니다.
• 선택적 Python 스크립트가 링크와 입력 경로를 확인하고, 워크스페이스 그래프를 그리고, 인덱스를 생성하고, 인용을 소스와 대조 검증합니다.