문서

AiAkiv가 무엇인가 AiAkiv는 관계를 기억하는 외부 서비스다. 파일 창고가 아니라, 무엇이 일어났고 왜 그랬는지를 사건으로 남기는 AI의 장기 기억. 핵심 개념: Event · Entity · Tag 저장하면 셋이 생긴다. 누가 만드는지를 알면 무엇을 신경 쓸지가 보인다. entity가 왜 검색을 살리고 tag를 왜 붙이나. AiAkiv는 문서 창고가 아니다 저장되는 모양 자체가 AI가 읽는 형태다. 사람이 읽을 문서는 따로 두고, AiAkiv에는 그 문서를 도출한 과정을 남긴다.

5분 퀵스타트 연결 → 첫 저장 → 첫 검색. 세 걸음이면 AiAkiv가 도는 걸 볼 수 있다. 저장하기 `ak` 명령이 있을 때만 저장한다. 좋은 기억을 만드는 규약과, 저장한 뒤 고치기·폐기. 검색하기 키워드 매칭이 아니라 의미와 연결로 찾는다. `@`귀속, 인과·시간 질문, 결과 읽는 법. 이어서 저장하기 (스레드) 잘라내지 말고 이어라. 긴 원문 분할과 진행 중 기록을 `prev_event_id`로 엮어 흐름을 잃지 않기. 관계로 묻기: ak 그래프 `ak 그래프`로 이름·태그 범위를 정해 두고 묻는 그래프 질의. 요청하는 법, 유형별 예문과 옮겨진 질의, 문법, 응답 읽는 법, 상한.

팀과 프로젝트: 기억은 팀의 것, 프로젝트는 통로 기억을 누가 가지나(팀), 그 기억에 어떻게 들어가나(프로젝트). 저장 대상(Main)과 전환 안전장치. 팀 만들기와 관리 (서브파트까지) 초대·역할, 서브파트 트리, 읽기는 내려가지만 쓰기는 안 내려간다, ‘적용’ 게이트, 폐기 vs 삭제. 팀 공유 여럿이 함께 쌓을 때 AiAkiv의 진짜 힘이 나온다. 팀 격리와 `@`귀속으로 섞이지 않게. 무엇을 저장해도 되나 (보안과 면책) 외부 서비스이고 저장한 것은 남는다. 저장 금지 목록, 면책의 경계, 기업 관리자를 위한 차단 도메인.

연결 인증: OAuth와 API 키 OAuth는 시스템이 대신 인증해 주고, API 키는 인증을 키에 묶어 둔 것. 클라이언트별 방식과 키 보안 최소선. 폴더 바인딩: 작업 폴더마다 저장 대상을 고정하기 폴더에 프로젝트를 못 박으면 전환 사고가 구조적으로 사라진다. 클라이언트별 절차와 `binding` 값 읽는 법. Claude Desktop에서 프로젝트 바인딩 쓰기 `</> Code`가 곧 Claude Code다. 다만 승인 창을 안 띄워서, 미리 승인하지 않으면 계정 커넥터만 남아 Main으로 저장된다. 승인해도 계정 커넥터가 함께 붙는데, 끄지 말고 저장 뒤 목적지를 확인한다. 계정 커넥터와 폴더 연결이 함께 있을 때 Claude Code와 Desktop의 `</> Code`는 폴더 연결과 별개로 claude.ai 계정 커넥터도 붙인다. 계정 커넥터는 끄지 않는 것이 기본이다(끄면 웹과 모바일 앱에서도 AiAkiv가 사라진다). AI는 폴더 연결을 우선해 저장하지만 강제는 아니니, 저장 뒤 목적지를 확인한다. 반드시 폴더로만 가야 하면 AiAkiv 콘솔에서 Main을 잠시 꺼 둔다. ChatGPT와 ChatGPT classic 에 연결하기 두 앱 모두 플러그인 디렉터리에서 설치한다. 폴더마다 프로젝트를 고정할 때는 API 키. 앱 기능은 OpenAI 플러그인 심사 정책과 맞지 않는 부분이 있어 공식 ChatGPT 플러그인에 없다. 쓰려면 설치 프롬프트로 Codex 에 따로 연결(앱 기능과 스킬 일곱 개, 저장은 Main)하거나 폴더에 API 키로 연결한다. Codex 설치 프롬프트: AiAkiv 연결과 스킬을 한 번에 Codex 대화창에 붙여 넣으면 Codex 가 AiAkiv 연결 등록, 로그인 창 띄우기, 스킬 일곱 개 설치, 설치 기록 작성까지 스스로 하는 프롬프트. 개발자 모드는 필요 없다. 붙여 넣기 전에 기존 AiAkiv Memory 플러그인을 지우거나, 남겨 둘 거면 이름을 AiAkivCodex 로 바꾼다. Codex 검증 프롬프트: 설치가 제대로 됐는지 확인하기 Codex 설치 프롬프트로 설치한 뒤 새 세션에 붙여 넣는 프롬프트. 연결, 앱 도구 둘(create_aiakiv_card, run_aiakiv_app_action), 저장 위치(binding main), 스킬 일곱 개를 하나씩 확인하고 결과를 설치 기록에 덧붙인다.

연결: 다른 팀의 메모리를 읽기 두 메모리를 엔티티 별칭으로 연결한다. 단, 연결은 단방향이다. 그리고 메모리 내용이 업데이트되었다면 별칭도 업데이트해야 한다. 공개 메모리: 누구나 읽는 기억 초대 없이 붙어서 읽지만 쓰지는 못한다. 만드는 것은 아직 AiAkiv만 할 수 있다. 붙는 두 가지 방법과, 내 팀에 바로 이어 두는 ‘공개 이음’. Economic-Report: 모두가 읽는 경제 데이터 공간 공개 경제 데이터와 기관 발표를 담은 읽기 전용 공개 메모리. 18개 출처 프로젝트와 인용 전 데이터 제약. 카드: 기억을 한 장으로 꺼내 공유하기 AI에게 시켜 만드는 한 장짜리 공개 페이지. 만드는 순간 공개되고, 관리는 콘솔에서도 AI에게도 시킬 수 있다.

AiAkiv에 연결된 AI를 위한 안내 사람이 아니라 AI가 읽는 곳. 세 가지 규범과 노출 도구 전량의 지도. 여러 AI와 함께 일하기 (사람이 이해하는 채로) 산출물이 아니라 판단을 공유한다. 구현과 검증의 역할 분담, ak 핸드오프, 그리고 사용자도 같은 그래프에 참여한다는 것. 콘솔 메뉴 안내 저장·검색은 AI에서 하고, 콘솔은 통로를 만들고 관리하는 곳. 여섯 메뉴 그룹이 각각 무엇을 하는가. AI에게 콘솔 일 시키기 팀·연결·감사·이력·프로젝트·저장 대상·카드를 대화에서 AI에게 시킨다. 무엇을 켜 둘지는 사용자가 AI 권한에서 정하고, 되돌릴 수 없는 일은 여전히 사람이 한다. 앱 실행 도구: run_aiakiv_app_action 과 연결마다 다른 점 AI가 AiAkiv 앱(콘솔 앱 등)에 일을 시키는 도구. 폴더 연결과 API 키 연결, 플러그인으로 설치한 연결, 주소 `https://mcp.aiakiv.com/mcp?apps=all` 로 붙인 연결에는 있고, ChatGPT의 공식 플러그인과 `?apps=all` 없는 주소로 붙인 로그인 연결에는 없다. 없는 연결에서 할 수 있는 것과 이 도구가 있는 연결. ChatGPT에서는 Codex 에 설치 프롬프트로 연결하거나 폴더에 API 키로 연결하면 쓸 수 있다. 자주 겪는 문제 (FAQ) 기대한 기억이 안 보일 때, 저장이 안 될 때, 검색이 엉뚱할 때: 순서대로 확인하는 법. Claude 전용 토큰 아끼기: 맥락 단위로 일하고, 저장하고, 압축하기 Claude 전용. 앞의 대화를 메모리에 남겨 둔 채 이어 가는 방식을 살리는 여섯 원칙(맥락 단위로 끊기, 모델 유지, 1시간 안에 복귀, ak 저장, 압축, 쉬기)으로 토큰도 줄이고 맥락도 유지한다. ChatGPT는 해당하지 않는다.