Skip to content

CLAUDE.md

Latest commit

 

History

History
78 lines (59 loc) · 8.9 KB

CLAUDE.md

File metadata and controls

78 lines (59 loc) · 8.9 KB
Raw

CLAUDE.md (فارسی)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

@AGENTS.md

تمام قوانین پروژه در AGENTS.md قرار دارند — تنها منبع حقیقت برای هر دستیار هوش مصنوعی (معماری، قراردادها، تست، دروازههای کیفیت، گردشکار git، 23 قانون سختگیرانه، آموختههای PII). آن را بهطور کامل بخوانید؛ قوانین پروژه را دوباره اینجا اضافه نکنید. تمام موارد زیر فقط برای Claude Code اعمال میشوند — اصلاحات عملیاتیِ قوانینی که از قبل در AGENTS.md تعریف شدهاند.

جداسازی Worktree — نکات خاص Claude Code

پروتکل کامل و اجباری worktree (تأیید شاخهی پایه، مسیر متعارف .claude/worktrees/، استفاده از cp -al برای node_modules، قوانین teardown) در docs/ops/WORKTREE_ISOLATION.md آمده است (خلاصهشده در AGENTS.md ← گردش کار Git ← "جداسازی Worktree"). نکات خاص Claude Code:

  • شاخهی پایه را از طریق AskUserQuestion با اپراتور تأیید کنید (قانون سخت شماره ۱۹) مگر اینکه از قبل به شما گفته باشند.
  • ابزار بومی EnterWorktree را ترجیح دهید — این ابزار worktreeها را از قبل زیر .claude/worktrees/ (مسیر متعارف) ایجاد میکند. worktree را با دستور مستند git worktree add بسازید، سپس EnterWorktree را با path آن فراخوانی کنید.

ایمنی میان نشستها — نکات مختص Claude Code

قوانین سختگیرانهٔ #19/#21/#22 (در AGENTS.md) نشستهای موازی را کنترل میکنند. یادآوریهای عملیاتی برای این محیط:

  • ممنوعیت git stash را عیناً در پرامپت هر زیرعاملی که با git کار میکند تکرار کنید (ابزار Agent / اسکریپتهای Workflow) — زیرعاملها این فایل را به ارث نمیبرند و رخداد ثبتشدهٔ تکرار مشکل stash از طریق یک زیرعامل اتفاق افتاده است.
  • پیش از ادغام یا push کردن در هر PR که در این نشست ایجاد نکردهاید، git worktree list را اجرا کنید و gh pr view <N> --json state,headRefOid را دوباره بررسی کنید (قانون سختگیرانهٔ #22b).
  • هر نشست را در حالی پایان دهید که checkout اصلی روی همان شاخهای باشد که نشست با آن آغاز شده بود.

Superpowers / مصنوعات برنامهریزی — بازنویسی مسیرها

قرارداد _tasks/ در AGENTS.md ← «Planning & Research Artifacts» تعریف شده است. مهارتهای superpowers با پیشفرضهایی عرضه میشوند که به docs/… اشاره دارند — این پیشفرضها در اینجا بازنویسی میشوند. وقتی یکی از مهارتهای superpowers مسیری مانند «saved to docs/superpowers/plans/…» را اعلام میکند، پیش از نوشتن آن را به معادل _tasks/… تغییر دهید:

مصنوع (مهارت) پیشفرض (استفاده نکنید) بهجای آن اینجا ذخیره کنید
برنامهها (writing-plans) docs/superpowers/plans/ _tasks/superpowers/plans/YYYY-MM-DD-<feature>.md
مشخصات / طراحی (brainstorming) docs/superpowers/specs/ _tasks/superpowers/specs/YYYY-MM-DD-<topic>-design.md
پژوهش (deep-research، موردی) docs/research/ _tasks/research/…
تحویلها (/handoff) — _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/

آن مصنوعات را درون مخزن _tasks/ ثبت کنید (git -C _tasks …) و هرگز آنها را در مخزن اصلی ثبت نکنید.

فایلهای چرکنویس / موقت — از _artifacts/ استفاده کنید، نه /tmp

این پروژه دفترچهٔ چرکنویس پیشفرض نشست در این محیط (/tmp/claude-*/…) را بازنویسی میکند. فایلهای موقت/کاری — خروجیها، فایلهای zip تولیدشده، خروجیهای میانی یکبارمصرف و هر چیزی که در حالت عادی در /tmp قرار میدادید — را بهجای آن در /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/ بنویسید.

  • _artifacts/ یک مسیر ریشهای _* است: از قبل در gitignore قرار دارد (AGENTS.md ← «Root _* paths»)، فقط روی دیسک وجود دارد و هرگز ردیابی نمیشود.
  • دلیل: نگهداشتن خروجیهای چرکنویس درون پروژه (بهجای /tmp) باعث میشود اپراتور بتواند بهآسانی تمام فایلهای موقت را در یک مکان پیدا و حذف کند، بدون اینکه مجبور باشد در دایرکتوریهای موقتی و مختص هر نشست در /tmp جستوجو کند که ناپدید میشوند یا فایلهای ردیابینشده در آنها انباشته میشوند.
  • این مسیر را با _tasks/ اشتباه نگیرید (قانون سختگیرانهٔ #23، مخزن خصوصی git مستقل آن برای برنامهها/مشخصات/پژوهشها/تحویلهای ماندگار) — _artifacts/ فقط برای فایلهای کاری دورریختنی است و هیچچیز در اینجا نیازی به بقا یا نسخهبندی ندارد.

سبز بودن پایه پیش از باز کردن PRها

پیش از ایجاد شاخه یا باز کردن PR، بررسی سبز بودن پایه را اجرا کنید (AGENTS.md ← Git Workflow ← «Base-green check»؛ مهارتهای پروژه با .agents/skills/_shared/base-green.md به آن ارجاع میدهند). بدنهٔ PRای که در زمان قرمز بودن نوک شاخهٔ پایه باز میشود باید شامل ⚠️ base-red inherited: #<issue> باشد. برای رفع وضعیت قرمز انباشتهشده (نوک شاخهٔ پایه + PRهای قرمز)، از مهارت /sweep-reds استفاده کنید.