nirvana context enricher
Squad de pesquisa paralela que gera contexto enriquecido ao estado nirvana sobre qualquer tópico. Orquestra 3 pesquisadores em paralelo (deep research, skills.sh + bibliotecas GitHub, papers acadêmicos) e 1 sintetizador, com gates mínimos de busca, para produzir um relatório de contexto técnico acionável.
🧘 Nirvana Context Enricher (NCE)
فريق بحث متوازي يولّد سياقًا مُثريًا بمستوى النيرفانا حول أي موضوع. تطوّر من
باستخدام Agent Teams: بحث عميق + skills.sh + مكتبات GitHub + أوراق أكاديمية./atualise
📑 جدول المحتويات
- نظرة عامة
- مقارنة /atualise مع NCE
- المكدس التقني
- المتطلبات الأساسية
- البدء السريع
- الهندسة المعمارية
- الوكلاء
- سير العمل
- المخرجات
- استكشاف الأخطاء
- المساهمة
- الترخيص
✨ نظرة عامة
Nirvana Context Enricher هو فريق Squad Protocol v5 يُنسّق 5 وكلاء متخصصين لإنتاج تقارير سياقية شاملة حول أي موضوع. على عكس الأبحاث التسلسلية التقليدية، يُشغّل NCE 3 باحثين بالتوازي — يغطون البحث العميق ومنظومة الأدوات والأدبيات الأكاديمية — ثم يجمع كل شيء في تقرير موحّد من 16 قسمًا.
لمن هو؟ المطورون والمهندسون المعماريون والفرق الذين يحتاجون إلى سياق تقني عميق وقابل للتنفيذ قبل اتخاذ القرارات.
لماذا يوجد؟ البحث اليدوي بطيء وسطحي ويفوّت مصادر مهمة. يضمن NCE تغطية لا تقل عن 24 عملية بحث ويب و11 عملية استخراج محتوى، موزعة بين باحثين مخصصين1.
📊 مقارنة /atualise مع NCE
| الجانب | /atualise | NCE |
|---|---|---|
| التنفيذ | تسلسلي (وكيل واحد) | متوازي (4 وكلاء) |
| الجولات | 6 تسلسلية | 3 باحثين متوازين + تجميع |
| Skills | لا يبحث | يبحث في skills.sh |
| مكتبات GitHub | بدون تركيز | الرائجة + النمو |
| الأوراق البحثية | مختلطة مع بيانات أخرى | باحث مخصص |
| المخرجات | تقرير معلوماتي | سياق مُثرى قابل للتنفيذ |
| الحد الأدنى للبحث | 15 | 24 |
| الحد الأدنى WebFetch | — | 11 |
/atualise
🔧 المكدس التقني
| التقنية | الغرض |
|---|---|
| Claude Code Agent Teams | تنسيق الوكلاء المتوازي |
| WebSearch | البحث في الويب عبر مصادر متعددة |
| WebFetch | استخراج المحتوى وتحليل الصفحات |
| TeamCreate / TeamDelete | إدارة دورة حياة الفريق |
| TaskCreate / TaskUpdate | إدارة وتتبع المهام |
| SendMessage | التواصل بين الوكلاء |
Agent (run_in_background) | إنشاء الباحثين بالتوازي |
📋 المتطلبات الأساسية
- Claude Code — مع دعم Agent Teams
- squads-sh — إطار التنسيق
- اتصال بالإنترنت — مطلوب لـ WebSearch و WebFetch
- فريق NCE مُثبّت — موجود في
squads/nirvana-context-enricher/
تحقق من توفر الفريق:
ls squads/nirvana-context-enricher/squad.yaml⚡ البدء السريع
1. عبر Skill (مُوصى به)
/nirvana-context-enricher "React Server Components" 20262. عبر أمر Squad
/SQUADS:nce:nce-orchestrator *enrich "Kubernetes operators" 20263. المُعاملات
| المُعامل | النوع | مطلوب | الافتراضي | الوصف |
|---|---|---|---|---|
topic | string | ✅ | — | الموضوع المراد البحث فيه |
year | number | ❌ | 2026 | السنة المستهدفة لتصفية النتائج |
قائمة التحقق من الإعداد
- Claude Code مفتوح مع تشغيل squads نشط
- الموضوع محدد بوضوح
- اتصال إنترنت مستقر
- انتظار اكتمال الباحثين الثلاثة (~2-5 دقائق)
🏗️ الهندسة المعمارية
مخطط المكونات
تدفق التنفيذ
:file_folder: عرض شجرة المجلدات
squads/nirvana-context-enricher/
├── squad.yaml # تعريف الفريق
├── README.md # التوثيق (PT-BR)
├── agents/
│ ├── nce-orchestrator.md # Nirva — FlowMaster
│ ├── nce-deep-researcher.md # Sage — Seeker
│ ├── nce-skills-scout.md # Scout — Explorer
│ ├── nce-papers-researcher.md # Scholar — Seeker
│ └── nce-synthesizer.md # Lotus — Alchemist
├── tasks/
│ ├── nce-orchestrator-parse-request.md # تحليل الموضوع والاستعلامات
│ ├── nce-orchestrator-dispatch-research.md # إنشاء الباحثين
│ ├── nce-deep-researcher-execute-rounds.md # 6 جولات بحثية
│ ├── nce-skills-scout-search-ecosystem.md # Skills + مكتبات
│ ├── nce-papers-researcher-find-papers.md # الأوراق الأكاديمية
│ ├── nce-synthesizer-generate-report.md # التقرير النهائي
│ └── nce-orchestrator-cleanup.md # الإيقاف والتنظيف
├── workflows/
│ └── nirvana-enrichment.yaml # سير عمل من 4 مراحل
├── checklists/
│ └── research-quality.md # قائمة فحص الجودة
├── templates/
│ └── nirvana-report.md # قالب التقرير
└── config/
├── coding-standards.md # معايير البرمجة
├── tech-stack.md # التقنيات المستخدمة
└── source-tree.md # هيكل المجلدات👥 الوكلاء
| المعرّف | الشخصية | النموذج الأصلي | الدور | المسؤولية |
|---|---|---|---|---|
nce-orchestrator | Nirva | FlowMaster | المُنسّق | يستقبل الموضوع، يحلل، ينسق 3 باحثين متوازين + 1 مُجمّع |
nce-deep-researcher | Sage | Seeker | الباحث العميق | 6 جولات شاملة: أساسيات، بنية، تطبيق، متقدم، أحداث جارية، مشكلات |
nce-skills-scout | Scout | Explorer | مستكشف Skills | skills.sh + مكتبات GitHub الرائجة + awesome-lists |
nce-papers-researcher | Scholar | Seeker | الباحث الأكاديمي | أوراق arxiv/scholar + أفضل المناهج والأنماط |
nce-synthesizer | Lotus | Alchemist | مُجمّع النيرفانا | يجمع بيانات الباحثين الثلاثة في تقرير نهائي من 16 قسمًا |
الحد الأدنى للبحث لكل وكيل
| الوكيل | WebSearch | WebFetch | المجموع |
|---|---|---|---|
| Sage | 10 | 5 | 15 |
| Scout | 8 | 3 | 11 |
| Scholar | 6 | 3 | 9 |
| المجموع | 24 | 11 | 35 |
minimum_viable (2/3 باحثين).
🔄 سير العمل
سير عمل nirvana-enrichment يتكون من 4 مراحل متسلسلة مع تشغيل مرحلة البحث بالتوازي:
المراحل
| # | المرحلة | النوع | الوكيل (الوكلاء) | الاعتماد |
|---|---|---|---|---|
| 1 | parse | تسلسلي | Nirva | — |
| 2 | research | متوازي | Sage، Scout، Scholar | parse |
| 3 | synthesize | تسلسلي | Lotus | research |
| 4 | cleanup | تسلسلي | Nirva | synthesize |
معالجة الأخطاء
| السيناريو | السلوك |
|---|---|
researcher_failure | المتابعة مع الباحثين المتبقين |
minimum_viable | يتطلب نجاح 2/3 باحثين على الأقل |
timeout | استخدام البيانات الجزئية المجمعة حتى الآن |
بوابات الجودة
gates:
min_searches: 20 # الحد الأدنى الإجمالي لـ WebSearch
min_webfetch: 11 # الحد الأدنى الإجمالي لـ WebFetch
min_researchers_success: 2 # الحد الأدنى للباحثين الناجحين📄 المخرجات
يتم حفظ التقرير تلقائيًا في:
.claude/context-enrichment/{slug}-{YYYY-MM-DD}.mdالأقسام الـ 16 لتقرير النيرفانا
:scroll: عرض جميع الأقسام الـ 16
| # | القسم | المصدر الرئيسي |
|---|---|---|
| 1 | تحليل الطلب | Nirva |
| 2 | ما هو | Sage |
| 3 | الهندسة المعمارية/البنية | Sage |
| 4 | الميزات الأساسية | Sage |
| 5 | كيفية الاستخدام | Sage |
| 6 | الإعداد | Sage |
| 7 | أفضل الممارسات | Sage |
| 8 | مستجدات العام | Sage |
| 9 | Skills الموصى بها (skills.sh) | Scout |
| 10 | مكتبات النظام البيئي الحديثة | Scout |
| 11 | أوراق ومقالات مرجعية | Scholar |
| 12 | أفضل المناهج | Scholar |
| 13 | المشكلات الشائعة والحلول | Sage + Scholar |
| 14 | السياق المُثرى (النيرفانا) | Lotus |
| 15 | الموارد | الجميع |
| 16 | فجوات المعرفة | Lotus |
قواعد الجودة (قائمة الفحص)
| الفئة | النوع | المعايير |
|---|---|---|
| الكمية | حاجب | الحد الأدنى لعمليات البحث/WebFetch لكل وكيل |
| الجودة | حاجب | مصادر رسمية، تصفية بالسنة، 2/3 باحثين، عناوين URL مسجلة |
| الاكتمال | استشاري | 16 قسمًا مملوءة، سياق مُثرى أصلي، فجوات موثقة |
| المخرجات | حاجب | ملف محفوظ، تنظيف مُنفَّذ، نتيجة مُبلَّغة |
🆘 استكشاف الأخطاء
| المشكلة | السبب المحتمل | الحل |
|---|---|---|
| تقرير غير مكتمل | فشل باحث | تحقق من نجاح 2/3 على الأقل (بوابة minimum_viable) |
| انتهاء مهلة البحث | اتصال بطيء أو موضوع واسع جدًا | صقل الموضوع ليكون أكثر تحديدًا |
| أقسام فارغة | WebFetch محظور من الموقع | تحقق من العناوين في السجل؛ Lotus يُعلّمها كفجوة |
| خطأ TeamCreate | تم الوصول لحد الوكلاء | انتظر انتهاء الفرق الأخرى أو ألغِ بـ Ctrl+C |
| لم يتم إنشاء الملف | التنظيف نُفّذ قبل التجميع | تحقق من تحقيق min_researchers_success >= 2 |
:mag: تشخيص مُفصّل
التحقق من حالة الفريق
ls -la .claude/context-enrichment/التحقق من تعرّف تشغيل squads على الفريق
ls squads/nirvana-context-enricher/squad.yamlفرض التنظيف يدويًا
# إذا فشل التنظيف التلقائي، تحقق من الوكلاء المتبقين
# وألغِ يدويًا عبر Claude Codeالتحقق من المخرجات الجزئية
# يتم حفظ التقارير الجزئية بلاحقة -partial
ls .claude/context-enrichment/*-partial*🤝 المساهمة
المساهمات مُرحّب بها! اتبع الخطوات أدناه:
- قم بعمل Fork للمشروع
- أنشئ فرعك ()
git checkout -b feature/nce-improvement
- قم بعمل Commit لتغييراتك (
git commit -m 'feat(nce): improvement description') - قم بالـ Push إلى الفرع ()
git push origin feature/nce-improvement
- افتح Pull Request
أنماط الـ Commit
| النوع | الوصف |
|---|---|
feat(nce): | ميزة جديدة في NCE |
fix(nce): | إصلاح خطأ |
docs(nce): | تحديث التوثيق |
refactor(nce): | إعادة هيكلة الكود |
test(nce): | إضافة أو إصلاح اختبارات |
chore(nce): | مهام الصيانة |
راجع دليل المساهمة لمزيد من التفاصيل2.
:newspaper: سجل التغييرات
v1.0.0 (2026-03-06)
+ أُضيف: فريق NCE مع 5 وكلاء متخصصين
+ أُضيف: سير عمل nirvana-enrichment من 4 مراحل
+ أُضيف: بحث متوازي مع 3 باحثين متزامنين
+ أُضيف: تقرير النيرفانا من 16 قسمًا
+ أُضيف: بوابات جودة مع حدود دنيا للبحث
+ أُضيف: معالجة أخطاء مع minimum_viable (2/3)
! تغيير: تطوّر من /atualise إلى هندسة متعددة الوكلاء📃 الترخيص
هذا المشروع مرخّص بموجب رخصة MIT — راجع ملف LICENSE للتفاصيل.
صُنع بـ ❤️ بواسطة Luiz Gustavo Vieira Rodrigues
⭐ إذا ساعدك هذا المشروع، يُرجى التفكير في إعطائه نجمة!
Footnotes
المراجعات
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