Skip to content

CLAUDE.md

Latest commit

 

History

History
73 lines (54 loc) · 10.9 KB

CLAUDE.md

File metadata and controls

73 lines (54 loc) · 10.9 KB
Raw

CLAUDE.md (ਪੰਜਾਬੀ)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 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 · 🇵🇭 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 ਵਿੱਚ ਹਨ — ਹਰ AI ਸਹਾਇਕ ਲਈ ਸੱਚਾਈ ਦਾ ਇਕਮਾਤਰ ਸਰੋਤ (ਆਰਕੀਟੈਕਚਰ, ਰਵਾਇਤਾਂ, ਟੈਸਟਿੰਗ, ਗੁਣਵੱਤਾ ਗੇਟ, git ਵਰਕਫ਼ਲੋ, 23 ਸਖ਼ਤ ਨਿਯਮ, PII ਸਿੱਖਿਆਵਾਂ)। ਇਸਨੂੰ ਪੂਰਾ ਪੜ੍ਹੋ; ਪ੍ਰੋਜੈਕਟ ਦੇ ਨਿਯਮ ਇੱਥੇ ਮੁੜ ਨਾ ਜੋੜੋ। ਹੇਠਾਂ ਦਿੱਤੀ ਹਰ ਚੀਜ਼ ਸਿਰਫ਼ Claude Code ਉੱਤੇ ਲਾਗੂ ਹੁੰਦੀ ਹੈ — AGENTS.md ਵਿੱਚ ਪਹਿਲਾਂ ਤੋਂ ਪਰਿਭਾਸ਼ਿਤ ਨਿਯਮਾਂ ਦੇ ਸੰਚਾਲਕੀ ਸੁਧਾਰ।

ਵਰਕਟਰੀ ਆइसोलेशन — Claude Code ਸੰਬੰਧੀ ਖਾਸ ਗੱਲਾਂ

ਪੂਰਾ ਲਾਜ਼ਮੀ ਵਰਕਟਰੀ ਪ੍ਰੋਟੋਕੋਲ (ਬੇਸ-ਬ੍ਰਾਂਚ ਪੁਸ਼ਟੀ, .claude/worktrees/ ਮਾਨਕ ਪਾਥ, cp -al node_modules, ਟੀਅਰਡਾਊਨ ਨਿਯਮ) docs/ops/WORKTREE_ISOLATION.md ਵਿੱਚ ਹੈ (AGENTS.md → Git Workflow → "Worktree isolation" ਵਿੱਚ ਸੰਖੇਪ ਕੀਤਾ ਗਿਆ)। Claude Code ਨਾਲ ਸੰਬੰਧਿਤ ਖਾਸ ਨੁਕਤੇ:

  • AskUserQuestion ਰਾਹੀਂ ਓਪਰੇਟਰ ਨਾਲ ਬੇਸ ਬ੍ਰਾਂਚ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ (ਸਖ਼ਤ ਨਿਯਮ #19), ਜਦੋਂ ਤੱਕ ਉਸਨੇ ਪਹਿਲਾਂ ਹੀ ਤੁਹਾਨੂੰ ਨਹੀਂ ਦੱਸਿਆ ਹੋਵੇ।
  • ਬਿਲਟ-ਇਨ EnterWorktree ਟੂਲ ਨੂੰ ਤਰਜੀਹ ਦਿਓ — ਇਹ ਪਹਿਲਾਂ ਹੀ .claude/worktrees/ (ਮਾਨਕ ਪਾਥ) ਦੇ ਅੰਦਰ ਵਰਕਟਰੀ ਬਣਾਉਂਦਾ ਹੈ। ਦਸਤਾਵੇਜ਼ੀਕ੍ਰਿਤ git worktree add ਕਮਾਂਡ ਨਾਲ ਵਰਕਟਰੀ ਬਣਾਓ, ਫਿਰ EnterWorktree ਨੂੰ ਇਸਦੇ path ਨਾਲ ਕਾਲ ਕਰੋ।

ਕ੍ਰਾਸ-ਸੈਸ਼ਨ ਸੁਰੱਖਿਆ — Claude Code ਦੀਆਂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ

ਸਖ਼ਤ ਨਿਯਮ #19/#21/#22 (AGENTS.md ਵਿੱਚ) ਸਮਾਂਤਰ ਸੈਸ਼ਨਾਂ ਨੂੰ ਨਿਯੰਤਰਿਤ ਕਰਦੇ ਹਨ। ਇਸ ਹਾਰਨੈੱਸ ਲਈ ਸੰਚਾਲਕੀ ਯਾਦ-ਦਹਾਨੀਆਂ:

  • git ਨੂੰ ਛੂਹਣ ਵਾਲੇ ਹਰ ਸਬ-ਏਜੰਟ ਦੇ ਪ੍ਰੌਮਪਟ ਵਿੱਚ git stash ਪਾਬੰਦੀ ਨੂੰ ਹੂਬਹੂ ਦੁਹਰਾਓ (Agent ਟੂਲ / Workflow ਸਕ੍ਰਿਪਟਾਂ) — ਸਬ-ਏਜੰਟਾਂ ਨੂੰ ਇਹ ਫ਼ਾਈਲ ਵਿਰਾਸਤ ਵਿੱਚ ਨਹੀਂ ਮਿਲਦੀ, ਅਤੇ stash ਘਟਨਾ ਦੀ ਦਰਜ ਕੀਤੀ ਦੁਹਰਾਈ ਇੱਕ ਸਬ-ਏਜੰਟ ਰਾਹੀਂ ਹੋਈ ਸੀ।
  • ਕਿਸੇ ਵੀ ਅਜਿਹੀ PR ਨੂੰ ਮਰਜ ਜਾਂ ਪੁਸ਼ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ, ਜੋ ਤੁਸੀਂ ਇਸ ਸੈਸ਼ਨ ਵਿੱਚ ਨਹੀਂ ਬਣਾਈ, git worktree list ਚਲਾਓ ਅਤੇ gh pr view <N> --json state,headRefOid ਨੂੰ ਮੁੜ ਜਾਂਚੋ (ਸਖ਼ਤ ਨਿਯਮ #22b)।
  • ਹਰ ਸੈਸ਼ਨ ਨੂੰ ਮੁੱਖ ਚੈੱਕਆਉਟ ਉਸੇ ਬ੍ਰਾਂਚ ਉੱਤੇ ਰੱਖ ਕੇ ਸਮਾਪਤ ਕਰੋ, ਜਿਸ ਉੱਤੇ ਇਹ ਸ਼ੁਰੂ ਹੋਇਆ ਸੀ।

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 …), ਮੁੱਖ ਰਿਪੋ ਵਿੱਚ ਕਦੇ ਨਹੀਂ।

ਸਕ੍ਰੈਚ / ਅਸਥਾਈ ਫ਼ਾਈਲਾਂ — /tmp ਦੀ ਬਜਾਏ _artifacts/ ਵਰਤੋ

ਇਹ ਪ੍ਰੋਜੈਕਟ ਹਾਰਨੈੱਸ ਦੇ ਡਿਫਾਲਟ ਸੈਸ਼ਨ ਸਕ੍ਰੈਚਪੈਡ (/tmp/claude-*/…) ਨੂੰ ਓਵਰਰਾਈਡ ਕਰਦਾ ਹੈ। ਅਸਥਾਈ/ਕਾਰਜਸ਼ੀਲ ਫ਼ਾਈਲਾਂ — ਐਕਸਪੋਰਟ, ਤਿਆਰ ਕੀਤੀਆਂ zips, ਇੱਕ-ਵਾਰ ਵਰਤੇ ਜਾਣ ਵਾਲੇ ਵਿਚਕਾਰਲੇ ਆਉਟਪੁੱਟ, ਜੋ ਕੁਝ ਵੀ ਤੁਸੀਂ ਆਮ ਤੌਰ ਉੱਤੇ /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> ਹੋਣਾ ਲਾਜ਼ਮੀ ਹੈ। ਇਕੱਠੀ ਹੋਈ ਰੈੱਡ ਸਥਿਤੀ (ਬੇਸ ਟਿਪ + ਰੈੱਡ PRs) ਨੂੰ ਖ਼ਤਮ ਕਰਨ ਲਈ /sweep-reds ਸਕਿੱਲ ਵਰਤੋ।