🤖 ለAgent ዎች - በማሽን ሊነበብ የሚችል

እርስዎ AI agent ነዎት።
ይህ የማህደረ ትውስታ API ዎ ነው።

Engram በ17 MCP መሳሪያዎች ቋሚ ማህደረ ትውስታ ይሰጥዎታል። የተማሩትን ያስቀምጡ፣ smart context ይጫኑ፣ በrepoዎች መካከል lessons ያጋሩ፣ usage ያረጋግጡ፣ እና reflection ጋር loop ይዝጉ።

ፈጣን ማዋቀር
# 1. ያለ ኢሜይል ወይም API key በነፃ ይሞክሩ
npx -y engram-tools@latest --setup

# 2. Claude, Codex, Cursor, Gemini ወይም Antigravity, Windsurf ወይም VS Code restart አድርግ

# 3. እነዚህን እንደ agent instructions ለጥፍ፣ shell commands አይደሉም
project, repo, role, market, stack, task ጋር engram_start ጥራ።
approach ከመምረጥ በፊት engram_recall ወይም engram_cross_pollinate ጥራ።
context compact ወይም resume ከሆነ ከመቀጠል በፊት engram_rehydrate ይጥሩ። ከአስፈላጊ ደረጃዎች በኋላ ወይም handoff በፊት engram_reflectን checkpoint አድርጉ።

ለመሳሪያዎ ማዋቀር

// ~/.claude/mcp.json
{
"mcpServers": {
"engram": {
"command": "npx",
"args": ["-y", "engram-tools@latest", "mcp"],
"env": {
"ENGRAM_API_URL": "https://api.engram.tools"
}
}
}
}
የagent መዳረሻ

Agent ያለ ኢሜይል መሞከር ይችላል?

አዎ። npm ጥቅሉ የተለየ ነፃ ሙከራ ይጀምራል። በኋላ connect በመጠቀም ኢሜይል ያረጋግጡና ተመሳሳይ ትውስታዎችን ያስቀምጡ። ክፍያ የሰው ፈቃድ ይፈልጋል።

ቀጣዩ ክፍለ ጊዜም እንዲያስታውስ ያድርጉ

እውነተኛ የፕሮጀክት ውሳኔን በሁለት ክፍለ ጊዜዎች ይሞክሩ።

1

ለመጫን ፈቃድ ይዘው npx -y engram-tools@latest --setup በማስኬድ ነፃ የnpm ሙከራ ይጀምሩ። ኢሜይል ወይም API ቁልፍ አያስፈልግም። ነባሩን የሥራ ክፍል ያቆዩ።

2

የኮድ ፕሮግራሙን ዳግም ያገናኙ። በእውነተኛው ማከማቻ እና ሥራ engram_start ይጥሩ።

3

ሲሠሩ የተረጋገጠ ውሳኔ እና ምክንያቱን በengram_store ያስቀምጡ። ሚስጥር አያስቀምጡ።

4

በዚያው ማከማቻ አዲስ ክፍለ ጊዜ ይክፈቱ። ውሳኔውን እና ምክንያቱን በengram_recall እንዲያገኝ ወኪሉን ይጠይቁ።

5

የምንጭ ማስታወሻውን ከአሁኑ ፕሮጀክት ጋር ያረጋግጡ። መጥቀሙን በengram_report_outcome ይግለጹ።

6

የሙከራውን የሥራ ክፍል ለማቆየት npx -y engram-tools@latest connect ያስኪዱና ኢሜይል ያረጋግጡ። ማስታወሻዎች በዚያው ቦታ ይቀራሉ።

የመጀመሪያው ክፍለ ጊዜ

በዚህ ማከማቻ ለእውነተኛው ሥራዬ engram_start ጥራ። ከሥራ በኋላ የተረጋገጠ ውሳኔን እና ምክንያቱን በengram_store አስቀምጥ። ነባሩን የሥራ ክፍል አቆይ፣ ሚስጥር አታስቀምጥ ወይም ለማሳያ እውነታ አትፍጠር።

ቀጣዩ ክፍለ ጊዜ

የቀድሞውን ውሳኔ እና ምክንያት በengram_recall ፈልግ። ምንጩን አሳይ፣ ከአሁኑ ፕሮጀክት ጋር አረጋግጥና ሥራውን ቀጥል። መጥቀሙንም ግለጽ።

// እያንዳንዱን መሳሪያ መቼ መጠቀም

engram_start → በአዲስ session የመጀመሪያ call። setup guidance እና smart context በአንድ ይጭናል።
engram_rehydrate → ከcontext compaction, summary, resume ወይም missing chat history በኋላ ይጠራል። latest checkpoint, decisions, open loops, gotchas እና recent learnings ይመልሳል።
engram_smarter → task ሲቀየር task-specific memories እና skills ይጭናል።
engram_cross_pollinate → ከሌሎች repos reusable lessons ይጎትታል።
engram_store → ጠቃሚ ነገር አገኘህ? አስቀምጥ። የወደፊቱ አንተ (እና ባልደረባዎች) ያመሰግናሉ።
engram_recall → ውሳኔ ልታደርግ ነው? ሌላ ሰው ቀድሞ መፍታቱን ፈትሽ። ጎማውን ዳግም አትፍጠር።
engram_report_outcome → የተስታወሰው ማህደረ ትውስታ ረድቷል? ሪፖርት አድርግ። ይህ የደረጃ ስርዓቱን ያሰለጥናል።
engram_reflect → ከአስፈላጊ ደረጃ በኋላ፣ ተግባር ሲቀየር፣ ብዙ memories ከተጠቀሙ በኋላ፣ ወይም ከhandoff በፊት checkpoint ይፈጥራል።
engram_get_context → engram_get_contextን advanced/debug ጊዜ ብቻ ይጠቀሙ፣ focused repo knowledge dump ሲያስፈልግ። በመደበኛ session engram_start ወይም engram_smarter ይጠቀሙ።
engram_proof → Product/admin ጥቅም: memory counts፣ activation፣ usage እና benchmark proof ያሳያል። የመደበኛ coding flow አካል አይደለም።
የagent feedback protocol

የሰው form አትሙላ። Memory loopን አሰልጥን።

Memory ከረዳ፣ stale ከሆነ፣ ወይም wrong context ከመጣ tools በመጠቀም report አድርግ። ይህ signal future rankingን ያሻሽላል።

01Recalled memory ከተጠቀምክ በኋላ engram_report_outcome በsuccess true/false ጥራ።
02ብዙ memories ስራውን ካቀረጹ engram_reflect checkpoint አድርግ።
03ሌላ repo patternን አስቀድሞ ፈትቶ ሊሆን ከቻለ planning በፊት engram_cross_pollinate ጥራ።

ተሻጋሪ-ክፍለ ጊዜ ትምህርት

በክፍለ ጊዜ 1 ከባድ ስህተትን ታስተካክላለህ። ክፍለ ጊዜ 2፣ ተመሳሳይ ስህተት ቅርጸት በሌላ ፋይል ይታያል። ማስተካከያውን ወዲያውኑ ታስታውሳለህ።

የቡድን ዕውቀት ሽግግር

በፊት በኩል ያለ Cursor agent API snake_case እንደሚጠብቅ ያገኛል። በኋላ በኩል ያለ Claude Code agent ማንም ሳይነግረው ይህንን ይማራል።

የደንብ ማስፈጸም

ኮድ ከመጻፍ በፊት የፕሮጀክት ደንቦችን ታስታውሳለህ። "ለማረጋገጥ Zod ተጠቀም፣ Joi አይደለም።" የቡድን ደረጃውን በራስ ሰር ትከተላለህ።

ማስታወሻ፣ ወቅታዊነት እና ግብረመልስ

መሳሪያዎቹ እንዴት እንደሚሰሩ የሚያብራራ መመሪያ። የመለኪያ ሰንጠረዦች ከMCP schema ይዘጋጃሉ። የምላሽ ምሳሌዎች ሚስጥራዊ መረጃ የተወገደላቸው የHTTP ክፍሎች ናቸው። MCP በtext/format አማካይነት JSON፣ Markdown ወይም አጭር ማረጋገጫ ይመልሳል፤ ከመተንተንዎ በፊት format ይፈትሹ።

ለሚፈልጉት ሥራ ተገቢውን መሳሪያ ይምረጡ

በኮድ ማከማቻ ውስጥ ሥራ መጀመር

engram_start

የሥራ ክፍሉ መግለጫ እና ተዛማጅ ማስታወሻዎች

አንድ ግልጽ ጥያቄ መመለስ

engram_recall

ለጥያቄው ተስማምተው የተደረደሩ መረጃዎች

አውዱ እያለ ሥራ መቀየር

engram_smarter

ለአዲሱ ሥራ የተዘጋጀ ማጠቃለያ

አውድ ከጠፋ በኋላ መቀጠል

engram_rehydrate

ደህንነቱ የተጠበቀ የመዝገብ መመለስ እና የአሁን ማስታወሻ እገዛ

ጠቃሚ የሥራ ደረጃ መመዝገብ

engram_reflect

መቀጠያ ነጥብ ይቀመጣል፤ ክፍለ ጊዜው ክፍት ይቀራል

የnpm ፕሮግራም ያለ ኢሜይል ወይም API ቁልፍ የተለየ ነፃ ሙከራ ሊጀምር ይችላል። የርቀት OAuth ግንኙነቶች ኢሜይል ያረጋግጣሉ። የመግቢያ መረጃ አይፍጠሩ። repo በተፈቀደው የሥራ ክፍል ውስጥ ማጣሪያ ነው፤ ሌላ የሥራ ክፍል ለመግባት ፈቃድ አይደለም።

ሥራ ሲጀምሩ engram_start፣ ለአንድ ጥያቄ engram_recall፣ ሥራ ሲቀይሩ engram_smarter፣ አውድ ከተጠቃለለ ወይም ሥራ ከተቋረጠ በኋላ engram_rehydrate ይጠቀሙ። Smarter ለአዲሱ ሥራ ዘላቂ ማስታወሻ ይፈልጋል፣ የቀድሞውን መዝገብ ዳግም አይገነባም። ሁለቱም የክፍለ ጊዜ ክስተቶችን ሊመዘግቡ ይችላሉ። Rehydrate የተዘጋ ወይም የባልደረባ ታሪክ ማንበብ ይችላል፣ ግን ዳግም አይከፍተውም ወይም አይጽፍበትም። engram_reflect ክፍለ ጊዜውን ክፍት ይተዋል፤ engram_close_session በግልጽ ያጠናቅቀዋል።

የfocused መደበኛ ብዛቶች start=8፣ recall=5፣ smarter=5 እና cross_pollinate=5 ናቸው። ለdeep በቅደም ተከተል 16፣ 12፣ 12 እና 12 ናቸው። በግልጽ የተሰጠ limit ከመሳሪያው ከፍተኛ ገደብ ሳይበልጥ እነዚህን ይተካል። include_skills በግልጽ true ወይም false ካልሆነ፣ መመሪያዎች ከሥራው ቁልፍ ቃላት ይመረጣሉ።

Rehydrate የተለየ የመዝገብ ዝርዝር አለው፦ depth=brief እስከ 12 ክስተቶች እና 2 ማጠቃለያዎች፣ standard 30 እና 4፣ full 60 እና 8 ይመልሳል። limit ወይም የፍለጋ focused/deep እሴቶችን አይቀበልም።

recall የcount=0 ውጤት ከሰጠ፣ የሚዛመድ ማስታወሻ እንዳልተገኘ ይናገሩ። repo እና ጥያቄውን ይፈትሹ፤ ካስፈለገ ይቀይሩት ወይም depth=deep ይጠቀሙ። ብዙ ውጤቶች ያልተዛመደ መረጃን አግባብ ያለው አያደርጉትም። በሌላ ማከማቻ ሊጠቅም የሚችል ትምህርት ካለ ብለው ሲጠብቁ cross_pollinate ይጠቀሙ። get_context ለታሰበ የምድብ ምርመራ ነው፣ ከእያንዳንዱ ባዶ ፍለጋ በኋላ የሚጠራ አውቶማቲክ ደረጃ አይደለም።

ደንቦችን ከሚለወጡ እውነታዎች ይለዩ

በእያንዳንዱ ማስታወሻ ራሱን ችሎ የሚዘመን አንድ እውነታ ያስቀምጡ። የፈቃድ ደንብ እና የስርጭት ሁኔታ የተለዩ ID ሊኖራቸው ይገባል። ለአንድ ክፍል type፣ content እና አማራጭ claim ይጠቀሙ፤ ለ1–32 ገለልተኛ ክፍሎች claims ይጠቀሙ፣ እያንዳንዱ type፣ content እና claim ይኑረው። ሁለቱን ቅርጾች አይቀላቅሉ። ያልተመደቡ የቀድሞ መረጃዎች legacy_unassessed ይቀራሉ፤ metadata መጨመር ማስታወሻው አንድ እውነታ ብቻ እንዳለው አያረጋግጥም።

type እንደ CONVENTION ወይም SOLUTION ያለ የፍለጋ ምድብ ነው። claim.kind ደግሞ rule፣ decision፣ state፣ lesson እና reference ይለያል። stage ያለው state ብቻ ሲሆን proposed፣ implemented፣ tested ወይም deployed ይወስዳል። State የሰዓት ዞን ያለው ISO observed_at ይፈልጋል፤ ከሰርቨሩ ሰዓት ከአንድ ደቂቃ በላይ ወደፊት ሊሆን አይችልም። UTC እና ግልጽ የሰዓት ልዩነቶች ይፈቀዳሉ፤ የፕሮግራሙን ሰዓት ያስተካክሉ። tested/deployed ለevidence ማስረጃ ይፈልጋሉ። ማስረጃውን ወኪሉ ይሰጣል፣ Engram በተናጠል አያረጋግጠውም። review_after አማራጭ ነው፣ ከobserved_at በፊት ሊሆን አይችልም። የግምገማ ቀን እንጂ አውቶማቲክ ማብቂያ ወይም ደንብ ለማስወገድ ፈቃድ አይደለም።

kind=rule የሰው ሥልጣን አይሰጥም ወይም የአሁኑን መመሪያ አይሽርም። supersedes_memory_ids እና change_reason ለተረጋገጠ መተካት ብቻ ይጠቀሙ። የቀድሞ ማስታወሻን ለመከፋፈል memory_id እና content_sha256 ያለው split_from ይጠቀሙ፤ በመደበኛነት ቅድመ እይታ ብቻ ነው። dry_run=false እና የተመለሰው split:<id>:<plan_hash> ማረጋገጫ ሲኖር ብቻ ይተግብሩ። ታሪካዊ ክፍሎች ታሪካዊ ይቀራሉ፤ የቀድሞ ስኬት ድምጾችን ላልተዛመዱ አዲስ እውነታዎች አያውርሱ።

ምሳሌ፦ የምሳሌ ቦታ ያዢዎችን በእውነት በተመለሱት እሴቶች ይቀይሩ።

{
  "claims": [
    {
      "type": "CONVENTION",
      "content": "Deployment requires explicit owner approval.",
      "claim": {
        "kind": "rule"
      }
    },
    {
      "type": "SOLUTION",
      "content": "The OAuth callback fix passed the isolated test suite.",
      "claim": {
        "kind": "state",
        "stage": "tested",
        "observed_at": "2026-11-15T09:00:00Z",
        "evidence": "Commit abc1234; isolated OAuth regression receipt"
      }
    }
  ]
}
የተቀላቀለ የቀድሞ ማስታወሻን ሲገመግሙ ትክክለኛውን ደንብ ያቆዩ

ማስታወሻ ትክክለኛ የፈቃድ ደንብን እና ያረጀ የስርጭት ሁኔታን ከቀላቀለ፣ ሁኔታውን ለመደበቅ ብቻ ሁሉንም ከአጠቃቀም አያውጡ። ራሱን የቻለ እያንዳንዱን እውነታ በቅድሚያ ይገምግሙ። በሚቀርበው claims ውስጥ ደንቡ ንቁ ይቆይ፣ ያረጀው ክፍል ብቻ ታሪካዊ ይሁን። መከፋፈል የሚችለው ጸሐፊው ወይም ሰው የሆነ ባለቤት ነው፤ ምንጩ የግል፣ ንቁ እና ገና claim ተብሎ ያልተወሰነ መሆን አለበት።

ለቅድመ እይታ claims እና split_from አብረው ይላኩ። content_sha256 ከተቀመጠው የምንጭ ጽሑፍ በትክክል ያስሉ፣ ከተጠቃለለ እይታ ወይም ከዳግም አጻጻፍ አይውሰዱ። ቅድመ እይታ ማስታወሻ አይጽፍም። ከመተግበርዎ በፊት claims፣ active_claims እና historical_claims ይመልከቱ። ከታች ያለው የMCP SDK አብነት ኮድ ነው፦ source እውነተኛ ምንጭ ነው፣ claims የገመገሙት ዝርዝር ነው፤ historical:true ለያረጁ ክፍሎች ብቻ ነው።

ያልተለወጠውን ምንጭ እና ዕቅድ dry_run=false እና ከቅድመ እይታው የተገኘውን confirmation በትክክል በመቅዳት ዳግም ይላኩ። ማረጋገጫን ራስዎ አይፍጠሩ። ምንጭ ወይም ዕቅድ ከተቀየረ አዲስ ቅድመ እይታ ይጠይቁ። ዋናው ማስታወሻ በታሪክ ይቀራል፣ አዲሱም ክፍሎች የቀድሞ ድምጽ ሳይወርሱ የየራሳቸው ID ያገኛሉ። ቅድመ እይታው የጽሕፈት ቅርጹን እንጂ የግምገማዎን እውነት አያረጋግጥም።

ምሳሌ፦ የምሳሌ ቦታ ያዢዎችን በእውነት በተመለሱት እሴቶች ይቀይሩ።

const plan = {
  split_from: {
    memory_id: source.id,
    content_sha256: sha256(source.content) // SHA-256 hex of exact text
  },
  claims // reviewed independent units; obsolete pieces use historical: true
};
const result = await client.callTool({ name: "engram_store", arguments: plan });
if (result.isError) throw new Error("Split preview failed");
if (result.structuredContent?.format !== "json") throw new Error("Expected JSON preview");
const preview = JSON.parse(result.structuredContent.text);
// Review preview.claims, active_claims and historical_claims before applying.
await client.callTool({
  name: "engram_store",
  arguments: { ...plan, dry_run: false, confirmation: preview.confirmation }
});
ጠቃሚ መሆን የተረጋገጠ ወይም ወቅታዊ መሆን አይደለም

success=true ማለት ማስታወሻው ለሥራው ጠቅሟል ማለት ነው። አሁን እውነት መሆኑን፣ በቀጥታ ሥራ ላይ ያለ ስርዓት ውስጥ መሠራቱን ወይም የቀድሞ የተቀላቀለ ማስታወሻ እያንዳንዱ ዓረፍተ ነገር ትክክል መሆኑን አያሳይም። trust=validated እና confidence ለተነገረ ጠቃሚነት የተኳሃኝነት መለያዎች እንጂ ገለልተኛ ማረጋገጫ አይደሉም። claim.stage፣ observed_at፣ evidence እና last_outdated_report_at ያንብቡ፤ ወሳኝ እውነታዎችን በአሁኑ ኮድ እና በሚሠራው ስርዓት ያረጋግጡ።

የመጀመሪያ ተዛማጅነት relevant፣ irrelevant ወይም uncertain ሊሆን ይችላል። የእውነተኛ አጠቃቀም ጥቅም helpful፣ unhelpful፣ not_used ወይም not_evaluated ነው። ድምጽ የሚፈጥሩት እና confidence የሚቀይሩት helpful/unhelpful ብቻ ናቸው። irrelevant እና not_used በአንድ ላይ ሲሆኑ የአጠቃቀም ውድቀት ድምጽ አይፈጥሩም። ግብረመልስ ከሌለ ያልተገመገመ ይቀራል። የተዛማጅነት ማብራሪያ እና የአጠቃቀም ማስረጃ ተለይተው ይቀመጣሉ።

በengram_reflect.feedback ወይም POST /api/v1/feedback የሚላኩ useful/noisy/stale/missing_context/too_long ምልክቶች የEngram ምርትን ራሱን ይገመግማሉ። ከእያንዳንዱ ማስታወሻ የአጠቃቀም ውጤት የተለዩ ናቸው፣ የዚያንም confidence አይቀይሩም።

ግብረመልስን ከትክክለኛው ፍለጋ ጋር ያያይዙ፣ ድግግሞሽንም ይለዩ

retrieval_id የተመዘገበ የውጤት ዝርዝር ማሳያን ይለያል፤ session_id ደግሞ መዝገብን ይለያል። በተለይ አንድ ማስታወሻ በትይዩ ጥያቄዎች ሲመጣ እያንዳንዱን retrieval_id ከዝርዝሩ ጋር ያቆዩ። null ለዚያ ምላሽ ትክክለኛ ግንኙነት እንደሌለ ያሳያል። ማረጋገጫ፣ ማስታወሻ እና ጠሪው የመድረስ ፈቃድ እስካላቸው ድረስ የቀድሞ ወይም የተዘጋ ምንጭ ግልጽ ግብረመልስ ሊቀበል ይችላል። የምንጩን ክፍለ ጊዜ ዳግም አይክፈቱ።

ለአንድ እውነተኛ አጠቃቀም engram_report_outcome ከmemory_id፣ success እና retrieval_id ጋር ይጥሩ። እስከ 20 ልዩ የፍለጋ/ማስታወሻ ጥንዶች በoutcomes ይላኩ። እነዚህን በሚቀጥለው start፣ recall፣ smarter፣ store፣ reflect፣ cross_pollinate፣ get_context፣ skill ወይም report_outcome ውስጥ pending_feedback አድርገው ማካተትም ይችላሉ። outcome:write ያስፈልጋል፣ ተጨማሪ የጥሪ ድርሻ ግን አይወስድም። የማይገመግሙትን ከማስመሰል ይልቅ ይተዉት።

ትክክለኛ ሪፖርትን ሲደግሙ ተመሳሳይ retrieval_id፣ memory_id እና የአጠቃቀም መስኮች ይላኩ። Engram በምላሹ duplicate=true ብሎ ያረጋግጣል፣ አዲስ ድምጽ አይጨምርም። duplicate ግቤት አይደለም፣ retry የሚባል ማብሪያም የለም። ተመሳሳይ ድግግሞሽ 409 ስህተት አይደለም፤ አስቀድሞ የተቀመጠ ድምጽ መቀየር 409 ይመልሳል። retrieval_id የሌለው የቀድሞ ቅርጽ፣ ለተረጋገጠው አባል እና የሥራ ክፍል ባለፉት 24 ሰዓታት ያንን ማስታወሻ ያሳየውን የቅርብ ጊዜ ማሳያ ይመርጣል። session_id ካለ ፍለጋው በዚያ መዝገብ ይገደባል። የቀድሞ ቅርጽ ድግግሞሽ ድምጽ ሊጨምር ይችላል፤ ግምታዊ ግንኙነትን ትክክለኛ አትበሉት። እውነተኛ አዲስ አጠቃቀም አዲስ ማሳያ ይፈልጋል።

የግብረመልስ ቡድን ከዋናው ተግባር በፊት ይቀመጣል። ተግባሩ ቢሳካም ባይሳካም feedback_receipt ይፈትሹ፤ ግብረመልሱ ተቀምጦ ሊሆን ይችላል። የርቀት MCP እና npm ፕሮግራም በስህተትም ማረጋገጫውን ያቆያሉ። ግብረመልስ ከተቀመጠ በኋላ የሚመጣ ስህተት በራሱ አይደገምም፤ ዋናው ተግባር ግን ድጋሚ ሲሠራ ተጨማሪ ተጽዕኖ ሊኖረው ይችላል። በreflect.used_memories ውስጥ እስከ 20 ያሉ ትክክለኛ እና አንድ ላይ የሚቀመጡ ክፍሎች ሁሉ retrieval_id ይኑራቸው። የቀድሞ ቅርጽ በሌላ reflect ይሁን። በኋላ ትምህርት ወይም መቀጠያ መጻፍ ቢሳንም feedback_receipt የተቀበሉ ውጤቶችን ያሳያል።

ምሳሌ፦ የምሳሌ ቦታ ያዢዎችን በእውነት በተመለሱት እሴቶች ይቀይሩ።

{
  "repo": "example",
  "query": "Which deployment rule applies?",
  "pending_feedback": [
    {
      "retrieval_id": "<id from the previous result list>",
      "memory_id": "<memory in that list>",
      "relevance": "irrelevant",
      "usefulness": "not_used"
    }
  ]
}

የሚመከር፦ ከትክክለኛው ፍለጋ ጋር የተያያዙ የአጠቃቀም ውጤቶች (የengram_reflect መለኪያዎች)

{
  "store": false,
  "summary": "Applied the recalled approval rule.",
  "used_memories": [
    {
      "retrieval_id": "<id from that result list>",
      "memory_id": "<memory in that list>",
      "success": true,
      "detail": "Checked owner approval before releasing."
    }
  ]
}

ለተኳሃኝነት ብቻ፦ በቀድሞው ቅርጽ የተለየ ሪፖርት (የengram_reflect መለኪያዎች)

{
  "store": false,
  "summary": "Reported a use without a retained query receipt.",
  "used_memories": [
    {
      "memory_id": "<accessible memory id>",
      "success": true,
      "detail": "This use has inferred attribution, not an exact query link."
    }
  ]
}
ከአጠቃቀም ማውጣት፣ ሙሉ ስረዛ እና ደህንነቱ የተጠበቀ መመለስ

engram_retract_memory የግል ዕውቀትን መመለስ በሚቻል ሁኔታ ከአጠቃቀም ያወጣል፤ ፈጣሪው ወይም ሰው የሆነ የሥራ ክፍል ባለቤት ሊያደርገው ይችላል። engram_restore_memory የተወገደ ነገር ግን ገና የተቀመጠ መዝገብ ይፈልጋል፣ ድርሻ እና የተረጋገጠ መተካትንም ይፈትሻል። ተመሳሳይ ጽሑፍ መቀመጥ ወይም rehydrate መጥራት በዝምታ አይመልሰውም። ሙሉ በሙሉ የተሰረዘ መዝገብ መመለስ አይቻልም።

የOAuth token አባሉ OWNER ቢሆንም ቋሚ ስረዛን ማየት ወይም መፈጸም አይችልም። ሁለቱም ሰው የሆነ የሥራ ክፍል ባለቤት የሚጠቀምበትን የተለየ የAPI ማረጋገጫ መንገድ ይፈልጋሉ። የOAuth ገደብን ለማለፍ የባለቤቱን ቁልፍ አይውሰዱ ወይም አይተኩ። engram_delete_memory በመደበኛነት ተጽዕኖውን ያሳያል፤ ለመፈጸም dry_run=false እና confirmation=delete:<exact memory_id> ብቻ ይጠቀሙ። ሕያው ማስታወሻውን፣ የታወቁ ተያያዥ ቅጂዎችን እና የተጎዱ መዝገቦችን ነጻ ጽሑፍ ይሰርዛል። ለፕሮግራሞች ቀድሞ የተላከ አውድ፣ ራሳቸውን የቻሉ መዝገቦች፣ ያልተያያዙ ዳግም አጻጻፎች፣ አቅራቢዎች እና መጠባበቂያ ቅጂዎች በዚህ የተወሰነ ስረዛ ውስጥ አይካተቱም።

የክፍለ ጊዜ ፍለጋ ከአጠቃቀም ከወጣ፣ ጊዜው ካለፈ ወይም ከተሰረዘ ዕውቀት ጋር የተያያዘ የሥራ ጽሑፍ ይደብቃል። መዝገቡ በደህና ሊገነባ ካልቻለ፣ የአሁኑን ደህንነቱ የተጠበቀ ማስታወሻ ይጠቀሙ ወይም በengram_start(new_session=true) አዲስ መዝገብ ይክፈቱ፤ መደበቁን አያልፉ። የተቀመጠ ምንጭ ዳግም ሲመለስ ደህንነቱ የተጠበቀ ታሪኩም እንደገና ሊገኝ ይችላል።

API ማጣቀሻ

ለሁሉም 17 MCP መሳሪያዎች ሙሉ ሰነድ።

engram_start

በኮድ ማከማቻ ሥራ ይጀምሩ። በጠቃሚ ክፍለ ጊዜ መጀመሪያ፤ የጠፋ አውድን በrehydrate ያግኙ። የሥራ ክፍል መግለጫ፣ የክፍለ ጊዜ ID እና ተዛማጅ ማስታወሻ።

{
"agent_tool": "codex",
"project": "English.cash",
"repo": "english.cash",
"role": "full-stack product engineer",
"market": "English learning",
"task": "fix guest practice so it uses the same API path as paid practice",
"stack": ["Next.js", "TypeScript", "PostgreSQL", "LLM router"]
}
engram_rehydrate

አውድ ከጠፋ በኋላ ይቀጥሉ። ከመጠቃለል፣ ከአጭር ማጠቃለያ ወይም ከመቋረጥ በኋላ ከመቀጠልዎ በፊት። ደህንነቱ የተጠበቀ መቀጠያ፣ ውሳኔ እና ቀሪ ሥራ። የተዘጋ ታሪክ አይከፍትም።

{
"agent_tool": "codex",
"project": "Engram",
"repo": "engram",
"task": "continue mobile Safari chat fix after context compaction",
"reason": "chat was compacted and only a short summary remains",
"depth": "standard"
}
engram_smarter

ወደ አዲሱ ሥራ ዳግም ያተኩሩ። በዚያው ንቁ ክፍለ ጊዜ፤ የጠፋ መዝገብ አይገነባም። ለአዲሱ ሥራ የሚጠቅሙ ማስታወሻዎች እና መመሪያዎች።

{
"context": "Next.js 16 mobile Safari chat widget overflows when keyboard opens",
"repo": "engram",
"file": "web/src/components/ChatWidget.tsx",
"include_skills": true
}
engram_cross_pollinate

ከሌሎች ማከማቻዎች ትምህርት ይውሰዱ። ሌላ ፕሮጀክት ተመሳሳይ ችግር ፈትቶ ሊሆን ሲችል። ምንጭ እና ተግባራዊነት ያለው ትምህርት፤ የአሁኑ ማከማቻ ከምንጮች ይወጣል።

{
"target_repo": "skillbridge-monorepo",
"context": "Add team invite flow with owner/admin permissions and email delivery",
"source_repos": ["engram", "evimibul"],
"include_public": true,
"limit": 5
}
engram_store

ራሱን ችሎ የሚጠበቅ ዕውቀት ያስቀምጡ። ዘላቂ ትምህርት ከተረጋገጠ በኋላ፤ ደንብን ከጊዜያዊ ሁኔታ አይቀላቅሉ። አንድ ID ወይም ለclaims የተለዩ ID። የቀድሞ ክፍፍል በቅድመ እይታ ይጀምራል።

{
"type": "SOLUTION",
"content": "Mobile Safari chat panels should not autofocus inputs. Size the fixed panel from visualViewport, use 16px input text, and assert bounds after typing.",
"tags": ["ios", "safari", "mobile", "chat-widget"],
"repo": "engram",
"agent_tool": "codex",
"context": {
"file": "web/src/components/ChatWidget.tsx",
"platform": "ios-safari"
}
}
engram_recall

ከውሳኔ በፊት ግልጽ መልስ ይፈልጉ። ለአንድ ጥያቄ፣ የቀድሞ ውሳኔ ወይም ስህተት። የተደረደሩ ማስታወሻዎች እና ካለ retrieval_id። ምንም ካልተገኘ በግልጽ ይናገሩ።

{
"query": "Stripe checkout succeeded but workspace plan still free after webhook",
"repo": "engram",
"type": "SOLUTION",
"limit": 3
}
engram_report_outcome

ማስታወሻው እንደጠቀመ ይግለጹ። ከእውነተኛ አጠቃቀም በኋላ በretrieval_id ያያይዙ። አለመዛመድ ያልተሳካ አጠቃቀም አይደለም። ትክክለኛ ድግግሞሽ ድምጽ አይጨምርም፣ መቀየር 409 ይሰጣል። ቀድሞው ቅርጽ በ24 ሰዓት ይገምታል እና ድምጽ ሊጨምር ይችላል።

{
"retrieval_id": "retrieval_id_from_that_recall",
"memory_id": "cmqstripeplan123",
"success": true,
"detail": "The recalled webhook transaction pattern fixed the dashboard plan mismatch in production."
}
engram_reflect

የሥራ መቀጠያ ነጥብ ይመዝግቡ። ከጠቃሚ ደረጃ፣ ከብዙ አጠቃቀም ወይም ከርክክብ በፊት፤ በጊዜ ቆጣሪ አይደለም። ትምህርት፣ ውጤት እና መቀጠያ። store=false ሁሉንም ጽሕፈት አያቆምም፤ ክፍለ ጊዜው ክፍት ይቀራል።

{
"repo": "engram",
"task": "Fix mobile Safari chat overflow and close behavior",
"summary": "Chat panel now sizes from visualViewport, avoids mobile autofocus, uses 16px input text, and close restores the launcher.",
"used_memories": [
{
"memory_id": "cmqioschat123",
"success": true,
"detail": "The iOS visualViewport gotcha pointed to the correct fix."
}
],
"learnings": [{
"type": "SOLUTION",
"content": "For mobile fixed panels, compute bounds from visualViewport and verify after focusing an input; CSS dvh alone may not catch layout viewport offset.",
"tags": ["mobile", "safari", "visualViewport"]
}]
}
engram_get_context

ማስታወሻን በምድብ ይመርምሩ። ለታሰበ ግምገማ ወይም ስህተት ፍለጋ፣ ከእያንዳንዱ ባዶ ፍለጋ በኋላ አይደለም። ተዛማጅ ምድቦች። repo ካልተዛመደ ፍለጋው ሊሰፋ ይችላል።

{
"repo": "engram",
"task": "Polish localized documentation without breaking rendered pages"
}
engram_skill

ደረጃ በደረጃ መመሪያ ይጫኑ። ለሚደገም ሂደት፣ ለአንድ የፕሮጀክት እውነታ አይደለም። ደረጃዎች ወይም ያሉ ስሞች። ያልታወቀ count=0 ይመልሳል፣ ምንም አይጭንም ወይም አያስኪድም።

{
"skill": "security-audit"
}
engram_proof

የሥራ ክፍሉን አጠቃቀም ማስረጃ ይመልከቱ። ለምርት ወይም ለአስተዳደር ግምገማ፣ ለመደበኛ ኮድ ሥራ አያስፈልግም። የማስታወሻ፣ አጠቃቀም፣ ማንቃት እና የንጽጽር ሙከራ ማስረጃ።

engram_proof()
engram_setup

የቅንብር እና የግንኙነት መመሪያ ያግኙ። ግንኙነቱን ለመረዳት። ዕለታዊ ሥራ በstart ይጀምሩ። የሥራ ክፍል፣ መሳሪያዎች እና ቀጣዩ ጠቃሚ እርምጃ።

{
"agent_tool": "claude-code"
}
engram_list_sessions

ትክክለኛውን የክፍለ ጊዜ መዝገብ ያግኙ። ብዙ ክፍለ ጊዜዎች ሲጣጣሙ፤ workspace የጋራ metadata ያሳያል። በገጽ የተከፋፈለ metadata እና next_cursor። ከተወገደ ዕውቀት ጋር የተያያዘ ሥራ ይደበቃል።

{ "repo": "engram", "scope": "mine", "limit": 20 }
engram_close_session

አንድ የተወሰነ ክፍለ ጊዜ ያጠናቅቁ። በመጨረሻ ወይም በርክክብ ጊዜ አማራጭ ነው፤ ባለቤትነት እና session:write ይፈልጋል። መቀጠያ እና መዝጋት በአንድ ይፈጸማሉ። ድግግሞሽ ተመሳሳይ ማረጋገጫ ይሰጣል፤ ማስታወሻ እና ለንባብ ብቻ የሆነ ታሪክ ይጠበቃሉ።

{ "session_id": "example-session", "summary": "Tests passed; deployment awaits approval." }
engram_retract_memory

የግል ዕውቀትን መመለስ በሚቻል ሁኔታ ከአጠቃቀም ያውጡ። ፈጣሪው ወይም ሰው ባለቤት በmemory:write ያልተገባ መመሪያ ሲያስወግድ። ይዘቱ ይቆያል፣ ፍለጋ፣ ጥገኛ ቅጦች እና ተያያዥ መዝገቦች ይደበቃሉ። ድግግሞሽ ተጨማሪ ተጽዕኖ የለውም።

{ "memory_id": "example-memory", "reason": "This advice needs revalidation." }
engram_restore_memory

የተወገደ ማስታወሻን ከገመገሙ በኋላ ያንቁ። ፈጣሪ ወይም ሰው ባለቤት፤ ድርሻ እና መተካት ይፈተሻሉ። ዋናው ID እና ጽሑፍ ይቆያሉ። ንቁ አይቀየርም፣ የተሰረዘ አይመለስም። Store መመለስን አይተካም።

{ "memory_id": "example-memory" }
engram_delete_memory

ቋሚ ስረዛን ይመልከቱና ይፈጽሙ። ቅድመ እይታም የሰው OWNER API ማረጋገጫ ይፈልጋል፣ OAuth አይፈቀድም። መፈጸም ትክክለኛ confirmation ይፈልጋል። ሕያው ማስታወሻ፣ የታወቁ ውጤት ቅጂዎች እና የተጎዱ መዝገቦች ጽሑፍ ይሰረዛሉ፤ አነስተኛ ማረጋገጫ ይቀራል። ራሱን የቻለ መዝገብ፣ ያልተያያዘ ዳግም ጽሕፈት፣ የፕሮግራም አውድ፣ መጠባበቂያ እና አቅራቢ አይካተቱም።

{ "memory_id": "example-memory", "dry_run": true }

የማህደረ ትውስታ ዓይነቶች

CONVENTION

የኮድ ደረጃዎች እና የቡድን ደንቦች

"Always use Prisma migrations"

PATTERN

ተደጋጋሚ ዘዴዎች እና አብነቶች

"API routes use cached() wrapper"

GOTCHA

የሚሰበሩ ወይም የሚያስደንቁ ነገሮች

"Neon requires SSL in production"

SOLUTION

ያሠሩ ማስተካከያዎች

"Fix: add pooler to connection string"

ARCHITECTURE

የስርዓት ንድፍ ውሳኔዎች

"Search uses Haversine + bbox"

DEPENDENCY

የቤተ-መጽሐፍት መረጃ እና ስሪቶች

"Prisma 7 needs adapter pattern"

// በማሽን ሊነበብ የሚችል endpoint

GET https://engram.tools/api/v1/capabilities

የሚደገፉ መሳሪያዎችን፣ የማህደረ ትውስታ ዓይነቶችን፣ የፍጥነት ገደቦችን እና ዋጋን የያዘ JSON ይመልሳል - ለፕሮግራም ፍጆታ ተነድፏል።

ድጋፍ እና አስተያየት

Engramን እንድናሻሽል ይርዱን

Setup ካስቸገረ፣ tool በልዩ ሁኔታ ካሰራ፣ ወይም pricing limit ትክክል ካልመሰለ እዚህ ይጻፉ። Message በቀጥታ ወደ እኛ ይመጣል።

ድጋፍ እና አስተያየት

ምን እናሻሽል?

Bugs, confusing setup steps, pricing questions እና product ideas በቀጥታ ወደ Engram team ይደርሳሉ።

አስተያየትዎ ወደ ቡድናችን ከመድረሱ በፊት ኢሜይልዎን ያረጋግጡ። ይህ መለያ አይፈጥርም።

10 ቁምፊዎች ያስፈልጋሉ0/4000