특정 프로젝트(예: 코드 저장소)에서 이미 AI 도구로 작업하고 있다면 에이전트에게 매번 데이터 폴더 경로를 알려 줄 필요가 없습니다. 대신 프로젝트 디렉터리에 TandemLoop 데이터 폴더를 가리키는 링크를 만듭니다. 그러면 에이전트가 코드 ‘바로 옆’에서 공동 작업 기반을 찾을 수 있습니다.
연결하는 이유
AI 도구는 대개 정해진 작업 디렉터리(프로젝트 폴더)에서 작업합니다.
심볼릭 링크(Symlink)를 사용하면 파일을 복사하지 않고도
데이터 폴더를 그 안의 하위 폴더처럼 둘 수 있습니다. 그러면 프로젝트의
CLAUDE.md 또는 AGENTS.md에 ‘작업 관리는 연결된
폴더의 AGENTS.md를 읽으십시오’라고 적어 두기만 하면 됩니다.
에이전트는 그곳에서 규칙을 읽고, 프로젝트 자체를 작업하면서 동시에
TandemLoop 작업도 처리합니다.
1단계: 데이터 폴더 경로 확인하기
설정 › 데이터 폴더 › 경로 확인(또는 ‘Finder에서 열기’)
2단계: 심볼릭 링크 생성하기
프로젝트 디렉터리에서 다음 명령 중 하나를
실행합니다. <데이터-폴더-경로>를 1단계에서 확인한
경로로 바꿉니다. 여기서는 링크 이름이 tandemloop입니다.
macOS / Linux:
ln -s "<데이터-폴더-경로>" tandemloop
Windows(PowerShell):
New-Item -ItemType SymbolicLink -Name tandemloop -Target "<데이터-폴더-경로>"
데이터 폴더를 저장소에 커밋하지 마십시오. 프로젝트가
Git으로 관리된다면 데이터 폴더의 내용이 실수로 저장소에 포함되지 않도록
링크를 .gitignore에 추가하십시오.
echo "tandemloop" >> .gitignore
3단계: 에이전트에게 알려 주기
프로젝트의 CLAUDE.md 또는 AGENTS.md에 짧은
섹션을 추가합니다. 복사용 템플릿:
## 작업 및 프로젝트 관리(TandemLoop)
작업, 프로젝트와 그 상태는 TandemLoop에서 관리합니다. 데이터 폴더는 이 프로젝트에
`./tandemloop`으로 연결되어 있습니다. 작업을 읽거나, 생성하거나, 편집하거나, 상태를
변경하려면 먼저 `./tandemloop/AGENTS.md`를 읽고 그 규칙을 엄격히 따르십시오.
이제 프로젝트에서 ‘TandemLoop에서 미완료 작업을 확인해 줘’ 정도로만 말해도 에이전트가 링크와 그곳의 규칙을 따릅니다.
한 번에 처리하기: 프롬프트로 생성하게 하기
2단계와 3단계를 AI 도구에 맡길 수도 있습니다. 다음 프롬프트를 복사하고 경로를 바꾼 다음 에이전트에게 전달하십시오. 경로가 이미 채워진 프롬프트는 에이전트 튜토리얼(Mac)의 마지막에서도 찾을 수 있습니다.
이 프로젝트 디렉터리에 내 TandemLoop 데이터 폴더(<데이터-폴더-경로>)를 가리키는
`tandemloop`이라는 심볼릭 링크를 만들어 주세요. 여기가 Git 저장소라면 .gitignore에
`tandemloop`을 추가해 주세요. 그런 다음 이 프로젝트의 AGENTS.md(또는 CLAUDE.md)에
작업 및 프로젝트 관리를 위해 먼저 `./tandemloop/AGENTS.md`를 읽고 그 규칙을
따르라는 섹션을 추가해 주세요.
여러 프로젝트, 하나의 데이터 폴더. 원하는 만큼 많은 프로젝트 폴더에 같은 데이터 폴더를 가리키는 링크를 만들 수 있습니다. 그러면 모든 AI 프로젝트가 같은 작업 기반을 사용합니다. 다만 여러 에이전트가 동시에 쓰지 않도록 주의하십시오. 자율적이고 지속적인 협업을 참조하십시오.
에이전트를 위한 전체 쓰기 규칙은 AI 에이전트와의 협업에 있습니다.