🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇮🇩 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-ում՝ ճշմարտության միակ աղբյուրը յուրաքանչյուր AI
օգնականի համար (ճարտարապետություն, պայմանավորվածություններ, թեստավորում, որակի ստուգիչներ, git աշխատանքային հոսք, 23 Խիստ կանոնները,
PII-ի վերաբերյալ քաղած դասերը)։ Ամբողջությամբ կարդացեք այն. այստեղ կրկին մի՛ ավելացրեք նախագծի կանոնները։ Ստորև նշված ամեն ինչ վերաբերում է ՄԻԱՅՆ
Claude Code-ին՝ AGENTS.md-ում արդեն սահմանված կանոնների գործառնական ճշգրտումներ։
Պարտադիր worktree արձանագրության ամբողջական նկարագրությունը (բազային ճյուղի հաստատում, .claude/worktrees/ կանոնական
ուղի, cp -al node_modules, քանդման կանոններ) գտնվում է
docs/ops/WORKTREE_ISOLATION.md-ում (ամփոփված է AGENTS.md-ում →
Git աշխատանքային հոսք → "Worktree մեկուսացում")։ Claude Code-ին հատուկ կետեր․
- Հաստատեք բազային ճյուղը օպերատորի հետ
AskUserQuestion-ի միջոցով (Կոշտ կանոն #19), եթե նա արդեն չի հայտնել ձեզ։ - Նախապատվություն տվեք ներկառուցված
EnterWorktreeգործիքին — այն արդեն ստեղծում է worktree-ներ.claude/worktrees/ուղու ներքո (կանոնական ուղին)։ Ստեղծեք worktree-ն փաստաթղթավորվածgit worktree addհրամանով, ապա կանչեքEnterWorktree-ն՝ փոխանցելով դրաpath-ը։
Խիստ կանոնները #19/#21/#22 (AGENTS.md-ում) կարգավորում են զուգահեռ սեսիաները։ Գործառնական հիշեցումներ այս
միջավայրի համար՝
- Բառացիորեն կրկնեք
git stash-ի արգելքը git-ին առնչվող յուրաքանչյուր ենթագործակալի հրահանգում (Agent գործիք / Workflow սկրիպտներ). ենթագործակալները չեն ժառանգում այս ֆայլը, իսկ stash-ի միջադեպի արձանագրված կրկնությունը տեղի է ունեցել ենթագործակալի միջոցով։ - Նախքան այս սեսիայի ընթացքում ձեր կողմից չստեղծված որևէ PR-ի միավորումը կամ push կատարելը՝ գործարկեք
git worktree listև կրկին ստուգեքgh pr view <N> --json state,headRefOid(Խիստ կանոն #22b)։ - Յուրաքանչյուր սեսիա ավարտեք՝ հիմնական checkout-ը թողնելով այն ճյուղում, որտեղից այն սկսվել էր։
_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, ad-hoc) |
docs/research/ |
_tasks/research/… |
Փոխանցումներ (/handoff) |
— | _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/ |
Commit արեք այդ արտեֆակտները _tasks/ ռեպոզիտորիում (git -C _tasks …), երբեք՝ հիմնական ռեպոզիտորիում։
Այս նախագիծը վերասահմանում է միջավայրի լռելյայն սեսիոն սևագրատախտակը (/tmp/claude-*/…)։ Ժամանակավոր/աշխատանքային
ֆայլերը՝ արտահանումներ, գեներացված zip-եր, մեկանգամյա միջանկյալ արդյունքներ և այն ամենը, ինչ այլապես կտեղադրեիք
/tmp-ում, գրեք /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/-ում։
_artifacts/-ը արմատային_*ուղի է. այն արդեն անտեսվում է git-ի կողմից (AGENTS.md→ "Root_*paths"), գտնվում է միայն սկավառակի վրա և երբեք չի հետագծվում։- Պատճառը. սևագիր արդյունքը նախագծի ներսում պահելը (
/tmp-ի փոխարեն) օպերատորին թույլ է տալիս հեշտությամբ գտնել և ջնջել բոլոր ժամանակավոր նյութերը մեկ վայրից՝ անցողիկ, սեսիային հատուկ/tmpպանակներում փնտրելու փոխարեն, որոնք անհետանում են կամ կուտակում չհետագծվող ֆայլեր։ - Սա մի՛ շփոթեք
_tasks/-ի հետ (Խիստ կանոն #23, դրա առանձին մասնավոր git ռեպոզիտորին՝ երկարաժամկետ պլանների/սպեցիֆիկացիաների/հետազոտությունների/փոխանցումների համար)._artifacts/-ը նախատեսված է միայն դեն նետվող աշխատանքային ֆայլերի համար, այստեղ ոչինչ չպետք է պահպանվի երկարաժամկետ կամ տարբերակավորվի։
Նախքան ճյուղ ստեղծելը կամ PR բացելը՝ գործարկեք բազայի կանաչ լինելու ստուգումը (AGENTS.md → Git Workflow →
"Base-green check". նախագծի հմտություններն այն հղում են որպես .agents/skills/_shared/base-green.md)։ Եթե PR-ը
բացվել է այն ժամանակ, երբ բազային ճյուղի վերջին commit-ը կարմիր է, դրա նկարագրությունը պետք է պարունակի ⚠️ base-red inherited: #<issue>։ Կուտակված կարմիր վիճակը
(բազային ճյուղի վերջին commit + կարմիր PR-ներ) վերացնելու համար օգտագործեք /sweep-reds հմտությունը։