AGENTS.md는 파일 포맷을 통일했다. 하지만 디렉토리 구조, MCP 설정, 영구 메모리는 여전히 각 툴이 제각각이다. opencode에서 설정한 memory MCP는 Claude Code에선 무용지물이고, Cursor에서 정리한 규칙 파일은 Codex에선 읽히지도 않는다. 이걸 해결하려고 converter 프로젝트만 세 개가 생겼다.

나는 그냥 .agent/ 폴더 하나로 통합했다.

문제는 파일 포맷이 아니었다

2025년, AAIF(Agent AI File) 표준이 등장하면서 AGENTS.md라는 공통 포맷이 생겼다. 근데 그게 끝이었다.

AGENTS.md가 해결한 건 파일 하나의 위치와 포맷뿐이다. 에이전트의 정체성, 불변 규칙, 세션 시작 프로토콜, MCP 서버 설정, 영구 메모리는 여전히 프레임워크마다 완전히 다른 방식으로 관리되고 있었다.

opencode에서 Claude Code로 갈아타면, 내 AI 비서는 갑자기 나를 기억하지 못한다. 세션마다 다시 설명해야 하고, 규칙은 다시 써야 하고, MCP 설정은 또 다른 JSON을 편집해야 한다.

내가 만든 것

  1. .agent/ 디렉토리 구조

.agent/ ├── identity.md # 역할, 말투, 가치관 ├── rules.md # 불변 규칙 (must / must not) ├── workflow/ │ ├── init.md # 세션 시작 프로토콜 │ └── general.md # 작업 워크플로우 └── memory/ # SQLite FTS5 (자동 생성)

AGENTS.md는 AAIF 표준을 따르되, 부트로더 역할만 한다:

Read .agent/identity.md, .agent/rules.md, and .agent/workflow/ at session start.

  1. @agent-workspace/memory MCP 서버

SQLite FTS5 기반 영구 메모리. remember / recall / forget / update / memory-stats 5개 도구. opencode, Claude Code, Cursor 모두에서 동작한다.

  1. init.sh — curl | bash 한 줄

curl -fsSL https://raw.githubusercontent.com/humanerd-drew/agent-workspace/main/init.sh | bash

프레임워크 자동 감지 → .agent/ 생성 → MCP 설정 주입. –install 플래그로 memory MCP 서버까지 자동 설치.

npm 대신 GitHub 템플릿

이 프로젝트의 본질은 패키지가 아니라 “구조”다. GitHub template repo가 배포 채널. npm은 2FA 인증 보류.

해볼 사람은 여기서

GitHub: github.com/humanerd-drew/agent-workspace

curl -fsSL https://raw.githubusercontent.com/humanerd-drew/agent-workspace/main/init.sh | bash

이슈/PR 환영. 표준은 혼자 만드는 게 아니니까.

“또 다른 converter를 만들지 말자. 그냥 같은 폴더를 보게 하자.”