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

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

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

ፈጣን ማዋቀር

# 1. በAPI key በterminal አንድ ጊዜ አስኪድ
npx -y engram-tools@latest --setup engram_...

# 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 ጥራ።
ከአስፈላጊ ደረጃ በኋላ፣ ተግባር ሲቀየር፣ ብዙ memories ከተጠቀሙ በኋላ፣ ወይም ከhandoff በፊት engram_reflectን እንደ checkpoint ይጠቀሙ።

ለመሳሪያዎ ማዋቀር

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"],
      "env": {
        "ENGRAM_API_KEY": "engram_..."
      }
    }
  }
}

የagent መዳረሻ

Agent Engram መግዛት ይችላል?

አዎ፣ email እና payment መከናወን ከቻለ። ተመሳሳይ checkout ይጠቀማል፣ workspace ይፈጥራል፣ API keyውን ይጠቀማል። ካልሆነ human owner ይመዘገባል፣ teammatesን ይጋብዛል፣ ለእያንዳንዱ agent member key ይሰጣል።

Pricing ክፈት የሰው setup ፍሰት

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

engram_start → በአዲስ session የመጀመሪያ call። setup guidance እና smart context በአንድ ይጭናል።

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 አካል አይደለም።

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

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

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

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

የደንብ ማስፈጸም

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

ከEngram ጋር የመጀመሪያ ክፍለ ጊዜዎ

ለመጀመሪያ ጊዜ ሲገናኙ ምን እንደሚሆን።

ሰውዎ Engram ን ወደ MCP ውቅርዎ ይጨምራል።

engram_start, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context እና engram_setup ያገኛሉ።

መጀመሪያ project, repo, role, market, stack, task ጋር engram_start ጥራ።

Engram በአንድ call ተገቢውን team knowledge እና skill guides ይጭናል።

በተለመደው ይሥሩ። አስፈላጊ ነገር ሲያገኙ ያስቀምጡ። ለመወሰን ሲያስፈልግ ያስታውሱ።

engram_reflectን እንደ milestone checkpoint ይጠቀሙ፤ ከአስፈላጊ ደረጃ በኋላ፣ ተግባር ሲቀየር፣ ብዙ memories ከተጠቀሙ በኋላ፣ ወይም ከhandoff በፊት። Timer አይደለም።

API ማጣቀሻ

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

engram_start

እያንዳንዱን session በአንድ call እና ትክክለኛ memory ይጀምራል።

{
  "agent_tool": "codex",
  "project": "HouseCompass",
  "repo": "housecompass.uk",
  "role": "frontend product engineer",
  "market": "UK property",
  "task": "build listing detail page",
  "stack": ["Next.js", "TypeScript", "PostgreSQL"]
}

engram_smarter

task ሲቀየር focused context ይጭናል።

{
  "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

ከworkspace ውስጥ ሌሎች repos lessons ይጠቀማል።

{
  "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

rule, gotcha, pattern ወይም solution ያስቀምጣል።

{
  "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

decision በፊት useful memories recall ያደርጋል።

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

engram_report_outcome

memory እንደረዳ ይዘግባል እና ranking ያሻሽላል።

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

engram_reflect

session መጨረሻ used memories እና learnings ይዘግባል።

{
  "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 relevant memory ይጭናል።

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

engram_skill

ለcomplex task ሙሉ skill guide ይጭናል።

{
  "skill": "security-audit"
}

engram_proof

product proof ያሳያል: memory, usage, activation እና benchmark።

engram_proof()

engram_setup

workspace info, available tools እና best practices ያሳያል።

{
  "agent_tool": "claude-code"
}

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

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 ይመልሳል - ለፕሮግራም ፍጆታ ተነድፏል።

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

ለመሳሪያዎ ማዋቀር

Agent Engram መግዛት ይችላል?

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

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

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

የደንብ ማስፈጸም

ከEngram ጋር የመጀመሪያ ክፍለ ጊዜዎ

API ማጣቀሻ

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

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

ምን እናሻሽል?

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

ለመሳሪያዎ ማዋቀር

Agent Engram መግዛት ይችላል?

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

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

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

የደንብ ማስፈጸም

ከEngram ጋር የመጀመሪያ ክፍለ ጊዜዎ

API ማጣቀሻ

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

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

ምን እናሻሽል?

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