Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
301 changes: 301 additions & 0 deletions docs/ur/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,301 @@
**زبان:** [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/github/stars/affaan-m/ECC?style=flat)](https://github.com/affaan-m/ECC/stargazers)
[![Forks](https://img.shields.io/github/forks/affaan-m/ECC?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/badge/GitHub%20App-150%20installs-2ea44f?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
```

**بس!** آپ کو اب 60 agents، 232 skills، اور 75 legacy command shims تک رسائی حاصل ہے۔
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Update catalog counts to match current repository

This line states that a successful install exposes 60 agents, 232 skills, and 75 legacy command shims, but the current repo metadata and English README now use 61 / 246 / 76; keeping stale counts in the new Urdu README creates a verification mismatch for Urdu users following the install guide and can lead them to think their setup is broken when it is actually correct.

Useful? React with 👍 / 👎.


### 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 جائزہ۔
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

AgentShield scan scope appears overstated in this line.

Line 200 says AgentShield scans skills, but the referenced scanner spec lists CLAUDE.md, settings.json, mcp.json, hooks/, and agents/*.md. Please align this sentence to avoid misleading users about current coverage.

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

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
**یہ کیا اسکین کرتا ہے:** CLAUDE.md، settings.json، MCP configs، hooks، agent تعریفیں، اور skills — 5 زمروں میں: secrets detection (14 patterns)، permission آڈیٹنگ، hook injection تجزیہ، MCP server risk profiling، اور agent config جائزہ۔
**یہ کیا اسکین کرتا ہے:** CLAUDE.md، settings.json، MCP configs، hooks، اور agent تعریفیں — 5 زمروں میں: secrets detection (14 patterns)، permission آڈیٹنگ، hook injection تجزیہ، MCP server risk profiling، اور agent config جائزہ۔
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/ur/README.md` at line 200, Update the wording in the Urdu README line
that currently claims AgentShield scans "skills": change that phrase to match
the scanner spec by listing CLAUDE.md, settings.json, mcp.json, hooks/, and
agents/*.md (instead of "skills"); ensure the sentence still mentions the same
five analysis categories (secrets detection, permission auditing, hook injection
analysis, MCP server risk profiling, and agent config review) but does not imply
coverage of skill files. Locate the sentence containing "skills" in the
docs/ur/README.md and replace it accordingly so it matches the scanner spec.


---

## ضروریات

- **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)