diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..29d131a
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,19 @@
+# AGENTS.md
+
+Project-specific agent instructions can be added here. The shared cross-project memory contract is below.
+
+<!-- LLM-WIKI:START -->
+## Cross-project LLM-wiki
+
+This repo participates in the shared LLM-wiki at `/Users/petrilahdelma/SAPDevelop/llm-wiki`.
+
+Read before non-trivial work:
+- Start with a compact project memory packet: `/Users/petrilahdelma/SAPDevelop/llm-wiki/wiki/tools/llm-wiki-context.mjs --project "vertaaux-sdk" --query "<task or topic>"`.
+- For broader retrieval, search adjacent concepts with `/Users/petrilahdelma/SAPDevelop/llm-wiki/wiki/tools/qmd-query.sh "vertaaux-sdk <task or topic>"`.
+- Open relevant pages under `/Users/petrilahdelma/SAPDevelop/llm-wiki/wiki` before deciding.
+
+Write after durable discoveries:
+- Capture decisions, reusable gotchas, cross-project patterns, source summaries, and project-state changes with `/Users/petrilahdelma/SAPDevelop/llm-wiki/wiki/tools/llm-wiki-capture.mjs --project "vertaaux-sdk" --kind decision --title "<title>" --summary "<what changed and why>"`.
+- Do not capture secrets, raw logs, transient TODOs, or live coordination state.
+- Do not edit compiled wiki pages from this repo. Capture first; the LLM-wiki ingest pass will file it into entities, concepts, patterns, or synthesis.
+<!-- LLM-WIKI:END -->
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..85b5a51
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,19 @@
+# CLAUDE.md
+
+Project-specific agent instructions can be added here. The shared cross-project memory contract is below.
+
+<!-- LLM-WIKI:START -->
+## Cross-project LLM-wiki
+
+This repo participates in the shared LLM-wiki at `/Users/petrilahdelma/SAPDevelop/llm-wiki`.
+
+Read before non-trivial work:
+- Start with a compact project memory packet: `/Users/petrilahdelma/SAPDevelop/llm-wiki/wiki/tools/llm-wiki-context.mjs --project "vertaaux-sdk" --query "<task or topic>"`.
+- For broader retrieval, search adjacent concepts with `/Users/petrilahdelma/SAPDevelop/llm-wiki/wiki/tools/qmd-query.sh "vertaaux-sdk <task or topic>"`.
+- Open relevant pages under `/Users/petrilahdelma/SAPDevelop/llm-wiki/wiki` before deciding.
+
+Write after durable discoveries:
+- Capture decisions, reusable gotchas, cross-project patterns, source summaries, and project-state changes with `/Users/petrilahdelma/SAPDevelop/llm-wiki/wiki/tools/llm-wiki-capture.mjs --project "vertaaux-sdk" --kind decision --title "<title>" --summary "<what changed and why>"`.
+- Do not capture secrets, raw logs, transient TODOs, or live coordination state.
+- Do not edit compiled wiki pages from this repo. Capture first; the LLM-wiki ingest pass will file it into entities, concepts, patterns, or synthesis.
+<!-- LLM-WIKI:END -->