Harness engineering,
닷파일이 아니라 창에서
에이전트가 무엇을 할 수 있는지는 그 harness, 즉 페르소나, 도구, 메모리가 결정합니다. AgentsRoom은 이것을 세 개의 독립된 설정으로 나눠 에이전트별, 작업별로 조합할 수 있게 합니다.
툴킷은 스킬, MCP 서버, 저장된 연결, 환경 변수를 하나의 이름으로 묶습니다. 에이전트, 단일 티켓, 팀 단계, 프로젝트 또는 고객사 폴더에 첨부하세요. 한 번 수정하면 이를 사용하는 모든 에이전트가 다음 실행 때 변경 사항을 받습니다. Claude Code, Codex와 다른 모든 에이전트 CLI에서 똑같이 작동합니다.
- scan-documents
- summarize
- notes (MCP)
- staging-db
- Claude Code
- Codex
- Antigravity
- Cursor
티켓에 첨부된 리서치 툴킷: 에이전트는 실행 시 스킬, MCP 서버, 연결을 받고, 프로젝트 메모리는 읽기만 할 뿐 쓰지 않습니다.
Harness engineering(에이전트를 둘러싼 환경 설계)은 코딩 에이전트 주변의 것들, 즉 어떤 지시를 읽고, 어떤 도구를 호출할 수 있고, 어떤 지식을 간직하는지를 다듬는 작업입니다. 오늘날 그 대부분은 파일 안에 있습니다. 여기엔 CLAUDE.md, 저기엔 mcp.json, CLI마다 스킬 폴더, 셸 프로필에는 환경 변수. 손으로 복사하지 않는 한 어느 것도 다음 에이전트나 다음 작업으로 넘어가지 않습니다.
AgentsRoom에서 에이전트는 따로 설정하는 세 가지로 이루어집니다. 페르소나는 에이전트가 누구인지 정합니다. 툴킷은 무엇을 쓸 수 있는지 정합니다: 스킬, MCP 서버, 저장된 SSH, 데이터베이스, 개발 명령 연결, 환경 변수. 메모리 설정은 공유 프로젝트 메모리를 읽고 쓸지 정합니다. 하나를 바꿔도 나머지 둘은 그대로입니다.
툴킷은 복사되지 않고 참조로 첨부됩니다. 문서 스캔 스킬, 요약 스킬, 노트 앱 연결로 만든 리서치 툴킷 하나를 리뷰어 에이전트, 단일 티켓, 고객사 폴더 전체에 동시에 붙일 수 있고, 툴킷을 개선하면 그 모두에 반영됩니다.
에이전트 정의 하나 대신 세 개의 설정
페르소나 없이 작업에 기능을 주고, 메모리 없이 페르소나를 유지하고, 같은 도구를 다른 역할에서 재사용하세요.
스킬, MCP 서버, 연결을 툴킷 하나에
라이브러리에서 스킬을 고르고, 저장된 SSH, 데이터베이스, 개발 명령 연결을 고르고, 이미 쓰고 있는 MCP 서버 JSON을 붙여넣고, 환경 변수를 추가하세요. 자격 증명은 {{secret:NAME}} 참조로 시크릿 관리자에 남아 있다가 실행 시 내 컴퓨터에서 풀립니다.
참조로 첨부
에이전트, 티켓, 설정에는 툴킷 자체가 저장되며, 그 내용의 복사본이 저장되지 않습니다. 툴킷을 한 번 수정하면 이를 사용하는 모든 에이전트가 다음 실행 때 새 스킬과 서버를 받습니다.
이미 쓰고 있는 모든 단위에서
툴킷을 에이전트 하나, 저장된 에이전트, 단일 백로그 티켓, 에이전트 팀의 단계, 프로젝트 전체 또는 고객사 폴더에 첨부하세요. 고객사 폴더의 하위 폴더는 자체 툴킷을 추가할 수 있습니다.
작업 하나를 위한 기능
티켓은 에이전트를 바꾸지 않고 자체 툴킷을 가져올 수 있습니다. 이 툴킷은 에이전트 자체의 툴킷에 더해지며, 티켓의 스킬 모드가 교체이면 에이전트, 프로젝트, 폴더의 툴킷을 모두 대체합니다.
페르소나와 분리된 메모리
프로젝트 메모리를 에이전트별로 끄기, 읽기 전용, 읽기 및 쓰기 중에서 정하고, 티켓 하나에 대해서만 덮어쓸 수도 있습니다. 읽기 전용이면 리뷰 에이전트가 지식 베이스를 활용하되 다시 쓰지는 못합니다.
모든 에이전트 CLI, 데스크톱과 휴대폰에서
스킬은 모든 CLI에 텍스트로 전달되고, Claude Code와 Antigravity에서는 네이티브 스킬로도 전달됩니다. MCP 서버는 각 CLI 고유의 형식으로 기록됩니다. 툴킷은 데스크톱이나 모바일 앱에서 만들고 첨부할 수 있으며, AgentsRoom 도구로 에이전트에게 맡길 수도 있습니다.
1분 안에 툴킷 만들기
수정할 파일도, 직접 재시작할 것도 없습니다.
- 1
라이브러리 열기
제목 표시줄의 에이전트 옆에 있는 서류 가방 아이콘이나 툴킷 필드 옆의 관리를 클릭한 다음 새 툴킷을 선택하세요.
- 2
채우기
이름을 붙이고, 스킬과 연결을 고르고, MCP 서버를 붙여넣고, 환경 변수를 추가하세요. 토큰에는 {{secret:NAME}}를 사용하세요.
- 3
첨부하기
에이전트 편집 > 고급 옵션 > 툴킷, 티켓, 팀 단계, 프로젝트 설정 > 기능 및 권한, 또는 폴더 설정 > 지식에서 첨부합니다.
- 4
메모리 선택
툴킷 바로 아래에서 프로젝트 메모리를 끄기, 읽기 전용, 읽기 및 쓰기로 설정하거나 상속 상태로 두세요.
- 5
실행
에이전트를 다음에 실행하면 툴킷이 해당 CLI에 펼쳐집니다: 스킬, 서버, 연결, 변수. 저장소에는 아무것도 기록되지 않습니다.
페르소나, 도구, 메모리를 나누는 이유
지금까지는 에이전트 정의 하나가 모든 것을 한꺼번에 담고 있었습니다. 같은 스킬과 서버 세트를 다른 역할에서 쓰려면 다시 만들어야 했고, 에이전트를 프로젝트 메모리에서 떼어 놓는 유일한 방법은 최소 시스템 프롬프트로 페르소나까지 벗겨 내는 것이었습니다.
나누면 세 가지 설정이 실제 상황에 맞아떨어집니다. 메모리를 읽기만 하고 절대 쓰지 않는 리뷰어, 에이전트에 없는 노트 서버가 필요한 일회성 리서치 티켓, 모든 에이전트가 같은 스테이징 데이터베이스에 접근해야 하는 고객사 폴더, 자기 차례에만 브라우저 툴킷을 쓰는 팀 단계.
닷파일을 관리하고 싶지 않은 사람에게는 harness engineering의 입구이기도 합니다. 모든 선택이 에이전트 창에 보이고, 계정과 함께 다른 컴퓨터로 이어지며, 한눈에 점검할 수 있습니다.
알아 두면 좋은 점
- 변경 사항은 에이전트의 다음 실행부터 적용됩니다. 이미 실행 중인 세션은 시작할 때의 구성을 그대로 유지합니다.
- 툴킷 안의 프로젝트 스킬이나 연결은 해당 프로젝트에서만 적용됩니다. 계정 스킬은 어디서나 적용됩니다.
- 툴킷은 내 계정에 속합니다. 동료와 공유하는 팀에서는 각자의 실행이 자기 툴킷만 불러옵니다.
- 팀 단계에는 툴킷은 있지만 메모리 설정은 없습니다. 아무것도 기록하면 안 되는 단계에는 그 단계의 읽기 전용 단계 스위치를 사용하세요.
- 툴킷은 에이전트, 티켓, 단계, 프로젝트, 폴더마다 최대 20개, 계정당 최대 200개까지입니다.
- SSH로 원격 머신에서 실행되는 에이전트는 툴킷의 스킬은 받지만 MCP 서버는 받지 않습니다.
자주 묻는 질문
Harness engineering이란 무엇인가요?
프롬프트만이 아니라 코딩 에이전트의 환경 자체를 다듬는 방법입니다: 불러오는 지시, 호출할 수 있는 도구와 MCP 서버, 읽고 쓰는 지식. AgentsRoom은 이 요소들을 세 가지 설정(페르소나, 툴킷, 메모리)으로 제공하며, 에이전트별, 작업별로 정할 수 있습니다.
같은 스킬과 MCP 서버를 여러 에이전트에서 재사용할 수 있나요?
네. 툴킷에 넣고 각 에이전트에 첨부하거나, 프로젝트나 폴더에 첨부해 그 안의 모든 에이전트가 받게 하세요. 툴킷을 수정하면 다음 실행 때 모두 업데이트됩니다.
에이전트에 없는 MCP 서버를 티켓 하나에만 줄 수 있나요?
네. 티켓에 툴킷을 첨부하세요. 그 실행은 에이전트 자체의 툴킷에 더해 이 툴킷을 받고, 에이전트의 저장된 구성은 바뀌지 않습니다.
페르소나를 잃지 않고 에이전트가 프로젝트 메모리에 쓰지 못하게 하려면 어떻게 하나요?
프로젝트 메모리를 읽기 전용으로, 메모리를 완전히 숨기려면 끄기로 설정하세요. 페르소나와 도구는 그대로 유지됩니다. 티켓 하나에만 설정할 수도 있습니다.
Codex와 다른 에이전트 CLI에서도 되나요, 아니면 Claude Code에서만 되나요?
AgentsRoom이 실행하는 모든 에이전트 CLI에서 됩니다. 스킬은 어디서나 텍스트로, Claude Code와 Antigravity에서는 네이티브 스킬로도 전달되고, MCP 서버는 각 CLI 고유의 설정 형식으로 기록되며, 연결과 변수는 CLI와 상관없이 에이전트를 따라갑니다.
토큰은 어디에 저장되나요?
툴킷 자체에는 절대 저장되지 않습니다. 툴킷에는 시크릿 관리자를 가리키는 {{secret:NAME}} 참조만 있고, 값은 에이전트가 시작될 때 내 컴퓨터에서 풀립니다.
에이전트가 툴킷을 대신 만들어 줄 수 있나요?
네, 요청하면 만들어 줍니다. AgentsRoom 도구에는 toolkits_list, toolkits_get, toolkits_save, toolkits_delete가 있고, agents_save, 백로그 티켓, 팀 단계, 프로젝트나 폴더 설정은 툴킷 목록을 받습니다. 에이전트는 스스로 접근 권한을 얻으려고 툴킷을 만들지 말라는 지시를 받습니다.
이런 기능도 있습니다
Multi-Agent Workflow • Handoff • Feedback Loop
AgentsRoom Agent Teams는 AI 코딩 에이전트를 진짜 엔지니어링 팀처럼 연결합니다. Dev, QA, PM, Security, DevOps 역할을 배선하는 비주얼 워크플로 에디터 (n8n 스타일 캔버스). 요약, git diff, 리스크, 테스트 힌트가 담긴 자동 핸드오프. 머신 검증 품질 게이트 (판정은 에이전트가 아니라 당신의 테스트 스위트가 합니다), 병렬 QA와 Security 리뷰 브랜치, 조건부 연결, 피드백 루프, 사이클 상한. 역할을 어떻게 돌릴지 팀마다 고릅니다. 역할에서 역할로 모핑하며 컨텍스트 전체를 지키는 에이전트 하나, 아니면 역할마다 살아 있는 에이전트를 두고 실시간으로 메시지를 주고받게 하는 방식입니다. Claude, Codex, GitHub Copilot CLI, Cursor 및 그 외 에이전트 CLI 13개에서 돌아가는 에이전트에게 없던 멀티 에이전트 오케스트레이터입니다.
MCP 서버
MCP 서버를 한 번 선언하면 Claude Code, Codex, 모든 에이전트 CLI에 전달됩니다. 공식 MCP 레지스트리에서 고르고, 키는 시크릿 관리자에 보관하고, Notion이나 Linear 같은 OAuth 서버에는 '연결' 버튼 하나로 로그인하세요.
프로젝트 메모리
AI 코딩 에이전트에게 장기 메모리를 제공합니다. 결정, 아키텍처 및 함정이 세션 간에 지속되며 프로젝트의 모든 사람과 공유됩니다. 무료, 무제한.
에이전트 사용자 정의
14개의 내장 에이전트 역할 중에서 선택하고, The Agency의 전문 에이전트를 추가하거나, 고유한 시스템 프롬프트를 가진 맞춤형 AI 코딩 에이전트를 구축하세요. 그런 다음 팀과 함께 에이전트를 공유하고, 커뮤니티에 게시하여 모두가 함께 발전할 수 있도록 하세요.
시크릿 관리자
API 키, 토큰, 비밀번호를 OS 키체인에 저장하고, 개발 명령과 에이전트 환경에서 {ref}로 참조하면 AgentsRoom이 실행 시점에 실제 값을 채웁니다. 에이전트는 이름만 볼 뿐 값은 보지 못하며, 서버로 동기화되는 것은 아무것도 없습니다.
에이전트 장비는 한 번만 갖추세요
macOS, Windows, Linux에서 무료이며, 모바일 앱으로 휴대폰에서도 툴킷을 관리할 수 있습니다.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.
버그와 요청을 공개 백로그로 바로 보내세요.