AI 에이전트와의 협업

TandemLoop은 처음부터 외부 AI 에이전트가 동등한 파트너로서 같은 데이터로 작업할 수 있도록 만들어졌습니다. 앱 자체에는 AI가 없으며, 사용자가 원하는 에이전트형 AI 도구를 연결합니다(AI 도구 연결하기 참조). 데이터 폴더에는 블랙박스 형식이 아니라 어떤 도구든 읽을 수 있는 일반 텍스트 Markdown이 들어 있습니다. 그렇지만 명확한 작업 규칙이 적용됩니다. 구조에 무슨 일이 일어날지는 사용자가 결정합니다.

탠덤 원칙

탠덤 자전거라는 비유는 이 협업을 잘 설명합니다. 사용자는 앞에 앉아 방향을 정하고, 에이전트는 뒤에 앉아 힘을 보탭니다. 어느 쪽도 독단적으로 행동하지 않습니다. 앱에서 이는 다음을 뜻합니다.

• 사용자는 비전, 우선순위, 관계, 결정을 정합니다.
• AI 도구는 전체를 파악하고, 준비하고, 상기시키고, 패턴을 찾고, 동작을 제안합니다.

에이전트가 데이터 폴더로 작업하는 방식

AI 에이전트는 다른 도구와 마찬가지로 데이터 폴더를 읽습니다. 폴더 구조를 탐색하고 YAML-Frontmatter와 Markdown 본문을 읽습니다. 무엇을 쓸 수 있는지는 사용자가 제안을 켰는지에 따라 다릅니다.

기존 태그의 이름 변경과 삭제는 사용자가 앱에서 직접 합니다. 설정과 관계없이 에이전트는 사용자 속성과 테마를 생성할 수 있으며, 사용자가 요청하면 모든 미완료 작업에 미리 알림을 설정할 수 있습니다. 어느 경우든 _archive/, _system/, _conflicts/, _config/의 앱 설정, AGENTS.md의 관리 블록을 직접 편집하는 것은 금지되어 있습니다.

에이전트는 실행할 때마다 _config/agent.yaml(last_run)에 시각을 기록합니다. TandemLoop은 이를 바탕으로 에이전트 반환 › 에이전트에게 전달됨에 에이전트가 마지막으로 작업한 시점을 표시합니다. 자율적이고 지속적인 협업을 참조하십시오.

제안 켜기 또는 끄기

제안은 선택 사항이며 기본적으로 꺼져 있습니다. 언제든지 설정에서 켤 수 있습니다.

이 설정은 데이터 폴더 전체에 적용됩니다. 끄면 TandemLoop이 모든 제안 영역을 가리며, 기존 제안 파일은 그대로 남아 있다가 제안을 다시 켜면 다시 나타납니다.

제안 — 사용자가 승인하는 변경

제안이 켜져 있으면, 제안은 _proposals/ 폴더의 Markdown 파일입니다. 파일에는 하나 이상의 동작(예: ‘작업 X를 프로젝트 Y로 이동’)과 근거가 담겨 있습니다. 제안 전체를 또는 동작별로 승인하거나, 거절하거나, 수정을 요청할 수 있습니다.

제안 작업 흐름에 대한 자세한 내용은 사용 설명서 4부에 있습니다.

사용자 속성 — 에이전트도 생성할 수 있습니다

사용자 속성은 에이전트가 아는 데이터 모델의 일부입니다. AGENTS.md와 _system/docs/data-model.md에는 현재 정의된 모든 속성이 키, 유형, 적용 대상, 옵션, 설명과 함께 나열되어 있습니다. 사용자가 속성을 생성, 변경, 삭제하거나 에이전트가 새로운 정의 파일을 작성하면 앱이 이 목록을 자동으로 업데이트합니다.

예를 들어 에이전트는 사용자의 요청에 따라 작업용 ‘고객’ 속성을 생성한 다음, 값을 입력할 수 있습니다. 제안이 꺼져 있으면 직접 입력하고, 제안이 켜져 있으면 자신에게 지정된 항목과 새로 생성한 항목에는 직접, 그 밖의 모든 항목에는 제안(매개변수 attributes)을 통해 입력합니다.

AGENTS.md — 에이전트를 위한 안내서

데이터 폴더의 루트 디렉터리에는 AGENTS.md 파일이 있습니다. 이 파일은 모든 AI 에이전트에게 허용된 동작, 쓰기 규칙, 디렉터리 구조, 그리고 제안이 켜져 있으면 제안 형식 등 규칙을 설명합니다. 앱은 이 파일을 최신 상태로 유지하며, 제안을 켜거나 끌 때 그에 맞게 다시 작성합니다. 파일을 읽을 수는 있지만, TANDEMLOOP:START와 TANDEMLOOP:END 표시 사이의 시스템 관리 블록은 직접 변경하지 않는 것이 좋습니다.