Skip to content

CLAUDE.md

Latest commit

 

History

History
75 lines (56 loc) · 11.8 KB

CLAUDE.md

File metadata and controls

75 lines (56 loc) · 11.8 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 · 🇰🇷 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 ನಲ್ಲಿ ಇವೆ — ಪ್ರತಿಯೊಂದು AI ಸಹಾಯಕಕ್ಕೂ (ಆರ್ಕಿಟೆಕ್ಚರ್, ಸಂಪ್ರದಾಯಗಳು, ಪರೀಕ್ಷೆ, ಗುಣಮಟ್ಟದ ಗೇಟ್ಗಳು, git ಕಾರ್ಯಪ್ರವಾಹ, 23 ಕಠಿಣ ನಿಯಮಗಳು, PII ಕಲಿಕೆಗಳು) ಇದೊಂದೇ ಅಧಿಕೃತ ಮೂಲ. ಅದನ್ನು ಸಂಪೂರ್ಣವಾಗಿ ಓದಿ; ಪ್ರಾಜೆಕ್ಟ್ ನಿಯಮಗಳನ್ನು ಇಲ್ಲಿ ಪುನಃ ಸೇರಿಸಬೇಡಿ. ಕೆಳಗಿನ ಎಲ್ಲವೂ Claude Code ಗೆ ಮಾತ್ರ ಅನ್ವಯಿಸುತ್ತದೆ — AGENTS.md ನಲ್ಲಿ ಈಗಾಗಲೇ ವ್ಯಾಖ್ಯಾನಿಸಿರುವ ನಿಯಮಗಳ ಕಾರ್ಯಾಚರಣಾತ್ಮಕ ಪರಿಷ್ಕರಣೆಗಳು.

ವರ್ಕ್ಟ್ರೀ ಪ್ರತ್ಯೇಕತೆ — Claude Code ನಿರ್ದಿಷ್ಟತೆಗಳು

ಕಡ್ಡಾಯವಾದ ಸಂಪೂರ್ಣ ವರ್ಕ್ಟ್ರೀ ಪ್ರೋಟೊಕಾಲ್ (base-branch ದೃಢೀಕರಣ, .claude/worktrees/ ಕೆನೊನಿಕಲ್ ಪಾತ್, cp -al node_modules, ಟಿಯರ್ಡೌನ್ ನಿಯಮಗಳು) docs/ops/WORKTREE_ISOLATION.md ನಲ್ಲಿದೆ (AGENTS.md → Git Workflow → "Worktree isolation" ನಲ್ಲಿ ಸಂಕ್ಷಿಪ್ತಗೊಳಿಸಲಾಗಿದೆ). Claude-Code-ನಿರ್ದಿಷ್ಟ ಅಂಶಗಳು:

  • ಆಪರೇಟರ್ ಈಗಾಗಲೇ ನಿಮಗೆ ಹೇಳಿಲ್ಲದಿದ್ದರೆ, AskUserQuestion ಮೂಲಕ ಆಪರೇಟರ್ನೊಂದಿಗೆ base branch ಅನ್ನು ದೃಢೀಕರಿಸಿ (Hard Rule #19).
  • ನೇರ EnterWorktree ಟೂಲ್ ಅನ್ನು ಆದ್ಯತೆ ನೀಡಿ — ಇದು ಈಗಾಗಲೇ .claude/worktrees/ (ಕೆನೊನಿಕಲ್ ಪಾತ್) ಅಡಿಯಲ್ಲಿ ವರ್ಕ್ಟ್ರೀಗಳನ್ನು ರಚಿಸುತ್ತದೆ. ದಾಖಲೀಕರಿಸಿದ git worktree add ಆಜ್ಞೆಯೊಂದಿಗೆ ವರ್ಕ್ಟ್ರೀಯನ್ನು ರಚಿಸಿ, ನಂತರ ಅದರ path ನೊಂದಿಗೆ EnterWorktree ಅನ್ನು ಕರೆಯಿರಿ.

ಸೆಷನ್ಗಳ ನಡುವಿನ ಸುರಕ್ಷತೆ — Claude Code ವಿಶೇಷತೆಗಳು

ಕಠಿಣ ನಿಯಮಗಳು #19/#21/#22 (AGENTS.md ನಲ್ಲಿ) ಸಮಾಂತರ ಸೆಷನ್ಗಳನ್ನು ನಿಯಂತ್ರಿಸುತ್ತವೆ. ಈ ಹಾರ್ನೆಸ್ಗಾಗಿ ಕಾರ್ಯಾಚರಣಾತ್ಮಕ ಜ್ಞಾಪನೆಗಳು:

  • git ಅನ್ನು ಬಳಸುವ ಪ್ರತಿಯೊಂದು ಉಪಏಜೆಂಟ್ನ ಪ್ರಾಂಪ್ಟ್ನಲ್ಲಿ git stash ನಿಷೇಧವನ್ನು ಯಥಾವತ್ತಾಗಿ ಪುನರಾವರ್ತಿಸಿ (Agent ಪರಿಕರ / Workflow ಸ್ಕ್ರಿಪ್ಟ್ಗಳು) — ಉಪಏಜೆಂಟ್ಗಳು ಈ ಫೈಲ್ ಅನ್ನು ಆನುವಂಶಿಕವಾಗಿ ಪಡೆಯುವುದಿಲ್ಲ, ಮತ್ತು ದಾಖಲಾದ stash ಘಟನೆಯ ಮರುಕಳಿಕೆಯು ಉಪಏಜೆಂಟ್ ಮೂಲಕವೇ ಸಂಭವಿಸಿತು.
  • ಈ ಸೆಷನ್ನಲ್ಲಿ ನೀವು ರಚಿಸದ ಯಾವುದೇ PR ಅನ್ನು ವಿಲೀನಗೊಳಿಸುವ ಅಥವಾ push ಮಾಡುವ ಮೊದಲು, git worktree list ಅನ್ನು ಚಲಾಯಿಸಿ ಮತ್ತು gh pr view <N> --json state,headRefOid ಅನ್ನು ಮರುಪರಿಶೀಲಿಸಿ (ಕಠಿಣ ನಿಯಮ #22b).
  • ಪ್ರತಿ ಸೆಷನ್ ಅನ್ನು ಮುಖ್ಯ checkout ಅದು ಆರಂಭಗೊಂಡ ಶಾಖೆಯಲ್ಲಿಯೇ ಇರುವಂತೆ ಮುಗಿಸಿ.

Superpowers / ಯೋಜನಾ ಆರ್ಟಿಫ್ಯಾಕ್ಟ್ಗಳು — ಪಥದ ಅತಿಕ್ರಮಣಗಳು

_tasks/ ಸಂಪ್ರದಾಯವನ್ನು AGENTS.md → "ಯೋಜನೆ ಮತ್ತು ಸಂಶೋಧನಾ ಆರ್ಟಿಫ್ಯಾಕ್ಟ್ಗಳು" ನಲ್ಲಿ ವ್ಯಾಖ್ಯಾನಿಸಲಾಗಿದೆ. 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/ repo ಒಳಗೆ commit ಮಾಡಿ (git -C _tasks …), ಮುಖ್ಯ repoದಲ್ಲಿ ಎಂದಿಗೂ ಮಾಡಬೇಡಿ.

Scratch / ತಾತ್ಕಾಲಿಕ ಫೈಲ್ಗಳು — /tmp ಅಲ್ಲ, _artifacts/ ಬಳಸಿ

ಈ ಪ್ರಾಜೆಕ್ಟ್ ಹಾರ್ನೆಸ್ನ ಡೀಫಾಲ್ಟ್ ಸೆಷನ್ scratchpad (/tmp/claude-*/…) ಅನ್ನು ಅತಿಕ್ರಮಿಸುತ್ತದೆ. ತಾತ್ಕಾಲಿಕ/ಕಾರ್ಯನಿರತ ಫೈಲ್ಗಳನ್ನು — exports, ರಚಿಸಲಾದ zips, ಒಮ್ಮೆ ಮಾತ್ರ ಬಳಸುವ ಮಧ್ಯಂತರ outputs, ಸಾಮಾನ್ಯವಾಗಿ ನೀವು /tmp ನಲ್ಲಿ ಇರಿಸುವ ಯಾವುದೇ ವಸ್ತುವನ್ನು — ಬದಲಾಗಿ /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/ ಗೆ ಬರೆಯಿರಿ.

  • _artifacts/ ಒಂದು ಮೂಲ _* ಪಥವಾಗಿದೆ: ಈಗಾಗಲೇ gitignore ಮಾಡಲಾಗಿದೆ (AGENTS.md → "ಮೂಲ _* ಪಥಗಳು"), ಕೇವಲ ಡಿಸ್ಕ್ನಲ್ಲಿ ಇರುತ್ತದೆ, ಎಂದಿಗೂ track ಮಾಡಲಾಗುವುದಿಲ್ಲ.
  • ಕಾರಣ: scratch output ಅನ್ನು ಪ್ರಾಜೆಕ್ಟ್ ಒಳಗೇ (/tmp ಬದಲು) ಇರಿಸುವುದರಿಂದ, ಅಸ್ತಿತ್ವ ಕಳೆದುಕೊಳ್ಳುವ ಅಥವಾ track ಮಾಡದೆಯೇ ಸಂಗ್ರಹಗೊಳ್ಳುವ ತಾತ್ಕಾಲಿಕ ಸೆಷನ್-ನಿರ್ದಿಷ್ಟ /tmp ಡೈರೆಕ್ಟರಿಗಳಾದ್ಯಂತ ಹುಡುಕಾಡುವ ಬದಲು, ನಿರ್ವಾಹಕರು ಎಲ್ಲಾ ತಾತ್ಕಾಲಿಕ ವಸ್ತುಗಳನ್ನು ಒಂದೇ ಸ್ಥಳದಲ್ಲಿ ಸುಲಭವಾಗಿ ಹುಡುಕಿ ಅಳಿಸಬಹುದು.
  • ಇದನ್ನು _tasks/ ನೊಂದಿಗೆ ಗೊಂದಲಪಡಿಸಬೇಡಿ (ಕಠಿಣ ನಿಯಮ #23, ಶಾಶ್ವತ ಯೋಜನೆಗಳು/ನಿರ್ದಿಷ್ಟತೆಗಳು/ಸಂಶೋಧನೆ/ಹಸ್ತಾಂತರಗಳಿಗಾಗಿ ಅದರದೇ ಖಾಸಗಿ git repo) — _artifacts/ ಕೇವಲ ಬಿಸಾಡಬಹುದಾದ ಕಾರ್ಯನಿರತ ಫೈಲ್ಗಳಿಗಾಗಿ; ಇಲ್ಲಿರುವ ಯಾವುದೂ ಉಳಿಯಬೇಕಾಗಿಲ್ಲ ಅಥವಾ ಆವೃತ್ತೀಕರಣಗೊಳ್ಳಬೇಕಾಗಿಲ್ಲ.

PRಗಳನ್ನು ತೆರೆಯುವ ಮೊದಲು Base-green

ಶಾಖೆಯನ್ನು ರಚಿಸುವ ಅಥವಾ PR ತೆರೆಯುವ ಮೊದಲು, base-green ಪರಿಶೀಲನೆಯನ್ನು ಚಲಾಯಿಸಿ (AGENTS.md → Git ಕಾರ್ಯಪ್ರವಾಹ → "Base-green ಪರಿಶೀಲನೆ"; ಪ್ರಾಜೆಕ್ಟ್ ಕೌಶಲ್ಯಗಳು ಇದನ್ನು .agents/skills/_shared/base-green.md ಎಂದು ಉಲ್ಲೇಖಿಸುತ್ತವೆ). ಮೂಲದ tip ಕೆಂಪಾಗಿರುವಾಗ ತೆರೆಯಲಾದ PR ತನ್ನ bodyಯಲ್ಲಿ ⚠️ base-red inherited: #<issue> ಅನ್ನು ಹೊಂದಿರಬೇಕು. ಸಂಗ್ರಹಗೊಂಡಿರುವ ಕೆಂಪು ಸ್ಥಿತಿಯನ್ನು (ಮೂಲದ tip + ಕೆಂಪು PRಗಳು) ನಿವಾರಿಸಲು, /sweep-reds ಕೌಶಲ್ಯವನ್ನು ಬಳಸಿ.