Skip to content

CLAUDE.md

Latest commit

 

History

History
75 lines (56 loc) · 11.3 KB

CLAUDE.md

File metadata and controls

75 lines (56 loc) · 11.3 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 · 🇮🇳 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-ରେ ରହିଛି — ପ୍ରତ୍ୟେକ AI ସହାୟକ ପାଇଁ ଏହା ହେଉଛି ଏକମାତ୍ର ପ୍ରାମାଣିକ ଉତ୍ସ (ସ୍ଥାପତ୍ୟ, ପ୍ରଥା, ପରୀକ୍ଷଣ, ଗୁଣବତ୍ତା ଦ୍ୱାର, git କାର୍ଯ୍ୟପ୍ରବାହ, 23ଟି କଠୋର ନିୟମ, PII ଶିକ୍ଷା)। ଏହାକୁ ସମ୍ପୂର୍ଣ୍ଣ ପଢ଼ନ୍ତୁ; ପ୍ରକଳ୍ପ ନିୟମଗୁଡ଼ିକୁ ଏଠାରେ ପୁନଃ ଯୋଗ କରନ୍ତୁ ନାହିଁ। ନିମ୍ନରେ ଥିବା ସବୁକିଛି କେବଳ Claude Code ପାଇଁ ପ୍ରଯୁଜ୍ୟ — AGENTS.md-ରେ ପୂର୍ବରୁ ପରିଭାଷିତ ନିୟମଗୁଡ଼ିକର ପରିଚାଳନାଗତ ସୁଧାର।

Worktree ବିଚ୍ଛିନ୍ନତା — Claude Code ସମ୍ବନ୍ଧୀୟ ବିଶେଷ ବିଷୟଗୁଡ଼ିକ

ସମ୍ପୂର୍ଣ୍ଣ ବାଧ୍ୟତାମୂଳକ worktree ପ୍ରୋଟୋକଲ (base-branch ନିଶ୍ଚିତକରଣ, .claude/worktrees/ ମାନକ ପଥ, cp -al node_modules, teardown ନିୟମଗୁଡ଼ିକ) docs/ops/WORKTREE_ISOLATION.md ରେ ଅଛି (AGENTS.md → Git Workflow → "Worktree isolation" ରେ ସାରାଂଶିତ)। Claude-Code-ସମ୍ବନ୍ଧୀୟ ବିଷୟଗୁଡ଼ିକ:

  • ଯଦି ଅପରେଟର ଆପଣଙ୍କୁ ପୂର୍ବରୁ କହି ନାହାଁନ୍ତି, ତେବେ AskUserQuestion ମାଧ୍ୟମରେ ସେମାନଙ୍କ ସହିତ base branch ନିଶ୍ଚିତ କରନ୍ତୁ (କଠୋର ନିୟମ #19)।
  • ନେଟିଭ୍ EnterWorktree ଟୁଲ୍ କୁ ଅଗ୍ରାଧିକାର ଦିଅନ୍ତୁ — ଏହା ପୂର୍ବରୁ .claude/worktrees/ (ମାନକ ପଥ) ଅଧୀନରେ worktrees ସୃଷ୍ଟି କରିଥାଏ। ଡକ୍ୟୁମେଣ୍ଟ କରାଯାଇଥିବା git worktree add କମାଣ୍ଡ ସହିତ worktree ସୃଷ୍ଟି କରନ୍ତୁ, ତାପରେ ଏହାର path ସହିତ EnterWorktree କୁ କଲ୍ କରନ୍ତୁ।

କ୍ରସ୍-ସେସନ୍ ସୁରକ୍ଷା — Claude Code-ନିର୍ଦ୍ଦିଷ୍ଟ ବିବରଣୀ

କଠୋର ନିୟମ #19/#21/#22 (AGENTS.md-ରେ) ସମାନ୍ତରାଳ ସେସନ୍ଗୁଡ଼ିକୁ ପରିଚାଳନା କରେ। ଏହି ହାର୍ନେସ୍ ପାଇଁ ପରିଚାଳନାଗତ ସ୍ମାରକଗୁଡ଼ିକ:

  • git ସ୍ପର୍ଶ କରୁଥିବା ପ୍ରତ୍ୟେକ subagent-ର prompt-ରେ git stash ନିଷେଧକୁ ଶବ୍ଦଶଃ ପୁନରାବୃତ୍ତି କରନ୍ତୁ (Agent ଟୁଲ୍ / Workflow ସ୍କ୍ରିପ୍ଟଗୁଡ଼ିକ) — subagent-ଗୁଡ଼ିକ ଏହି ଫାଇଲ୍କୁ ଉତ୍ତରାଧିକାରରେ ପାଆନ୍ତି ନାହିଁ, ଏବଂ ରେକର୍ଡ ହୋଇଥିବା stash ଘଟଣାର ପୁନରାବୃତ୍ତି ଏକ subagent ମାଧ୍ୟମରେ ଘଟିଥିଲା।
  • ଏହି ସେସନ୍ରେ ଆପଣ ସୃଷ୍ଟି କରିନଥିବା କୌଣସି PR-କୁ merge କିମ୍ବା push କରିବା ପୂର୍ବରୁ, git worktree list ଚଲାନ୍ତୁ ଏବଂ gh pr view <N> --json state,headRefOid ପୁନଃ ଯାଞ୍ଚ କରନ୍ତୁ (କଠୋର ନିୟମ #22b)।
  • ପ୍ରତ୍ୟେକ ସେସନ୍ ଶେଷରେ ମୁଖ୍ୟ checkout-କୁ ଏହା ଯେଉଁ branch-ରେ ଆରମ୍ଭ ହୋଇଥିଲା ସେହି branch-ରେ ରଖନ୍ତୁ।

Superpowers / ଯୋଜନା କଳାକୃତି — ପଥ ଅଧିଲେଖନ

_tasks/ ପ୍ରଥାଟି AGENTS.md → "Planning & Research Artifacts"-ରେ ପରିଭାଷିତ। superpowers skill-ଗୁଡ଼ିକ ସହିତ ଆସୁଥିବା ଡିଫଲ୍ଟଗୁଡ଼ିକ docs/…-କୁ ସୂଚାଏ — ସେହି ଡିଫଲ୍ଟଗୁଡ଼ିକୁ ଏଠାରେ ଅଧିଲେଖନ କରାଯାଇଛି। ଯେତେବେଳେ କୌଣସି superpowers skill "saved to docs/superpowers/plans/…" ପରି ଏକ ପଥ ଘୋଷଣା କରେ, ଲେଖିବା ପୂର୍ବରୁ ତାହାକୁ ସମତୁଲ୍ୟ _tasks/… ପଥରେ ପୁନର୍ଲେଖନ କରନ୍ତୁ:

କଳାକୃତି (skill) ଡିଫଲ୍ଟ (ବ୍ୟବହାର କରନ୍ତୁ ନାହିଁ) ଏହା ପରିବର୍ତ୍ତେ ଏଠାରେ ସଂରକ୍ଷଣ କରନ୍ତୁ
ଯୋଜନାଗୁଡ଼ିକ (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/ repo ଭିତରେ commit କରନ୍ତୁ (git -C _tasks …), ମୁଖ୍ୟ repo-ରେ କେବେ ନୁହେଁ।

Scratch / ଅସ୍ଥାୟୀ ଫାଇଲ୍ଗୁଡ଼ିକ — /tmp ନୁହେଁ, _artifacts/ ବ୍ୟବହାର କରନ୍ତୁ

ଏହି ପ୍ରକଳ୍ପ harness-ର ଡିଫଲ୍ଟ session scratchpad (/tmp/claude-*/…)-କୁ ଅଧିଲେଖନ କରେ। ଅସ୍ଥାୟୀ/କାର୍ଯ୍ୟରତ ଫାଇଲ୍ଗୁଡ଼ିକ — export, ଉତ୍ପାଦିତ zip, ଏକକାଳୀନ ମଧ୍ୟବର୍ତ୍ତୀ output, ଏବଂ ଆପଣ ଅନ୍ୟଥା /tmp-ରେ ରଖିଥାନ୍ତେ ଏପରି ଯେକୌଣସି ଜିନିଷ — ତାହା ପରିବର୍ତ୍ତେ /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/-ରେ ଲେଖନ୍ତୁ।

  • _artifacts/ ହେଉଛି ଏକ ମୂଳ _* ପଥ: ଏହା ପୂର୍ବରୁ gitignore କରାଯାଇଛି (AGENTS.md → "Root _* paths"), କେବଳ ଡିସ୍କରେ ରହେ, କେବେ ମଧ୍ୟ track କରାଯାଏ ନାହିଁ।
  • କାରଣ: scratch output-କୁ ପ୍ରକଳ୍ପ ଭିତରେ (/tmp ପରିବର୍ତ୍ତେ) ରଖିଲେ, ଅଳ୍ପକାଳୀନ session-specific /tmp directory-ଗୁଡ଼ିକ ଯେଉଁଗୁଡ଼ିକ ଅଦୃଶ୍ୟ ହୋଇଯାଏ କିମ୍ବା untracked ଭାବରେ ଜମା ହୁଏ, ସେଗୁଡ଼ିକରେ ଖୋଜିବା ପରିବର୍ତ୍ତେ operator ଗୋଟିଏ ସ୍ଥାନରେ ସମସ୍ତ ଅସ୍ଥାୟୀ ଜିନିଷ ସହଜରେ ଖୋଜି ଏବଂ ବିଲୋପ କରିପାରିବେ।
  • ଏହାକୁ _tasks/ ସହିତ ଭ୍ରମିତ କରନ୍ତୁ ନାହିଁ (କଠୋର ନିୟମ #23, ସ୍ଥାୟୀ ଯୋଜନା/ନିର୍ଦ୍ଦିଷ୍ଟୀକରଣ/ଗବେଷଣା/ହସ୍ତାନ୍ତର ପାଇଁ ଏହାର ନିଜସ୍ୱ ବ୍ୟକ୍ତିଗତ git repo ଅଛି) — _artifacts/ କେବଳ ବ୍ୟବହାର ପରେ ଫେଙ୍କିଦିଆଯାଇପାରୁଥିବା କାର୍ଯ୍ୟରତ ଫାଇଲ୍ଗୁଡ଼ିକ ପାଇଁ; ଏଠାରେ କୌଣସି ଜିନିଷକୁ ସଂରକ୍ଷିତ ରଖିବା କିମ୍ବା version କରିବା ଆବଶ୍ୟକ ନାହିଁ।

PR ଖୋଲିବା ପୂର୍ବରୁ base-green

କୌଣସି branch କାଟିବା କିମ୍ବା PR ଖୋଲିବା ପୂର୍ବରୁ, base-green ଯାଞ୍ଚ ଚଲାନ୍ତୁ (AGENTS.md → Git Workflow → "Base-green check"; ପ୍ରକଳ୍ପ skill-ଗୁଡ଼ିକ ଏହାକୁ .agents/skills/_shared/base-green.md ଭାବେ ସନ୍ଦର୍ଭ କରନ୍ତି)। base tip red ଥିବାବେଳେ ଖୋଲାଯାଇଥିବା PR-ର body-ରେ ⚠️ base-red inherited: #<issue> ରହିବା ଆବଶ୍ୟକ। ସଞ୍ଚିତ red ଅବସ୍ଥା (base tip + red PR-ଗୁଡ଼ିକ) ନିଷ୍କାସନ କରିବାକୁ, /sweep-reds skill ବ୍ୟବହାର କରନ୍ତୁ।