mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-06-11 02:33:10 +08:00

Files

Affaan Mustafa e755c5f72b fix: make plugin hooks run on Node 21+ and green the suite under modern Node (#2184 )

ROOT CAUSE: hooks load plugin-hook-bootstrap.js via
`node -e "...; process.argv.splice(1,0,s); require(s)"`. On Node 21+,
require.main is `undefined` under --eval, so the `if (require.main === module)`
guard was false and main() never ran — every plugin hook silently no-op'd
(e.g. the MCP-health PreToolUse hook stopped blocking). CI (Node 18/20) hid
this; it only surfaces on Node 21+. Fix: also run main() when require.main is
undefined (the eval-bootstrap case), while staying dormant on real imports.

Also clears pre-existing main debt the full local suite enforces:
- catalog:sync — README/docs agent+skill counts drifted after recent merges
- tests/ci/supply-chain-watch-workflow: update checkout SHA to the merged v6.0.3 (#2183)
- markdownlint + check-unicode-safety --write across docs/skills

Suite: 2683/2683 green under Node v25; lint + unicode clean.

Co-authored-by: ECC Test <ecc@example.test>

2026-06-07 16:05:28 +08:00

13 KiB

Raw Blame History

ECC

182K+ ستارے | 28K+ فورکس | 170+ تعاون کار | 12+ زبانی ماحولیاتی نظام | Anthropic Hackathon فاتح

زبان / Language / 语言

ایجنٹک کام کے لیے ہارنس-نیٹو آپریٹر سسٹم۔ Anthropic Hackathon فاتح کی طرف سے۔

صرف کنفیگریشن نہیں۔ ایک مکمل نظام: skills، instincts، میموری آپٹیمائزیشن، مسلسل سیکھنا، سیکیورٹی اسکیننگ، اور research-first ڈیویلپمنٹ۔ 10+ مہینوں کی گہری روزانہ استعمال سے تیار کیے گئے پروڈکشن-ریڈی agents، skills، hooks، rules، MCP کنفیگریشن، اور legacy command shims۔

Claude Code، Codex، Cursor، OpenCode، Gemini، Zed، GitHub Copilot، اور دیگر AI ایجنٹ ہارنسز پر کام کرتا ہے۔

ECC v2.0.0-rc.1 اس قابل استعمال پرت پر عوامی Hermes آپریٹر کہانی شامل کرتا ہے: Hermes سیٹ اپ گائیڈ سے شروع کریں، پھر rc.1 ریلیز نوٹس اور کراس-ہارنس آرکیٹیکچر دیکھیں۔

ECC Pro
_{نجی ریپوز · GitHub App · $19/نشست/ماہ}

اسپانسر
_{OSS کو فنڈ کریں · $5/ماہ سے}

کمیونٹی
_{Discussions · Q&A · Show & Tell}

GitHub App
_{انسٹال · PR آڈٹس · مفت ٹیئر}

_{OSS مفت رہتا ہے۔ یہ ریپو ہمیشہ کے لیے MIT لائسنس یافتہ ہے۔ ECC Pro نجی ریپوز کے لیے ہوسٹڈ GitHub App ہے۔ اسپانسرز اور Pro سبسکرائبرز اس کام کو فنڈ کرتے ہیں۔}

گائیڈز

یہ ریپو صرف خام کوڈ ہے۔ گائیڈز سب کچھ سمجھاتے ہیں۔

موضوع	آپ کیا سیکھیں گے
ٹوکن آپٹیمائزیشن	ماڈل سلیکشن، سسٹم پرامپٹ کم کرنا، بیک گراؤنڈ پراسیسز
میموری پرسسٹنس	ہکس جو سیشنز کے دوران سیاق و سباق محفوظ/لوڈ کرتے ہیں
مسلسل سیکھنا	سیشنز سے پیٹرنز خودکار طریقے سے نکالنا
تصدیقی لوپس	Checkpoint بمقابلہ مسلسل evals، grader کی اقسام
Parallelization	Git worktrees، cascade طریقہ، کب instances بڑھائیں
Subagent آرکیسٹریشن	سیاق و سباق کا مسئلہ، iterative retrieval پیٹرن

فوری آغاز

2 منٹ سے کم میں شروع کریں:

صرف ایک راستہ منتخب کریں

زیادہ تر Claude Code صارفین کو صرف ایک انسٹال راستہ استعمال کرنا چاہیے:

تجویز کردہ ڈیفالٹ: Claude Code پلگ ان انسٹال کریں، پھر صرف وہ rule فولڈرز کاپی کریں جو آپ واقعی چاہتے ہیں۔
دستی انسٹالر صرف تب استعمال کریں جب آپ مزید کنٹرول چاہتے ہوں۔
انسٹال طریقے ملائیں نہیں۔ سب سے عام خراب سیٹ اپ یہ ہے: پہلے /plugin install، پھر install.sh --profile full۔

مرحلہ 1: پلگ ان انسٹال کریں (تجویز کردہ)

# مارکیٹ پلیس شامل کریں
/plugin marketplace add https://github.com/affaan-m/ECC

# پلگ ان انسٹال کریں
/plugin install ecc@ecc

مرحلہ 2: Rules انسٹال کریں (اگر ضرورت ہو)

# ریپو کلون کریں
git clone https://github.com/affaan-m/ECC.git
cd ECC

# ECC-owned نیم اسپیس میں rules کاپی کریں
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/  # اپنی زبان منتخب کریں

مرحلہ 3: استعمال شروع کریں

# Skills بنیادی workflow سطح ہیں
/ecc:plan "یوزر تصدیق شامل کریں"

# دستیاب commands چیک کریں
/plugin list ecc@ecc

بس! آپ کو اب 61 agents، 246 skills، اور 76 legacy command shims تک رسائی حاصل ہے۔

Dashboard GUI

npm run dashboard
# یا
python3 ./ecc_dashboard.py

اندر کیا ہے

یہ ریپو ایک Claude Code plugin ہے — براہ راست انسٹال کریں یا اجزاء دستی طور پر کاپی کریں۔

ECC/
├── agents/           # 60 مخصوص subagents
├── skills/           # Workflow تعریفیں اور ڈومین علم
├── commands/         # Slash-entry compatibility
├── rules/            # ہمیشہ پیروی کرنے والی ہدایات
├── hooks/            # Trigger-based آٹومیشن
├── scripts/          # Cross-platform Node.js اسکرپٹس
└── tests/            # ٹیسٹ سوئٹ

کون سا Agent استعمال کروں؟

میں چاہتا ہوں...	یہ سطح استعمال کریں	Agent
نئی feature منصوبہ بنانا	`/ecc:plan "Auth شامل کریں"`	planner
سسٹم آرکیٹیکچر ڈیزائن	`/ecc:plan` + architect agent	architect
پہلے ٹیسٹ کے ساتھ کوڈ لکھنا	`tdd-workflow` skill	tdd-guide
لکھے گئے کوڈ کا جائزہ	`/code-review`	code-reviewer
ناکام build ٹھیک کرنا	`/build-fix`	build-error-resolver
سیکیورٹی کمزوریاں تلاش کرنا	`/security-scan`	security-reviewer
غیر ضروری کوڈ ہٹانا	`/refactor-clean`	refactor-cleaner
دستاویزات اپ ڈیٹ	`/update-docs`	doc-updater
Python کوڈ جائزہ	`/python-review`	python-reviewer

AgentShield — سیکیورٹی آڈیٹر

Claude Code Hackathon (Cerebral Valley x Anthropic) میں بنایا گیا۔ 1282 ٹیسٹ، 98% کوریج، 102 static analysis rules۔

# فوری اسکین (کوئی انسٹال ضروری نہیں)
npx ecc-agentshield scan

# محفوظ مسائل خودکار طریقے سے ٹھیک کریں
npx ecc-agentshield scan --fix

# تین Opus 4.6 agents کے ساتھ گہرا تجزیہ
npx ecc-agentshield scan --opus --stream

یہ کیا اسکین کرتا ہے: CLAUDE.md، settings.json، MCP configs، hooks، agent تعریفیں، اور skills — 5 زمروں میں: secrets detection (14 patterns)، permission آڈیٹنگ، hook injection تجزیہ، MCP server risk profiling، اور agent config جائزہ۔

ضروریات

Claude Code CLI v2.1.0 یا بعد کا ورژن

# اپنا ورژن چیک کریں
claude --version

ٹیسٹ چلانا

# تمام ٹیسٹ چلائیں
node tests/run-all.js

تعاون

تعاون کا خیر مقدم اور حوصلہ افزائی کی جاتی ہے۔

اگر آپ کے پاس یہ ہیں تو براہ کرم تعاون کریں:

مفید agents یا skills
ہوشیار hooks
بہتر MCP کنفیگریشن
بہتر rules

تفصیلات کے لیے CONTRIBUTING.md دیکھیں۔

تعاون کے لیے خیالات

زبان-مخصوص skills (Rust، C#)
فریم ورک-مخصوص configs (Rails، FastAPI)
DevOps agents (Kubernetes، Terraform، AWS)
ٹیسٹنگ حکمت عملی
ڈومین-مخصوص علم (ML، data engineering)

کراس-پلیٹ فارم سپورٹ

یہ پلگ ان Windows، macOS، اور Linux کو مکمل طور پر سپورٹ کرتا ہے، ساتھ ہی بڑے IDEs (Cursor، Zed، OpenCode) اور CLI ہارنسز کے ساتھ تنگ انضمام۔ تمام hooks اور اسکرپٹس زیادہ سے زیادہ مطابقت کے لیے Node.js میں دوبارہ لکھے گئے ہیں۔

Hook Runtime Controls

# Hook strictness پروفائل (ڈیفالٹ: standard)
export ECC_HOOK_PROFILE=standard

# مخصوص hooks عارضی طور پر غیر فعال کریں
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

# SessionStart کے لیے سیاق و سباق محدود کریں
export ECC_SESSION_START_MAX_CHARS=4000

# SessionStart سیاق و سباق مکمل طور پر غیر فعال کریں
export ECC_SESSION_START_CONTEXT=off

عام سوالات

میں کیسے چیک کروں کہ کون سے agents/commands انسٹال ہیں؟

/plugin list ecc@ecc

میری hooks کام نہیں کر رہیں / "Duplicate hooks file" errors آ رہی ہیں

.claude-plugin/plugin.json میں "hooks" فیلڈ شامل نہ کریں۔ Claude Code v2.1+ خودبخود hooks/hooks.json لوڈ کرتا ہے۔

کیا میں ECC کو صرف کچھ اجزاء کے ساتھ استعمال کر سکتا ہوں؟

ہاں۔ Option 2 (دستی انسٹالیشن) استعمال کریں اور صرف جو ضرورت ہو کاپی کریں:

# صرف agents
cp agents/*.md ~/.claude/agents/

# صرف rules
mkdir -p ~/.claude/rules/ecc/
cp -r rules/common ~/.claude/rules/ecc/

کیا یہ Cursor / OpenCode / Codex کے ساتھ کام کرتا ہے؟

ہاں۔ ECC کراس-پلیٹ فارم ہے — Claude Code، Cursor، OpenCode، Codex، GitHub Copilot، Gemini، Zed، اور مزید کے ساتھ۔

لائسنس

MIT لائسنس — دیکھیں LICENSE

13 KiB Raw Blame History Unescape Escape

ECC