nirvana context engineering
Squad de engenharia de contexto para agentes de IA: elicitação de requisitos, análise do projeto, design de arquitetura de contexto, geração de artefatos (CLAUDE.md, AGENTS.md, rules, configs de memória) e otimização com validação de qualidade. Pipeline de 5 fases que aplica as 5 abordagens de context engineering (RAG, ACE, Hierarchical Layering, GCC, Structured Files).
🧠 فريق هندسة السياق (Context Engineering Squad)
هندسة سياق احترافية لأنظمة الذكاء الاصطناعي — تصميم وتوليد وتحسين مصنّفات السياق (CLAUDE.md، والقواعد، وذاكرة الوكلاء) باستخدام أفضل ممارسات عام 2026.
المؤلف: Luiz Gustavo Vieira Rodrigues (@gutomec)
جدول المحتويات
- نظرة عامة
- التثبيت
- خط الأنابيب
- الوكلاء
- المهام
- سير العمل
- مناهج هندسة السياق
- أفضل الممارسات 2026
- المصنّفات المُولَّدة
- الاستخدام
- المساهمة
- الرخصة
نظرة عامة
Context Engineering Squad هو فريق متخصص في AIOS يُطبّق أحدث منهجيات هندسة السياق للمشاريع المبنية على الذكاء الاصطناعي. على خلاف "هندسة التوجيهات" البسيطة، تقوم هندسة السياق بتصميم أنظمة معلومات متكاملة توجّه نماذج اللغة بدقة واتساق وكفاءة عبر دورة التطوير كاملة.
يُنسّق هذا الفريق خمسة وكلاء متخصصين عبر خط أنابيب منظّم من خمس مراحل، بدءاً من جمع المتطلبات وصولاً إلى التحقق من جودة السياق المُولَّد.
ما الذي يفعله هذا الفريق؟
- إنشاء وصيانة ملفات
CLAUDE.mdمحسّنة للمشاريع - تصميم معماريات سياق هرمية وقابلة للتوسع
- توليد قواعد سياقية في
.claude/rules/
- إعداد ذاكرة دائمة لوكلاء الذكاء الاصطناعي
- تحسين استهلاك الرموز (tokens) دون فقدان المعلومات الجوهرية
- التحقق من جودة واتساق السياق المُولَّد
التثبيت
npx squads add gutomec/squads-sh/nirvana-context-engineeringالمتطلبات:
- AIOS Core 2.1 أو أحدث
- Node.js 18+
خط الأنابيب
يُنفّذ الفريق خط أنابيب خطياً من خمس مراحل، حيث يُسلّم كل وكيل متخصص مصنّفاته إلى الوكيل التالي:
الوكلاء
| الوكيل | الدور | النوع | الوصف |
|---|---|---|---|
| 🎯 Interviewer | Guardian | حارس المتطلبات | يُجري مقابلات منظّمة لاستخلاص متطلبات السياق. يُحدّد الأهداف والقيود واحتياجات الوكلاء. |
| 🔬 Scanner | Guardian | حارس التحليل | يُحلّل المشروع القائم بحثاً عن الأنماط والتبعيات وثغرات السياق. يُولّد خريطة شاملة للحالة الراهنة. |
| 🏗️ Architect | Builder | بنّاء المعمارية | يُصمّم معمارية السياق المثلى استناداً إلى المتطلبات والتحليل. يختار المناهج ويُحدّد هيكل المصنّفات. |
| ⚡ Generator | Builder | منشئ المصنّفات | يُولّد جميع مصنّفات السياق وفق المعمارية المُحدّدة: CLAUDE.md والقواعد وإعدادات الذاكرة. |
| 🔧 Optimizer | Balancer | مُحسِّن الجودة | يُراجع المصنّفات المُولَّدة ويُحسّنها ويتحقق منها. يُوازن بين الاكتمال وكفاءة الرموز ويضمن الاتساق الكلي. |
المهام
| المهمة | الوكيل | الوصف |
|---|---|---|
gatherRequirements() | Interviewer | جمع متطلبات السياق عبر مقابلات منظّمة. يُنتج requirements.json يتضمن الأهداف والقيود والاحتياجات المُحدَّدة. |
scanProject() | Scanner | مسح المشروع بحثاً عن الملفات الموجودة وأنماط الكود وثغرات السياق. يُنتج project-scan.json. |
designContextArchitecture() | Architect | تصميم معمارية السياق عبر اختيار المناهج الملائمة وتحديد هيكل المصنّفات. يُنتج context-architecture.md. |
generateContextArtifacts() | Generator | توليد جميع مصنّفات السياق المُحدَّدة في المعمارية: CLAUDE.md والقواعد وذاكرة الوكلاء. |
optimizeContext() | Optimizer | تحسين المصنّفات المُولَّدة لرفع كفاءة الرموز والوضوح والاتساق. |
validateContextQuality() | Optimizer | التحقق من جودة السياق وفق معايير الاكتمال والدقة وقابلية الاستخدام. |
سير العمل
context_engineering_pipeline (5 مراحل)
خط أنابيب متكامل لهندسة السياق في المشاريع الجديدة أو تلك التي تحتاج إلى معمارية سياق من الصفر.
المرحلة 1 — الجمع: يُجري Interviewer جلسات منظّمة لفهم المشروع وحزمة التقنيات والوكلاء المعنيين والاحتياجات الخاصة بالسياق.
المرحلة 2 — التحليل: يفحص Scanner المستودع ويُحدّد ملفات الإعداد الموجودة ويُحلّل أنماط الكود ويكتشف الثغرات أو التناقضات في السياق الحالي.
المرحلة 3 — التصميم: يُجمّع Architect المعلومات المُجمَّعة ويُصمّم معمارية سياق متماسكة باختيار المناهج الأنسب للمشروع.
المرحلة 4 — التوليد: يُنتج Generator جميع المصنّفات المُحدَّدة في المعمارية وفق أفضل الممارسات ومعايير المشروع.
المرحلة 5 — التحسين والتحقق: يُراجع Optimizer كل مصنّف ويُحسّن استهلاك الرموز ويضمن الاتساق بين المصنّفات ويتحقق من الجودة النهائية.
context_optimization_cycle (تكراري)
دورة تحسين مستمرة للمشاريع ذات السياق القائم. مثالية للصيانة والتحسين التدريجي.
التدفق: Scan → Detect Issues → Optimize → Validate → Loop (حتى التقارب)
مناهج هندسة السياق
يُطبّق الفريق خمسة مناهج معترفاً بها في الصناعة، تُختار وفق خصائص كل مشروع:
1. RAG (Retrieval-Augmented Generation)
استرجاع ديناميكي للسياق ذي الصلة في وقت التشغيل. مثالي للمشاريع ذات قواعد معرفية ضخمة أو توثيق موسّع لا يمكن احتواؤه في السياق الثابت.
2. ACE (Agentic Context Engineering)
تصميم سياق مخصص لأنظمة متعددة الوكلاء. تدير الوكلاء وتُحدّث سياقها الخاص باستقلالية، مما يُتيح التكيّف الديناميكي أثناء التنفيذ.
3. Hierarchical Layering (التطبيق الهرمي)
تنظيم السياق في طبقات: عام → مشروع → نطاق → مهمة. كل طبقة ترث وتُخصّص سياق الطبقة الأعلى، مما يُقلّل التكرار ويُسهّل الصيانة.
4. GCC (Git Context Controller)
تحكّم بالسياق عبر Git بنسخة إصدار. يتطور السياق جنباً إلى جنب مع الكود، مع سجل كامل للتغييرات وفروع سياق تجريبية والتراجع عند حدوث انحدارات.
5. Structured Files (الملفات المنظَّمة)
تنظيم صريح للسياق في ملفات مخصصة بصيغ قياسية. الأساس للمناهج الأخرى ونقطة البداية الموصى بها للمشاريع الجديدة.
أفضل الممارسات 2026
تطوّرت هندسة السياق بشكل ملحوظ. فيما يلي الممارسات الموصى بها لعام 2026:
- السياق الأدنى القابل للتطبيق: تضمين المعلومات التي يحتاجها الوكيل فعلاً لكل مهمة. الإفراط في السياق يُقلّل الدقة.
- هرمية واضحة: الفصل بين السياق العام (CLAUDE.md الجذر) والسياق المحدد (.claude/rules/ حسب النطاق).
- إدارة إصدارات نشطة: التعامل مع مصنّفات السياق بوصفها كوداً — التزامات وصفية ومراجعات في طلبات السحب واختبارات الانحدار.
- تحقق مستمر: التأكد بانتظام من أن السياق لا يزال دقيقاً وذا صلة مع تطور المشروع.
- فصل المسؤوليات: كل ملف قواعد يُغطّي نطاقاً أو جانباً واحداً بالضبط من النظام.
- إمكانية التتبع: كل تعليمة في السياق يجب أن يكون لها غرض صريح قابل للتتبع إلى متطلب محدد.
المصنّفات المُولَّدة
يُنتج الفريق المصنّفات السياقية التالية:
| المصنّف | الوصف |
|---|---|
CLAUDE.md | ملف التعليمات الرئيسي لـ Claude Code في جذر المشروع |
.claude/rules/*.md | قواعد سياقية مخصصة حسب النطاق أو الوظيفة |
AGENTS.md | تعريفات وأدلة لوكلاء الذكاء الاصطناعي في المشروع |
| Memory configs | إعدادات الذاكرة الدائمة لوكلاء محددين |
requirements.json | متطلبات السياق المُجمَّعة خلال المقابلة |
project-scan.json | تحليل شامل للحالة الراهنة للمشروع |
context-architecture.md | تصميم معمارية السياق المُختارة |
الاستخدام
أوامر الشرطة المائلة
جميع الأوامر تستخدم البادئة
/ce
# تشغيل خط الأنابيب الكامل
/ce:pipeline
# تشغيل مهام فردية
/ce:gatherRequirements
/ce:scanProject
/ce:designContextArchitecture
/ce:generateContextArtifacts
/ce:optimizeContext
/ce:validateContextQuality
# تشغيل دورة التحسين التكرارية
/ce:optimizationCycleتفعيل الوكلاء مباشرةً
@ce-interviewer # تفعيل Interviewer للجمع
@ce-scanner # تفعيل Scanner للتحليل
@ce-architect # تفعيل Architect للتصميم
@ce-generator # تفعيل Generator للتوليد
@ce-optimizer # تفعيل Optimizer للتحسينالمساهمة
نرحب بالمساهمات. يُرجى اتباع الخطوات التالية:
- انسخ المستودع (fork)
- أنشئ فرعاً لميزتك:
git checkout -b feat/my-improvement
- طبّق تغييراتك وفق معايير المشروع
- أرسل طلب سحب (pull request) مع وصف تفصيلي
الرخصة
MIT © 2026 Luiz Gustavo Vieira Rodrigues (@gutomec)
المراجعات
0 مراجعةلا توجد مراجعات بعد. كن أول من يراجع هذا الفريق!
المزيد من Luiz Rodrigues
squad forge
Squad meta de desenvolvimento, otimização e evolução de squads agênticos — cria, valida, otimiza e moderniza qualquer artefato de squad (agentes, tasks, workflows, skills, squads inteiros, templates) com perfeição de formato, e mantém a própria base de conhecimento atualizada via pesquisa web.
ultimate landingpage
Squad fullstack para criação de landing pages de ultra-alta conversão — pipeline end-to-end com 9 agentes: discovery de produto, pesquisa de mercado e experts de copywriting, design system atômico com contraste WCAG AAA e light/dark, geração de imagens por IA, frontend Next.js com SEO e acessibilidade, backend Python FastAPI com admin panel e exportação CSV, integrações WhatsApp e email, e QA multidimensional com score por dimensão
data quality guardian
Squad especialista em qualidade de dados — profiling de datasets, detecção de anomalias, validação de schemas, geração de relatórios de qualidade e sugestão de remediações automatizadas para pipelines de dados
incident response squad
Squad especialista em resposta a incidentes para DevOps/SRE — análise de logs multi-source, correlação de causa raiz, execução de runbooks de remediação, comunicação de status e geração de post-mortems blameless
brandcraft
Squad de produção de entregáveis visuais brand-consistent: extrai design systems de URLs (Refero + live extraction), gera PDFs, PPTX, posts sociais, carrosséis e vídeos programáticos por dois caminhos (Veo 3.1 + Remotion para footage de IA; HyperFrames HTML-first determinístico para motion-design, data-viz e explainer), faz auditoria competitiva de marca, aplica um quality gate awwwards de 24 itens e um arsenal de 112 bibliotecas de UI nos HTMLs/PDFs/animações, e valida acessibilidade WCAG 2.2 AA. Pipeline com 16 agentes especializados e 16 workflows.
nirvana squad creator
Gera squads v5-compliant a partir de linguagem natural — pipeline de 11 fases começando com intent archaeology + pesquisa web (2026), depois análise grounded, geração, otimização, validação, README multi-idioma, deploy e publicação no squads.sh
notebooklm automation
Automação programática completa do Google NotebookLM — da criação de notebooks e curadoria de fontes à pesquisa por Q&A progressivo e geração de 10 formatos de conteúdo (podcast, vídeo, slides, quiz, flashcards, infográfico, mapa mental, tabela de dados, relatório), com download de artefatos orquestrado por pipeline inteligente. Suporta 50+ idiomas e error handling cross-cutting (retry, re-auth, fallback de cota).
nirvana readme architect
Squad de geração de README.md perfeito e impecável, combinando análise profunda de codebase, seleção de template por tipo de projeto, todas as features do GitHub Flavored Markdown, validação com checklist de 25+ pontos e polimento final com badges e TOC.
soc alert triage
Squad especialista em triagem de alertas SOC para cybersecurity — classificação automatizada, filtragem de falsos positivos, priorização de ameaças, enriquecimento com threat intel e geração de briefs para analistas
adaptive tutor k12
Squad especialista em tutoria adaptativa K-12 — avaliação diagnóstica, mapeamento curricular personalizado, sessões de tutoria com dificuldade adaptativa, rastreamento de progresso e relatórios para pais e educadores
resume screener squad
Squad especialista em triagem de currículos para recrutamento — parsing automatizado de CVs, matching de skills com requisitos da vaga, auditoria de vieses, ranking de candidatos e geração de resumos executivos para hiring managers
automated code review squad
Squad especialista em code review automatizado — revisão de segurança, análise lógica, verificação de padrões arquiteturais, enforcement de coding standards e geração de review summaries priorizados para PRs e commits