Kwa nini coding agents hupuuza maelekezo yako
Mawakala wa uandishi wa kanuni hupuuza maelekezo kwa sababu ya mapungufu ya context window au migongano ya data. Jifunze jinsi ya kutambua tatizo hili kabla ya kurekebisha.
Kwa nini mawakala wa uandishi wa msimbo hupuuza maelekezo yako
Mawakala wa uandishi wa msimbo hupuuza maelekezo yako kwa sababu nne, na hakuna hata moja inayotokana na wewe kuwa na adabu kupita kiasi. Kanuni hiyo haikuwepo kamwe kwenye dirisha la muktadha (context window). Kanuni hiyo ilikuwa wazi mno kiasi cha kushindwa kuthibitisha hatua dhidi yake. Kitu kingine kwenye muktadha kilipingana nayo, kwa kawaida ni msimbo ambao wakala alikuwa ameusoma punde. Au kanuni hiyo bado imepakiwa lakini iko mbali sana nyuma ya zamu ya sasa, na wakala anafanya kazi kulingana na kile kilicho karibu.
Kila sababu ina suluhisho lake, kwa hivyo kazi ya kwanza ni kuzitofautisha. Herufi kubwa na neno IMPORTANT si utambuzi wa tatizo. Mitambo iliyo hapa chini inatumia Claude Code kama mfano wa kazi, kwa sababu tabia yake ya upakiaji na ufinyanzi imeandikwa kwa kina kufikia Oktoba 2026. Zana nyingine hutofautiana katika maelezo lakini hufanya kazi kwa njia ile ile kimsingi.
Maneno mawili kwanza. Context window ni kizuizi cha maandishi ambacho modeli hukiona katika zamu fulani: maelekezo ya mfumo (system prompt), faili zako za maelekezo, mazungumzo, na kila faili ambayo wakala ameisoma. Harness ni programu inayozunguka modeli, kitu kinachosoma faili kutoka kwenye diski na kukusanya kizuizi hicho. Karibu kila malalamiko katika chapisho hili ni malalamiko kuhusu harness, si kuhusu modeli.
Faili la maelekezo ni ujumbe, siyo mpangilio
Faili la maelekezo siyo usanidi (configuration). Hakuna sehemu yoyote katika runtime inayosoma CLAUDE.md na kuitekeleza kwa lazima. Mfumo huu husoma faili hilo kutoka kwenye diski na kuingiza maandishi hayo kwenye mazungumzo. Katika Claude Code, maudhui hayo huwasilishwa kama ujumbe wa mtumiaji uliowekwa baada ya system prompt, jambo linalomaanisha kuwa modeli huona sheria zako kama inavyoona kitu kingine chochote ulichoandika.
Hali hii ina matokeo yasiyopendeza. Sheria zako hushindana na kila kipande kingine cha maandishi kwenye dirisha hilo, kwa usawa. Sheria ni madai. Faili ambalo wakala (agent) amelifungua hivi punde ni ushahidi. Pale ambapo mawili hayo yanapokinzana, ushahidi mara nyingi hushinda, na hakuna kinachotoa hitilafu (error), kwa sababu kwa mtazamo wa modeli, hakuna kitu kilichoharibika.
Nyaraka rasmi zinasema hili wazi: faili za maelekezo huchukuliwa kama muktadha (context), siyo usanidi unaotekelezwa kwa lazima. Ili kuzuia kitendo chochote bila kujali kile ambacho modeli imeamua, unahitaji hook, siyo sentensi. Shikilia mstari huo. Marekebisho mengi yaliyo mwishoni mwa chapisho hili ni mstari huo uliotumika katika kisa mahususi.
Ni faili zipi za maelekezo zinazopakiwa, na lini
Claude Code hupanda juu kupitia saraka (directory tree) kuanzia saraka uliyoiwasha. Kila CLAUDE.md na CLAUDE.local.md kuanzia kwenye mzizi wa mfumo wa faili (filesystem root) hadi kwenye saraka yako ya kazi hupakiwa kikamilifu wakati wa kuanza. Faili hizo huunganishwa kwa mpangilio huo, hivyo faili iliyo karibu zaidi na mahali ulipoanzisha programu husomwa mwisho, na ndani ya saraka moja, faili ya .local huongezwa baada ya ile kuu.
Faili zilizo kwenye saraka ndogo chini ya saraka yako ya kazi hufanya kazi tofauti. Hazipakiwi wakati wa kuanza. Hupakiwa wakati wakala (agent) anaposoma faili katika saraka hiyo. Hali hiyo ni sawa kwa sheria zilizowekewa upeo wa njia (path scoped rules) katika .claude/rules/ ambazo zina sehemu ya paths: kwenye frontmatter: huingia kwenye muktadha wakati faili inayolingana inaposomwa, si katika kila hatua. Tangu toleo la v2.1.309, faili zinazopakiwa kwa njia hii pia zina kikomo cha ukubwa kwa kila faili (herufi 40,000 kwenye dirisha la muktadha la 200K), na wakala hupokea mwanzo tu wa faili ndefu, hivyo sheria zilizo karibu na mwisho wa faili kubwa iliyopo ndani ya saraka nyingine zinaweza zisifike kamwe kwenye muktadha.
Tofauti hiyo moja inaelezea sehemu kubwa ya hitilafu zilizoripotiwa. Unaweka sheria katika packages/api/CLAUDE.md, unauliza swali kuhusu API, na wakala anajibu bila kufungua faili yoyote chini ya packages/api/. Sheria haikupuuzwa. Haikuwepo kabisa. Ikiwa hazina yako (repository) inagawanya mwongozo katika faili za maelekezo kwa kila kifurushi katika monorepo, hili ndilo jambo la kwanza la kukagua, kila wakati.
Mtego mwingine wa upakiaji huathiri hazina zilizosanifishwa kwenye AGENTS.md. Tangu toleo la v2.1.277, Claude Code husoma AGENTS.md kama maelekezo ya mradi wako kwa chaguo-msingi, lakini pale tu ambapo hakuna CLAUDE.md, .claude/CLAUDE.md au CLAUDE.local.md katika saraka yako ya kazi au saraka yoyote iliyo juu yake (faili yako ya kibinafsi ya ~/.claude/CLAUDE.md haihesabiwi). Ukiongeza mojawapo ya hizo, hata CLAUDE.local.md kwa ajili ya madokezo ya kibinafsi, Claude Code husoma faili zako za CLAUDE.md badala yake na kuiacha AGENTS.md kabisa. Ili kupakia zote mbili, weka Project instructions kuwa claude-md-and-agents-md katika /config. Kwenye matoleo ya kabla ya v2.1.277, au unapotaka kuhifadhi CLAUDE.md, daraja ni CLAUDE.md ambayo mstari wake wa kwanza ni @AGENTS.md, ambayo huleta faili hiyo wakati wa kuanza, ikiwa na madokezo yoyote mahususi ya Claude hapo chini. Symlink pia hufanya kazi unapokuwa huna kitu kingine cha kuongeza. Kuamua nini kinachopaswa kuwemo kwenye faili hiyo kimsingi ni swali tofauti, linaloshughulikiwa katika kugawanya maelekezo ya wakala kutoka kwa nyaraka za kibinadamu.
Thibitisha faili imepakiwa kabla ya kuifanyia marekebisho
Usibadilishe maandishi yoyote hadi uwe na uhakika kuwa wakala anaweza kuona faili hiyo. Kuna ukaguzi wa aina mbili, na ule rahisi hufanyika kwanza.
Tekeleza /context ndani ya session. Amri hii huchapisha dirisha la sasa likiwa limegawanywa kwa kategoria, na orodha ya Memory files hutaja kila faili ya maelekezo iliyopakiwa wakati wa kuanzisha programu. Faili ambayo haipo kwenye orodha hiyo haikupakiwa wakati wa kuanzisha, kwa hivyo chochote utakachoandika ndani yake hakitakuwa na athari hadi kitu fulani ikipakie. Faili iliyo ndani ya folda ndogo (nested file) haionekani hapo kwa sababu hupakiwa pale tu inapohitajika; inapopakiwa, mstari wa Loaded wenye njia (path) yake huonekana kwenye terminal. /memory huorodhesha maeneo ya faili na kuyafungua kwa ajili ya kuhaririwa, ikiwemo faili ambazo bado hazijaundwa.
Kwa jibu la kina zaidi, fuatilia upakiaji (log the loads). Tukio la hook la InstructionsLoaded hufanya kazi kila wakati faili ya CLAUDE.md au faili ya sheria inapoingia kwenye muktadha, na kichujio chake hukuambia sababu ya upakiaji huo: session_start, nested_traversal, path_glob_match, include, au compact. Weka hili ndani ya .claude/settings.json:
{
"hooks": {
"InstructionsLoaded": [
{
"matcher": "nested_traversal",
"hooks": [
{
"type": "command",
"command": "cat >> /tmp/instructions-loaded.log"
}
]
}
]
}
}Hook hiyo hupokea data yake kama JSON kupitia standard input, kwa hivyo cat huongeza rekodi nzima. Ifuatilie kwa kutumia tail -f /tmp/instructions-loaded.log wakati unafanya kazi. Hali ya kutoka (exit status) ya tukio hili hupuuzwa, kwa hivyo hook inaweza tu kuchunguza, haiwezi kuzuia. Ikiwa faili yako iliyo ndani ya folda haionekani kwenye log hiyo wakati wa session ambapo ulitarajia ionekane, acha kubadilisha maandishi. Tatizo ni mahali faili ilipowekwa. Isipokuwa moja: AGENTS.md ambayo Claude Code huisoma moja kwa moja haianzishi tukio hili, kwa hivyo tafuta njia yake kwenye /memory badala yake. AGENTS.md iliyoingizwa kutoka kwa CLAUDE.md huianzisha kama kawaida.
Athari za session ndefu kwenye sheria zako
Kuna athari mbili tofauti zinazojitokeza hapa, na zinahitaji majibu tofauti.
Umbali (Distance). Hadi pale compaction itakapofanyika, sheria iliyotolewa katika turn 1 bado iko ndani ya window katika turn 90, sasa ikishindana na turn 90 za maandishi ambayo ni ya karibuni zaidi na mahususi kwa kile unachokifanya sasa hivi. Mara tu compaction inapofanyika, sheria uliyoiandika kwenye chat pekee inaweza isiwe ndani ya window kabisa: nyaraka za Claude Code zenyewe zinaonya kuwa maelekezo kutoka mwanzo wa mazungumzo yanaweza kupotea, ambayo ndiyo athari ya pili hapa chini. Huwezi kuondoa umbali kupitia configuration, lakini unaweza kuupima. Tekeleza kazi ileile katika session mpya. Ikiwa sheria inafanya kazi hapo na kufeli ndani ya session ndefu, basi umbali au compaction ndiyo sababu.
Compaction. Window inapojaa, mfumo hufanya muhtasari wa mazungumzo yaliyopita na kuendelea kutoka kwenye muhtasari huo. Kinachobaki ni kile ambacho mchambuzi (summariser) alikiona kuwa muhimu, ambacho si sawa na kile unachokiona wewe kuwa muhimu. Claude Code inaelezea matokeo kwa kila utaratibu, na tofauti zake ni kubwa. Project root CLAUDE.md na sheria zisizo na scope huingizwa tena kutoka kwenye disk baada ya compaction. Auto memory huingizwa tena kutoka kwenye disk. Sheria zenye frontmatter ya paths: hupotea hadi faili linalolingana lisomwe tena. Faili za CLAUDE.md zilizopo ndani ya subdirectories hupotea hadi faili lililo ndani ya subdirectory hiyo lisomwe tena.
Panga maelekezo yako kulingana na jedwali hilo na utaona mpangilio wa udhaifu. Sheria uliyoiandika kwenye chat pekee ndiyo kitu dhaifu zaidi katika session: inadumu tu ikiwa muhtasari ulihifadhi sheria hiyo. Sheria iliyo katika packages/api/CLAUDE.md inafuata, kwa sababu ilisomwa mara moja, ikafutwa na muhtasari, na inarudi tu wakati wa usomaji unaofuata katika directory hiyo. Sheria iliyo katika faili la project root ndiyo inayodumu zaidi, kwa sababu inasomwa tena kutoka kwenye disk kila wakati.
Kwa hivyo, ikiwa maelekezo lazima yadumu kwa session nzima, yanapaswa kuwekwa katika faili la project root bila frontmatter ya paths:. Kila kitu kingine ni makubaliano (tradeoff) unayopaswa kuyafanya kwa makusudi. Kusimamia kinachobaki kwenye context window inashughulikia /compact kwa hoja ya focus na /clear kati ya kazi zisizohusiana, ambazo zote hubadilisha mara ngapi mchambuzi anapata nafasi ya kuamua sheria zako zilikuwa nini.
Kwa nini msimbo uliopo unashinda kanuni
Hii ndiyo hitilafu ambayo watu huielezea mara nyingi zaidi na kuigundua kwa uchache zaidi. Faili yako inasema ufikiaji wa hifadhidata hupitia safu ya repository. Wakala huandika handler inayoiita ORM (object relational mapper) moja kwa moja. Hukupuuzwa kwa sababu ya mtindo. Ulishindwa kwa kura kutokana na ushahidi.
Kanuni huelezea upendeleo. Msimbo huonyesha mmoja. Wakala anapofungua faili tatu kwenye moduli inayokaribia kuhaririwa na zote tatu zikaita ORM moja kwa moja, muktadha huwa na sentensi moja ya kinadharia upande mmoja na mifano mitatu ya kijasiri, ya hivi karibuni, na inayolingana na kazi upande mwingine. Kunakili mtindo wa ndani kwa kawaida ni tabia sahihi. Ni makosa hapa kwa sababu tu unajua kitu ambacho muktadha haukijui: faili hizo ni za kizamani (legacy).
Kwa hivyo, iandike hiyo kwenye kanuni. Kanuni zinazotaja ushahidi wao wa kupinga huishi baada ya kukutana na repository halisi. Kanuni zinazoeleza upendeleo mtupu hazifanyi hivyo.
Ufikiaji mpya wa hifadhidata lazima upitieapp/repositories/. Faili zilizo chini yaapp/legacy/bado zinaita ORM moja kwa moja. Huo ni msimbo wa zamani, si mtindo unaotakiwa. Usiunakili.
Sentensi ya pili ndiyo inayofanya kazi. Inamwambia wakala kile anachokaribia kukuta na jinsi ya kukisoma, kabla hajajikuta nacho. Urekebishaji huohuo unatumika kwa kanuni yoyote ambayo repository yako inapingana nayo waziwazi: mtindo wa commit ambao historia yako haufuati, mpangilio wa majaribio ambao nusu ya suite yako haufuati, au mkataba wa import unaotumika kwenye msimbo mpya pekee. Popote ambapo msimbo haukubaliani na faili, taja kutokubaliana huko ndani ya faili.
Kanuni isiyoeleweka haiwezi kukaguliwa, hivyo haiwezi kufuatwa
"Andika code safi." "Usifanye over-engineering." "Iweke rahisi." "Kuwa makini na migrations." Hakuna hata moja kati ya hizi inayoweza kupimwa dhidi ya hatua mahususi, na wakala (agent) au na wewe mwenyewe. Wakala anayepewa kanuni ambayo hawezi kuikagua dhidi ya matokeo yake anabahatisha, na wewe unakadiria ubahatishaji huo kwa hisia.
Hapa kuna jaribio la kutumia kwa kila mstari kwenye faili yako. Andika shell command ambayo itatoka (exit) kwa status isiyo ya sifuri (non-zero) wakati kanuni imevunjwa. Ikiwa huwezi kuandika command hiyo, kanuni hiyo haikaguliwi. Linganisha jozi hizi:
- Haiwezi kukaguliwa: "Weka functions ndogo." Inayoweza kukaguliwa: "Function ndefu zaidi ya mistari 60 inahitaji maelezo juu yake yakielezea kwa nini."
- Haiwezi kukaguliwa: "Jaribu mabadiliko yako." Inayoweza kukaguliwa: "Endesha
npm testna ubandike idadi ya makosa (failure count) kabla ya kusema kazi imekamilika." - Haiwezi kukaguliwa: "Weka faili zikiwa zimepangwa." Inayoweza kukaguliwa: "HTTP handlers hukaa ndani ya
src/api/handlers/. Hakuna kitu kingine kinachopaswa kuwemo kwenye saraka hiyo." - Haiwezi kukaguliwa: "Format code ipasavyo." Inayoweza kukaguliwa: "Tumia nafasi 2 (2 space indentation) katika faili za
.ts."
"Usifanye over-engineering" ndiyo kanuni ambayo watu hukata tamaa nayo kwanza, kwa sababu marekebisho yake si sentensi fupi zaidi bali ni ndefu zaidi: kufafanua maana halisi ya mabadiliko madogo zaidi yanayofanya kazi humpa wakala vigezo ambavyo anaweza kuvilinganisha na diff yake mwenyewe.
Ukubwa ni tatizo lilelile lililojivika kofia tofauti. Mwongozo wa Claude Code unalenga chini ya mistari 200 kwa kila faili ya maelekezo na unasema wazi kuwa faili ndefu hupunguza utiifu. Faili ya mistari 700 si maelekezo imara zaidi. Ni mistari 700 ya madai yenye nafasi zaidi ya kujipinga yenyewe, na inatozwa dhidi ya window yako katika kila hatua, jambo ambalo linaonekana moja kwa moja katika matumizi yako ya token. Kupanga faili ili kila kanuni ikae chini ya kichwa cha habari ambacho msomaji anaweza kukichanganua kimejadiliwa katika kuandika faili ya maelekezo ambayo wakala anaweza kuifanyia kazi. Bora zaidi, kata sehemu zinazoelezea badala ya kutoa maelekezo: ziara ya saraka ya mahali ambapo handlers na models hukaa ni muundo ambao wakala anaweza kuutafuta anapohitaji kutoka kwenye ramani iliyochanganuliwa ya repository badala ya kuibeba kwenye window katika kila hatua.
Jinsi ya kuitambua ndani ya dakika kumi
Tekeleza hatua hizi kwa mpangilio. Kurukia hatua ya mwisho ndiko kunakopelekea watu kuwa na faili ndefu ya sheria zilizopigwa kelele ambazo bado hazifanyi kazi.
- Thibitisha kuwa imepakiwa. Tekeleza
/contextna usome orodha ya faili za Memory, au kwa faili iliyo ndani ya nyingine, tafuta mstari wake waLoadedkwenye terminal. Ikiwa faili haipo, rekebisha eneo lake na usimame. Hakuna hatua nyingine katika orodha hii inayohusika kwa sasa. - Jaribu tena kwenye session mpya. Anzisha session mpya na upe kazi ndogo zaidi ambayo inapaswa kuchochea sheria hiyo. Kufanikiwa hapa lakini kufeli kwenye session ndefu kunaashiria umbali au ufinyu (compaction). Kufeli hapa pia kunamaanisha sheria yenyewe ndiyo tatizo.
- Ondoa ushindani. Omba mabadiliko yaleyale kwenye saraka (directory) ambayo msimbo wake uliopo tayari unafuata sheria hiyo. Ikiwa utiifu unarejea, msimbo unaozunguka ulikuwa ukipinga maelekezo yako.
- Tafuta mgongano. Faili mbili zinazotoa mwongozo tofauti kwa tabia ileile ni hitilafu iliyoandikwa: modeli inaweza kuchagua moja kiholela, na haitakuambia kuwa imefanya hivyo.
- Ifanye iweze kukaguliwa na ujaribu tena. Andika upya sheria hiyo kwa kutumia njia (path) mahususi na sharti fulani. Kuruka kwa kiasi kikubwa katika utiifu kunamaanisha ulikuwa umekosea uandishi.
Hatua ya 4 ni amri moja. Tafuta (grep) kila chanzo cha maelekezo kwa ajili ya mada hiyo, siyo tu faili uliyokuwa ukihariri:
grep -rni "migration" --include="CLAUDE.md" --include="CLAUDE.local.md" --include="AGENTS.md" .
grep -rni "migration" .claude/rules/ ~/.claude/CLAUDE.md ~/.claude/rules/ 2>/dev/nullMatokeo katika faili mbili zinazosema mambo tofauti ndiyo hitilafu yako. Futa moja. Usijaribu kuzipanga kwa kutumia maneno makali zaidi, kwa sababu hakuna injini ya kupanga (ranking engine) ya kukata rufaa. Kwenye Claude Code v2.1.283 au matoleo mapya zaidi, /doctor prompt-audit huendesha toleo pana zaidi la utafutaji huu katika faili zako za maelekezo, sheria na ujuzi, na kuripoti migongano pamoja na mapendekezo ya marekebisho bila kubadilisha chochote hadi utakapoomba.
Mbinu za kurekebisha, kulingana na ufanisi wake
Kila hatua hapa chini ina ufanisi mkubwa zaidi kuliko ile iliyotangulia, lakini inahitaji gharama kubwa zaidi ya usanidi. Anza juu wakati sheria ni rahisi kurekebisha. Shuka chini pale sheria inapokuwa muhimu kiasi kwamba makosa ya mara kwa mara hayakubaliki.
- Fanya sheria iwe dhahiri. Taja path, command, au sharti. Ongeza ushahidi wa kukanusha ambao wakala ataupata kwenye repository, kama ilivyoonyeshwa awali. Hii haina gharama na hutatua sehemu kubwa ya matatizo.
- Iweke karibu na kile inachokidhibiti.
CLAUDE.mdiliyowekwa ndani ya nyingine, sheria inayohusu path mahususi katika.claude/rules/, au maoni (comment) juu ya faili husika. Sheria hiyo itasomwa wakati uleule wa kusoma msimbo (code) unaohusika. Kubali matokeo: chochote kinachopakiwa kwa njia hiyo hupotea wakati wa compaction inayofuata na kurudi kwenye usomaji unaofuata unaolingana. - Hamishia utekelezaji kwenye hook. Maandishi huomba. Hook huamua. Hook huendeshwa kama msimbo wakati wa matukio maalum ya lifecycle na hutumika bila kujali kile mfano (model) unachohitimisha.
- Ipe sheria hiyo zana ya kiotomatiki (deterministic tool) na ufute maandishi. Uumbizaji (formatting), mpangilio wa import, urefu wa mstari, import zilizopigwa marufuku, umbo la commit message.
ruff format,prettier --write,eslint, hook yapre-commit. Kifaa cha kuumbiza (formatter) huwa sahihi kila wakati na hakitumii tokens. Sentensi huwa sahihi mara nyingi lakini hutumia tokens kila zamu.
Hatua ya 3 kwa ukamilifu. Tuseme faili za migration hazipaswi kuhaririwa na wakala. Iweke hii katika .claude/settings.json:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-migrations.sh"
}
]
}
]
}
}Na hii katika .claude/hooks/guard-migrations.sh:
#!/usr/bin/env bash
set -euo pipefail
path=$(jq -r '.tool_input.file_path // empty')
case "$path" in
*/migrations/*)
echo "Files under migrations/ are written by hand. Stop and ask first." >&2
exit 2
;;
esac
exit 0Endesha chmod +x .claude/hooks/guard-migrations.sh, kisha anza session mpya na umwombe wakala ahariri faili iliyo chini ya migrations/. Uhariri huo utakataliwa na ujumbe wako utarudi kama sababu. Exit status 2 kwenye PreToolUse huzuia wito wa zana (tool call) kabla haujaanza, na maandishi yako ya stderr hupewa mfano kama ujumbe wa kuzuia. ${CLAUDE_PROJECT_DIR} inarejelea mzizi wa mradi (project root), kwa hivyo hook hufanya kazi bila kujali saraka (directory) ambayo wakala yupo. Wakala hahitaji kukubaliana na sheria, kukumbuka sheria, au kuwa na sheria katika muktadha. Uhariri hautafanyika.
Kwa kizuizi cha jumla kisicho na mantiki yoyote, permissions.deny katika mipangilio yako hufanya kazi hiyo hiyo bila script ya kuhudumia, na njia za ruhusa huamua nini kinaendeshwa bila kukuuliza kwanza. Ikiwa maelekezo yanapaswa kuwa katika kiwango cha system prompt badala ya ujumbe wa mtumiaji, --append-system-prompt huiweka hapo, ingawa ni flag ya uzinduzi ambayo kila session mpya inahitaji kupitishiwa tena, jambo linalofaa zaidi kwa scripts kuliko kazi za maingiliano (interactive work).
Mambo ambayo huwezi kuyaondoa kwa maelekezo
Elewa wazi ni sehemu ipi ya kazi hii ni yako. Mpangilio, uundaji wa sentensi, migogoro kati ya faili, na ukubwa wa faili ni matatizo ya mwandishi yanayohitaji marekebisho ya mwandishi. Mengine yote ni tabia ya mfumo (model), na maneno bora zaidi hayataiondoa.
Kukubali sheria siyo kutii. Wakala atakubali sheria, atairudia kwako kwa usahihi, na kuivunja baada ya hatua mbili za kutumia zana. Kukubali huko hakugharimu chochote na hakutabiri chochote. Usikichukulie kama suluhisho, na usikihesabu kama jaribio.
Baadhi ya tabia ni sugu. Kuongeza maoni (comments), kuongeza ushughulikiaji wa makosa wa kujilinda, kuandika muhtasari wa kuhitimisha, au kuendesha amri inayofuata iliyo dhahiri. Hizi hurudi hata chini ya sheria inayozipiga marufuku, ingawa kwa kiwango kidogo badala ya sifuri. Unaweza kupima kiwango chako mwenyewe: endesha kazi ileile mara kumi katika vipindi vipya na uhesabu ukiukaji. Pale ambapo namba hiyo inahitaji kuwa sifuri, sheria hiyo lazima iondolewe kwenye prompt. Kusema kazi imekamilika wakati sehemu yake bado haijafanyika ni tabia ya aina moja, na marekebisho yake ni ya kimuundo badala ya maneno: ujuzi wa kutokuwa mvivu hubadilisha sentensi na kutumia Depth Tree pamoja na faili za kizuizi ambazo wakala lazima azimalize kabla ya kudai kazi imekamilika.
Kipindi chako mwenyewe kinakuwa mfano. Ikiwa wakala alivunja sheria katika hatua ya 12 na ukamwacha apite, ukiukaji huo sasa unakaa kwenye muktadha kama kielelezo, na ni wa hivi karibuni zaidi kuliko sheria yenyewe. Sahihisha ukiukaji wakati uleule unapoona. Ukiukaji ambao haukusahihishwa hufundisha kipindi kilichobaki.
Faili ya maelekezo siyo mpaka wa usalama. Inaunda tabia na haitekelezi kwa nguvu. Chochote ambacho kukosea kwake ni ghali, kama vitambulisho (credentials) au amri za uharibifu, ni lazima kiwekwe kwenye ruhusa (permissions) au hook. Kuweka siri mbali na uwezo wa wakala hutumia kanuni hiyo hiyo kwa data: usimwombe wakala asisome faili, panga faili hiyo isiweze kusomeka.
Toleo fupi. Thibitisha kuwa faili imepakiwa, fanya sheria iweze kukaguliwa, iweke karibu na kitu inachokiongoza, na wakati kiwango cha makosa bado ni muhimu, iondoe kwenye maandishi ya kawaida. Sheria ambayo wakala hawezi kuipuuza ni sheria ambayo haikuwahi kuombwa kwa wakala.
FAQ
Kwa nini Claude Code inapuuza faili yangu ya CLAUDE.md?
Hakikisha kuwa faili imepakiwa kabla ya kudhani imepuuzwa. Tekeleza /context na uangalie orodha ya Memory files; faili ambayo haijaorodheshwa hapo haikupakiwa wakati wa kuanzisha programu. Faili za maelekezo hutumwa kama ujumbe wa mtumiaji baada ya system prompt na huchukuliwa kama muktadha badala ya usanidi wa lazima, kwa hivyo hakuna uhakika wa kufuata maelekezo hayo kikamilifu. Mara nyingi, tatizo husababishwa na moja ya mambo haya manne: faili iko kwenye subdirectory ambayo wakala haijasoma, faili mbili zinakinzana na modeli imechagua moja kiholela, kanuni ni ya jumla sana kiasi kwamba haiwezi kutumika kukagua kitendo, au msimbo uliopo unaonyesha kinyume cha kile kanuni inachosema.
Je, kuhariri faili ya maelekezo katikati ya kipindi cha kazi hubadilisha chochote?
Hapana, kwa nakala iliyo kwenye mazungumzo ya sasa. Faili zilizo juu ya working directory yako hupakiwa kikamilifu wakati wa kuanzisha programu, kwa hivyo maandishi yaliyo kwenye kumbukumbu ya modeli ni yale yaliyokuwepo wakati wa kuanza. Ili kutumia marekebisho, anza kipindi kipya cha kazi, au mwambie wakala asome faili hiyo kwa kutumia zana zake za kawaida za faili, jambo ambalo litaingiza toleo la sasa kwenye mazungumzo kama ujumbe mpya. Baada ya compaction, faili ya root ya mradi husomwa upya kutoka kwenye diski, kwa hivyo toleo jipya hufika wakati huo pia.
Ni faili ipi inayoshinda wakati CLAUDE.md ya root na ile ya ndani zinapokinzana?
Hakuna inayoshinda kwa uhakika. Faili zinazogunduliwa huunganishwa kwenye muktadha badala ya kubatilisha nyingine, zikipangwa kuanzia root ya mfumo wa faili hadi kwenye working directory yako, kwa hivyo faili iliyo karibu zaidi husomwa mwisho. Hakuna mfumo wa kipaumbele unaotatua migongano, na nyaraka za Claude Code zinasema kuwa kanuni zinazokinzana zinaweza kutatuliwa kiholela. Andika faili za ndani kama nyongeza zinazotaja njia (path) zinazohusika, na ufute maelekezo yanayokinzana badala ya kujaribu kuifanya moja iwe na nguvu kuliko nyingine.
Je, maelekezo yangu yanabaki baada ya /compact?
Inategemea jinsi yalivyopakiwa. Faili ya root ya mradi CLAUDE.md, kanuni zisizo na upeo (unscoped), na kumbukumbu ya kiotomatiki huingizwa tena kutoka kwenye diski baada ya compaction. Kanuni zenye paths: frontmatter na faili za CLAUDE.md zilizomo kwenye subdirectories hupotea hadi faili husika isomwe tena. Chochote ulichoandika kwenye gumzo pekee kitasalia ikiwa tu muhtasari (summariser) umebahatika kukihifadhi. Ikiwa kanuni lazima idumu katika kipindi chote cha kazi, iweke kwenye faili ya root ya mradi bila paths: frontmatter.
Ni lini kanuni inapaswa kuwa hook badala ya maelezo ya kawaida?
Wakati ukaguzi ni wa kideterministi na gharama ya kukosa (miss) ni kubwa kuliko gharama ya kuandika hati ndogo (script). Vizuizi vya njia ya faili (file path), amri zinazohitajika kabla ya commit, na wito wa zana (tool calls) zilizopigwa marufuku zote zinafaa kwa hili. Hook ya PreToolUse inayotoka (exit) na status 2 huzuia wito wa zana moja kwa moja na kurudisha maandishi yako ya stderr kwa modeli kama sababu, kwa hivyo inabaki kutumika bila kujali kama kanuni bado ipo kwenye muktadha au la. Chochote kinachoweza kuamuliwa na formatter au linter kinapaswa kusimamiwa na zana hiyo na kufutwa kabisa kutoka kwenye faili ya maelekezo.