Ramani na Kagua Harness yako ya Claude Code kwa harness-map

harness-map hufanya nini

harness-map husoma usanidi unaozunguka Claude Code na kuugeuza kuwa ramani moja ya mwonekano ya mkusanyiko. Usanidi huu unaozunguka, unaoitwa harness, unajumuisha faili za maagizo kama vile CLAUDE.md, kumbukumbu otomatiki, seva za MCP, ujuzi, ruhusa, hooks, sheria na mipangilio inayohusiana.

Harness inayotumika inaweza kubadilika kulingana na folda ambayo Claude Code inaanzishwa na namna wakala mpya anavyoanzishwa. Kikao kikuu, fork, wakala mdogo, wakala wa Explore au Plan, mshiriki wa timu, au ombi la claude -p linaweza kupokea taarifa tofauti. harness-map huonyesha tofauti hizi kwa kila folda ya kuanzia na mbinu iliyochaguliwa ya kuanzisha.

Mradi huu hutumia Python 3 na hauhitaji vifurushi vya ziada vya Python. Skripti zake husoma usanidi bila kuubadilisha, hutengeneza faili iliyopangwa ya harness.json, na huunda ripoti ya harness-map.html inayoweza kutazamwa kwenye kivinjari.

Vipengele muhimu

• Uchambuzi mahususi wa folda: Linganisha saraka nyingi za kuanzia unavyohitaji kwa kurudia --cwd.
• Mwonekano wa uhamishaji wa wakala: Ona ikiwa kila kipengele kimerithiwa kutoka kikao cha mzazi, kimesomwa tena kutoka kwenye faili, au hakijapitishwa kwa wakala mpya.
• Uchambuzi wa mwingiliano wa sheria: Kagua mifumo mitano ya kushughulikia sheria: uingizwaji, kuunganisha huku kunyimwa kukipewa kipaumbele, kuendesha sheria zote, kuunganisha bila kipaumbele, na kuchagua sheria moja pekee.
• Matukio ya hatari na yanayohitaji umakini: Tambua hali kama kumbukumbu otomatiki kugawanywa kulingana na folda au utendakazi wa timu kusababisha hali ya ruhusa kupitishwa kwa wakala mpya.
• Tathmini ya ukomavu: Kagua viwango vya 1 hadi 5 katika taaluma sita za harness kwenye chati ya pembe sita.
• Matokeo yanayozingatia faragha: Hifadhi metadata ya kimuundo huku ikiacha miili ya maagizo, thamani za vigeu vya mazingira, tokeni, hoja za amri na maelezo mengine nyeti.
• Utoaji unaobebeka: Bandika harness.json ya mtu mwingine kwenye kiolesura cha ripoti ili kuchora upya ramani yake.

Kabla ya kuanza

Unahitaji Python 3, Git, na ufikiaji wa usanidi wa Claude Code wa akaunti yako ya kawaida ya mtumiaji. Hakuna usakinishaji wa vifurushi kwa pip unaohitajika.

Endesha harness-map kama mtumiaji yuleyule anayeendesha Claude Code. Usitumie sudo. Uendeshaji wa msimamizi unaweza kubadilisha saraka ya nyumbani inayotumika na kufichua usanidi wa mtumiaji mwingine, hivyo skripti hukataa kuendeshwa kwa njia hiyo.

Chagua saraka halisi ambazo kwa kawaida huanzisha Claude Code kutoka humo. Kuchanganua saraka ya mzazi hakufichui usanidi wote ambao ungetumika unapoanzisha ndani ya mradi wa mtoto, kwa sababu usanidi hutatuliwa kuelekea juu kutoka kwa kila folda ya kuanzia.

Usakinishaji

Clone hazina kisha ingia kwenye saraka yake:

git clone https://github.com/Dominic-DK/harness-map.git
cd harness-map

Unaweza kuupitia mradi kwenye github.com/Dominic-DK/harness-map. Mradi unasambazwa chini ya Leseni ya MIT.

Hatua ya 1: Changanua harness yako ya Claude Code

Endesha harness-map.py ukiwa na hoja moja ya --cwd kwa kila nafasi ya kazi unayotaka kulinganisha. Amri ifuatayo huchanganua folda mbili za mfano na kuandika matokeo kwenye harness.json:

python3 harness-map.py --cwd ~/work/a --cwd ~/work/b -o harness.json

Unaweza kurudia --cwd mara nyingi kadiri inavyohitajika. Ukiiacha, harness-map huchanganua saraka ya sasa pekee:

python3 harness-map.py -o harness.json

Uchanganuzi wa awali husoma faili za usanidi na kufanya ukaguzi unaoweza kukamilishwa kutoka kwenye faili hizo na kutoka kwenye hesabu za jumla za historia ya mazungumzo.

Badilisha kipindi cha historia ya mazungumzo

Kipindi chaguo-msingi cha ujumlishaji ni siku 30. Tumia --days unapohitaji dirisha tofauti la uchunguzi. Kwa mfano, amri hii hutumia siku 90:

python3 harness-map.py --cwd ~/work/a --days 90 -o harness.json

Uchambuzi wa mazungumzo huhesabu matukio pekee. Hauinakili maandishi ya mazungumzo, maudhui ya amri, au maudhui ya faili kwenye matokeo.

Hatua ya 2: Chapisha mpango wa uchunguzi wa wakala

Baadhi ya ukaguzi huhitaji wakala kufanya majaribio yanayodhibitiwa badala ya kukagua usanidi tuli pekee. Chapisha taratibu na kanuni za usalama zinazotolewa na mradi kwa:

python3 harness-map.py --probe-plan

Soma matokeo haya kabla ya kumwomba wakala kufanya ukaguzi. Fuata maagizo yaliyotengenezwa badala ya kubuni amri za uchunguzi. Ukaguzi unaweza kujumuisha kusoma usanidi, kuhesabu matukio muhimu ya historia, na kujaribu tabia ndani ya saraka ya muda.

Hatua ya 3: Fanya au ruka uchunguzi

Mwambie wakala atekeleze mpango wa uchunguzi uliochapishwa na ahifadhi uchunguzi wake kwenye probes.json. Kila uchunguzi hurekodi kilichoendeshwa na kilichozingatiwa kama ushahidi wa kuunga mkono.

Hatua hii ni ya hiari. Usipofanya uchunguzi, kipengele kinacholingana kitaonekana kama hakijakaguliwa na kitaondolewa kwenye hesabu za viwango. Epuka kudai mwenyewe kuwa tabia imefaulu ikiwa haikuzingatiwa kwa kweli, hasa kwa ukaguzi wa kiwango cha 5.

Hatua ya 4: Unganisha matokeo ya uchunguzi

Endesha uchanganuzi tena ukitumia folda zilezile za kuanzia na uongeze --probes probes.json:

python3 harness-map.py --cwd ~/work/a --cwd ~/work/b --probes probes.json -o harness.json

Kutumia seti ileile ya --cwd huweka hesabu ya mwisho katika uwiano na nafasi za kazi zilizohusika kwenye uchanganuzi wa kwanza.

Hatua ya 5: Jenga na fungua ripoti

Tengeneza ripoti ya HTML kutoka kwenye faili ya JSON iliyokamilika:

python3 build.py harness.json

Kwenye macOS, ifungue kwa:

open harness-map.html

Kwenye Linux, tumia:

xdg-open harness-map.html

Kwenye Windows, tumia:

start harness-map.html

Kusoma ramani ya harness

Kwenye ripoti, badilisha kati ya folda za kuanzia na mbinu za uzinduzi ili kuona harness inayotumika kwa kila hali. Kwa kila kipengele, ripoti hutofautisha hali tatu za uwasilishaji:

• Agent mpya hupokea kipengele hicho moja kwa moja kutoka kwenye kipindi cha mzazi.
• Agent mpya hukisoma tena kutoka kwenye faili.
• Kipengele hicho hakipitishwi kwa agent mpya.

Ulinganisho huu husaidia kueleza kwa nini agent wawili wanaotumia hifadhi ileile wanaweza kufanya kazi kwa njia tofauti. Kwa mfano, subagent huenda asipokee kila kitu kinachopatikana kwa kipindi kikuu, huku mipangilio inayohusishwa na folda fulani ya kuanzia huenda isitumike kwingine.

Kuelewa kanuni zinazoingiliana

Ripoti pia huonyesha jinsi kanuni zinazoingiliana zinavyotatuliwa. Kulingana na aina ya usanidi, thamani ya baadaye inaweza kuchukua nafasi ya thamani nyingine, kanuni zinaweza kuunganishwa huku kukataa kukipewa kipaumbele, kila kitendo kinacholingana kinaweza kutekelezwa, maandishi yanaweza kuunganishwa bila mpangilio wa kipaumbele, au chaguo moja tu linaweza kuchaguliwa.

Kagua mwingiliano huu wakati maagizo, ruhusa, au hook inapoonekana kutofanya kazi. Huenda tatizo likawa tabia ya kuunganisha kanuni badala ya kukosekana kwa faili.

Kuelewa tathmini ya ukomavu

harness-map hupima maeneo sita kutoka kiwango cha 1 hadi kiwango cha 5:

1. Muundo wa maagizo
2. Kumbukumbu na eneo
3. Wigo wa zana
4. Uzuiaji wa mapema
5. Uthibitishaji na uonekaji baada ya kitendo
6. Muundo wa ugawaji wa kazi

Skripti inaweza kukokotoa kiotomatiki hadi kiwango cha 4 wakati data inayopatikana inaunga mkono hilo. Matokeo hurekodi masharti yaliyofaulu na mahali tathmini iliposimama. Ufafanuzi wa alama umehifadhiwa kwenye SCORECARD ndani ya harness-map.py.

Kiwango cha 5 kinahitaji ushahidi kutoka kwa ukaguzi halisi uliozingatiwa. Kwa mfano, uzuiaji wa mapema hufikia kiwango cha 5 tu wakati kuna rekodi inayoonyesha kwamba katazo lilizuia amri kwa kweli. Kuwa na katazo kwenye usanidi pekee hakutoshi.

Tathmini pia inaweza kupunguza alama wakati usanidi upo lakini unaonekana hautumiki, kama vile zana ambayo haikutumika katika kipindi cha historia kilichochaguliwa au vipindi vilivyoendeshwa kwa hali ya ruhusa tofauti na ile iliyosanidiwa.

Wakati folda kadhaa za kuanzia zinachanganuliwa, kiwango kinachoonyeshwa ni wastani wa kati wa alama za kiwango cha folda. Kwa idadi shufwa ya folda, thamani ya chini kati ya zile mbili za katikati hutumika. Ripoti pia huonyesha masafa ya chini hadi ya juu.

Viwango vya juu si bora kiotomatiki. harness-map hukadiria kiwango kinachohitajika na kila eneo kulingana na mifumo ya matumizi, ikijumuisha ikiwa unafanya kazi peke yako, mara ngapi unazindua ma-agent wasaidizi, na mara ngapi unaendesha amri ambazo ni vigumu kubatilisha. Huangazia maeneo yaliyo chini ya hitaji lililokadiriwa badala ya kuonya kuhusu kila alama iliyo chini ya kiwango cha 5.

Faragha na ukaguzi wa matokeo

Kichanganuzi husoma faili lakini hakibadilishi usanidi. Kwa makusudi hupunguza kile kinachonakiliwa kwenye matokeo yake:

• Kwa CLAUDE.md na faili za kanuni, hurekodi njia, idadi ya mistari, na wakati zinaposomwa, lakini si maandishi yake.
• Kwa mipangilio, hurekodi hali za ruhusa, idadi ya kanuni, na majina ya vigezo vya mazingira, lakini si thamani za vigezo vya mazingira au yaliyomo kwenye kanuni.
• Kwa hooks, hurekodi tukio, chanzo, na jina la faili inayotekelezeka, lakini huacha hoja za amri na njia.
• Kwa seva za MCP, hurekodi majina na vyanzo, lakini huacha amri, hoja, vichwa, na tokeni.
• Kwa njia, hubadilisha kiambishi halisi cha saraka ya nyumbani na ~.

Faili ambazo haziwezi kusomwa huwekwa kwenye orodha ya unreadable. Kulingana na mradi, Claude Code pia haiwezi kusoma faili hizo kwa kutumia ruhusa zilezile za mtumiaji.

Matokeo bado yana majina ya folda na orodha ya programu-jalizi zilizosakinishwa. Fungua na ukague harness.json na harness-map.html zote mbili kabla ya kuzishiriki.

.gitignore ya hifadhi imesanidiwa kuzuia harness.json na harness-map.html zisiingizwe kwenye udhibiti wa matoleo, lakini bado unapaswa kuthibitisha faili zilizowekwa kwenye staging kabla ya kufanya commit.

Kukabidhi mtiririko wa kazi kwa coding agent

Unaweza kumwomba Claude Code au coding agent mwingine afuate maagizo ya hifadhi. Badilisha folda za mfano kwa saraka zako za kuanzia unazotumia mara kwa mara. Ombi linalofaa ni:

Soma README kwenye https://github.com/Dominic-DK/harness-map na ufuate hatua za utekelezaji wa moja kwa moja.
Folda zangu za kawaida za kuanzia ni ~/work/a na ~/work/b.
Fanya ukaguzi wa agent wa hatua ya 3 kulingana na kanuni za usalama zilizoandikwa na urekodi matokeo.
Ukimaliza, fungua harness-map.html kwenye kivinjari na ufupishe matokeo kwa takriban sentensi tano zilizo wazi.

Dumisha usimamizi wa binadamu kwenye hatua ya uchunguzi. Agent anapaswa kufuata mpango halisi wa usalama uliotolewa na --probe-plan.

Vidokezo vya hali ya juu

Changanua kila sehemu muhimu ya kuanzia

Usidhani kwamba kuchanganua mzizi wa hifadhi kunajumuisha miradi iliyoko ndani yake. Ongeza kila saraka unayotumia kuzindua Claude Code kama --cwd tofauti. Hii hutoa ulinganisho wenye manufaa zaidi wa maagizo yaliyorithiwa, mipaka ya kumbukumbu, na upatikanaji wa zana.

Chagua kipindi cha uchunguzi kinacholingana na kazi yako

Kipindi chaguomsingi cha siku 30 kinafaa kwa shughuli za hivi karibuni, lakini zana zinazotumiwa mara chache zinaweza kuhitaji kipindi kirefu zaidi. Tumia --days kwa makusudi kwa sababu ushahidi wa kutotumika unaweza kuathiri alama ya ukomavu.

Tenganisha usanidi na tabia iliyothibitishwa

Chukulia matokeo yanayotokana na faili kama ushahidi wa usanidi uliokusudiwa, si uthibitisho kwamba udhibiti unafanya kazi wakati wa utekelezaji. Tumia uchunguzi wa hiari unapohitaji uhakika kwamba hooks, vizuizi, au tabia nyingine zinafanya kazi ipasavyo.

Linganisha ripoti bila kufichua usanidi ghafi

Mtu akikutumia harness.json iliyokaguliwa, tumia eneo la kubandika la ripoti ili kuichora upya. Ingawa thamani nyeti zimeondolewa, pande zote zinapaswa kukagua JSON kwanza kwa sababu majina ya miradi, majina ya folda, na majina ya programu-jalizi bado yapo.

Tumia njia mbadala wakati Python haipatikani

Ikiwa Python 3 haipatikani, nakili yaliyomo kwenye PROMPT.md na uyaweke kwenye agent. Agent anaweza kusoma usanidi moja kwa moja, kuunda JSON katika muundo huo huo, na kujenga skrini. README inaonya kwamba njia hii ina uwezekano mkubwa zaidi kuliko hati ya programu wa kuacha vipengee au kuvihesabu visivyo sahihi.

Vikwazo vinavyojulikana

• Kanuni za uhamishaji zimewekwa moja kwa moja katika SPAWN_RULES ndani ya harness-map.py; hazitokani na kuchunguza vipindi vyako vya moja kwa moja.
• README inasema kanuni hizi zinafuata nyaraka za Claude Code 2.1.287 zilizokaguliwa tarehe 2 Oktoba 2026. Tabia inaweza kutofautiana katika matoleo ya baadaye.
• Vyanzo vilivyonukuliwa ni nyaraka rasmi za sub-agents, agent teams, na memory.
• Mradi unaonyesha tofauti moja: nyaraka zinasema subagents hazisomi kumbukumbu ya kiotomatiki, ilhali mazingira ya mwandishi yaliripotiwa kupitisha orodha ya kumbukumbu kwa subagent. Ripoti inaashiria hili kama tofauti kati ya nyaraka na uchunguzi.
• Mipangilio ya mstari wa amri pekee kama vile --agents na --permission-mode haihifadhiwi kwenye faili, hivyo haiwezi kugunduliwa na kichanganuzi.
• Kwa programu-jalizi zilizosakinishwa, kichanganuzi husoma toleo jipya zaidi lililopatikana katika saraka ya usakinishaji wa programu-jalizi.

Hitimisho

harness-map hutoa njia ya vitendo ya kuelewa usanidi ambao Claude Code hupokea kwa hakika katika miradi na njia mbalimbali za kuzindua mawakala. Anza kwa kuchanganua kila saraka muhimu ya kazi, endesha kwa hiari uchunguzi ulioandikwa, jenga upya data kwa ushahidi huo, kisha tengeneza ripoti ya HTML. Tumia mwonekano na tathmini ya ukomavu kutafuta mapengo ya usanidi, lakini kagua faili zilizozalishwa kabla ya kuzishiriki na uchukulie kanuni zilizoandikwa za uhamishaji kuwa zinategemea toleo.