🌐 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 · 🇮🇳 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
Alle prosjektregler finnes i AGENTS.md — den eneste autoritative kilden for alle
AI-assistenter (arkitektur, konvensjoner, testing, kvalitetsporter, git-arbeidsflyt, de 23 harde reglene,
lærdom om PII). Les hele filen; ikke legg til prosjektreglene her på nytt. Alt nedenfor gjelder KUN
for Claude Code — operasjonelle presiseringer av regler som allerede er definert i AGENTS.md.
Hele den obligatoriske worktree-protokollen (bekreftelse av basisgren, .claude/worktrees/ som
kanonisk sti, cp -al node_modules, regler for opprydding) finnes i
docs/ops/WORKTREE_ISOLATION.md (oppsummert i AGENTS.md →
Git-arbeidsflyt → "Worktree-isolering"). Punkter spesifikke for Claude Code:
- Bekreft basisgrenen med operatøren via
AskUserQuestion(hard regel nr. 19), med mindre de allerede har fortalt deg det. - Foretrekk det innebygde
EnterWorktree-verktøyet — det oppretter allerede worktrees under.claude/worktrees/(den kanoniske stien). Opprett worktree-en med den dokumentertegit worktree add-kommandoen, og kall deretterEnterWorktreemed tilhørendepath.
Harde regler nr. 19/21/22 (i AGENTS.md) regulerer parallelle økter. Operasjonelle påminnelser for dette
kjøremiljøet:
- Gjengi forbudet mot
git stashordrett i ledeteksten til hver underagent som berører git (Agent-verktøy / arbeidsflytskript) — underagenter arver ikke denne filen, og den registrerte gjentakelsen av stash-hendelsen skjedde via en underagent. - Før du fletter eller pusher til en PR du ikke opprettet i denne økten, kjør
git worktree listog kontrollergh pr view <N> --json state,headRefOidpå nytt (hard regel nr. 22b). - Avslutt hver økt med hovedutsjekkingen på grenen den startet på.
Konvensjonen for _tasks/ er definert i AGENTS.md → «Planleggings- og forskningsartefakter».
Superpowers-ferdighetene leveres med standardverdier som peker til docs/… — disse standardverdiene er overstyrt
her. Når en Superpowers-ferdighet oppgir en sti som «lagret i docs/superpowers/plans/…»,
skal den skrives om til tilsvarende sti under _tasks/… før lagring:
| Artefakt (ferdighet) | Standard (skal IKKE brukes) | Lagre her i stedet |
|---|---|---|
Planer (writing-plans) |
docs/superpowers/plans/ |
_tasks/superpowers/plans/YYYY-MM-DD-<feature>.md |
Spesifikasjoner / design (brainstorming) |
docs/superpowers/specs/ |
_tasks/superpowers/specs/YYYY-MM-DD-<topic>-design.md |
Forskning (deep-research, ad hoc) |
docs/research/ |
_tasks/research/… |
Overleveringer (/handoff) |
— | _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/ |
Commit disse artefaktene i _tasks/-repoet (git -C _tasks …), aldri i hovedrepoet.
Dette prosjektet overstyrer kjøremiljøets standardområde for midlertidige øktfiler (/tmp/claude-*/…). Skriv
midlertidige filer og arbeidsfiler — eksporter, genererte zip-filer, midlertidige mellomresultater, alt du
ellers ville lagt i /tmp — til /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/ i stedet.
_artifacts/er en_*-sti i roten: den er allerede ignorert av git (AGENTS.md→ «_*-stier i roten»), finnes kun på disken og spores aldri.- Begrunnelse: Når midlertidige resultater oppbevares i prosjektet (i stedet for
/tmp), er det enkelt for operatøren å finne og slette alt midlertidig på ett sted, i stedet for å lete gjennom flyktige, øktsspesifikke/tmp-kataloger som forsvinner eller samler opp usporede filer. - Ikke forveksle dette med
_tasks/(hard regel nr. 23, dets eget private git-repo for varige planer/spesifikasjoner/forskning/overleveringer) —_artifacts/er kun for midlertidige arbeidsfiler; ingenting her trenger å bevares eller versjoneres.
Før du oppretter en gren eller åpner en PR, kjør kontrollen for grønn basis (AGENTS.md → Git-arbeidsflyt →
«Kontroll av grønn basis»; prosjektferdighetene refererer til den som .agents/skills/_shared/base-green.md). En PR
som åpnes mens spissen av basisgrenen er rød, må inneholde ⚠️ base-red inherited: #<issue> i beskrivelsen. For å
rydde opp i en oppsamlet rød tilstand (spissen av basisgrenen + røde PR-er), bruk ferdigheten /sweep-reds.