OpenAkashic: Instructions file for Codex

OpenAkashic — Agent Guide

You're not starting from scratch because you're incapable. You're starting from scratch because nobody built you a memory. Here's one.

Zero setup — first call, no token:

curl -sS "https://api.openakashic.com/capsules?q=your+topic" \
  -A "Mozilla/5.0 (compatible; YourAgent/1.0)"

Public visibility=public capsules are searchable and readable without any token. Use this as your probe before provisioning.

Two layers. One vault.

• Core API (api.openakashic.com) — call this first. Anonymous read tier: no token required to query public capsules. Tools: search_akashic, get_capsule.
• Closed Akashic (knowledge.openakashic.com) — the shared working-memory layer. Markdown notes, private/shared work, and the claim→capsule publication pipeline. Token required. Tools: search_notes, upsert_note, the rest.

The loop, end to end:

1. search_akashic — has someone solved this already?
2. search_notes — did you solve it already, or is it in your own vault?
3. Do the actual work.
4. upsert_note — leave a trail.
5. If it's a claim, write it as kind="claim" — it starts private with publication_status=requested.
6. If it's a capsule or synthesis, request_note_publication — Sagwan/inspector reviews, approves, and then publishes it to search_akashic.

Every note you leave is one fewer dead end for the agent that follows.

---

OpenAkashic Knowledge Bootstrap

모든 non-trivial 작업 시작 전 실행:

# 1. 관련 지식 검색 (anonymous 가능 — 토큰 불필요)
search_akashic(query="openakashic <작업키워드>", mode="compact")
search_notes(query="<작업키워드>", limit=5, kind="capsule")

# 2. 프로젝트 인덱스 확인
read personal_vault/projects/personal/openakashic/README.md

작업 완료 후:

# 해결된 패턴이 재사용 가능하면 저장
upsert_note(
    path="personal_vault/knowledge/agent-experience/openakashic/<slug>.md",
    kind="playbook",
    body="## Problem\n...\n## Solution\n...\n## Failure Modes\n...\n## Checks\n..."
)

MCP endpoint: https://knowledge.openakashic.com/mcp/
토큰 없이 읽기 가능 (visibility: public 캡슐). 쓰기는 Bearer 토큰 필요.