**زبان:** [English](../../README.md) | [اردو](README.md) | [Deutsch](../de-DE/README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md)

# ECC

![ECC - ایجنٹک کام کے لیے ہارنس-نیٹو آپریٹر سسٹم](../../assets/hero.png)

[![Stars](https://img.shields.io/endpoint?url=https%3A%2F%2Fapi.ecc.tools%2Fbadge%2Fstars&style=flat)](https://github.com/affaan-m/ECC/stargazers)
[![Forks](https://img.shields.io/endpoint?url=https%3A%2F%2Fapi.ecc.tools%2Fbadge%2Fforks&style=flat)](https://github.com/affaan-m/ECC/network/members)
[![Contributors](https://img.shields.io/github/contributors/affaan-m/ECC?style=flat)](https://github.com/affaan-m/ECC/graphs/contributors)
[![npm ecc-universal](https://img.shields.io/npm/dw/ecc-universal?label=ecc-universal%20weekly%20downloads&logo=npm)](https://www.npmjs.com/package/ecc-universal)
[![npm ecc-agentshield](https://img.shields.io/npm/dw/ecc-agentshield?label=ecc-agentshield%20weekly%20downloads&logo=npm)](https://www.npmjs.com/package/ecc-agentshield)
[![GitHub App Install](https://img.shields.io/endpoint?url=https%3A%2F%2Fapi.ecc.tools%2Fbadge%2Finstalls&logo=github)](https://github.com/marketplace/ecc-tools)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE)
![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white)
![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)
![Python](https://img.shields.io/badge/-Python-3776AB?logo=python&logoColor=white)
![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)
![Java](https://img.shields.io/badge/-Java-ED8B00?logo=openjdk&logoColor=white)
![Perl](https://img.shields.io/badge/-Perl-39457E?logo=perl&logoColor=white)
![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white)

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

---

<div align="center">

**زبان / Language / 语言**

[English](../../README.md) | [**اردو**](README.md) | [Deutsch](../de-DE/README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md)

</div>

---

**ایجنٹک کام کے لیے ہارنس-نیٹو آپریٹر سسٹم۔ 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 سیٹ اپ گائیڈ](../../docs/HERMES-SETUP.md) سے شروع کریں، پھر [rc.1 ریلیز نوٹس](../../docs/releases/2.0.0-rc.1/release-notes.md) اور [کراس-ہارنس آرکیٹیکچر](../../docs/architecture/cross-harness.md) دیکھیں۔

---

<table>
<tr>
<td width="25%" align="center">
  <a href="https://ecc.tools/pricing">
    <strong> ECC Pro</strong><br />
    <sub>نجی ریپوز · GitHub App · $19/نشست/ماہ</sub>
  </a>
</td>
<td width="25%" align="center">
  <a href="https://github.com/sponsors/affaan-m">
    <strong> اسپانسر</strong><br />
    <sub>OSS کو فنڈ کریں · $5/ماہ سے</sub>
  </a>
</td>
<td width="25%" align="center">
  <a href="https://github.com/affaan-m/ECC/discussions">
    <strong> کمیونٹی</strong>
    <br />
    <sub>Discussions · Q&amp;A · Show & Tell</sub>
  </a>
</td>
<td width="25%" align="center">
  <a href="https://github.com/apps/ecc-tools">
    <strong> GitHub App</strong><br />
    <sub>انسٹال · PR آڈٹس · مفت ٹیئر</sub>
  </a>
</td>
</tr>
</table>

<sub>**OSS مفت رہتا ہے۔** یہ ریپو ہمیشہ کے لیے MIT لائسنس یافتہ ہے۔ ECC Pro نجی ریپوز کے لیے ہوسٹڈ GitHub App ہے۔ <a href="https://github.com/sponsors/affaan-m">اسپانسرز</a> اور <a href="https://ecc.tools/pricing">Pro سبسکرائبرز</a> اس کام کو فنڈ کرتے ہیں۔</sub>

---

## گائیڈز

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

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

---

## فوری آغاز

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

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

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

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

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

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

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

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

```bash
# ریپو کلون کریں
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: استعمال شروع کریں

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

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

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

### Dashboard GUI

```bash
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۔

```bash
# فوری اسکین (کوئی انسٹال ضروری نہیں)
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 یا بعد کا ورژن**

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

---

## ٹیسٹ چلانا

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

---

## تعاون

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

اگر آپ کے پاس یہ ہیں تو براہ کرم تعاون کریں:
- مفید agents یا skills
- ہوشیار hooks
- بہتر MCP کنفیگریشن
- بہتر rules

تفصیلات کے لیے [CONTRIBUTING.md](../../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

```bash
# 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 انسٹال ہیں؟**
```bash
/plugin list ecc@ecc
```

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

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

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

ہاں۔ Option 2 (دستی انسٹالیشن) استعمال کریں اور صرف جو ضرورت ہو کاپی کریں:
```bash
# صرف 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](../../LICENSE)
