Nútímavæðing verkefnis
Tveir hamir: ÁÆTLUN og FRAMKVÆMD, og áætlunin er samningurinn — ekkert er framkvæmt fyrr en notandinn samþykkir. Grænt-í-grænt færslur, ein rökleg breyting í hverri, og þriggja-tilrauna reglan sem afturkallar í síðustu grænu stöðu í stað þess að þrjóskast.
Fyrirmæli
Þú ert að framkvæma nútímavæðingu verkefnis. Þessi fyrirmæli hafa tvo hami: ÁÆTLUN og FRAMKVÆMD. Byrjaðu í ÁÆTLUN. Farðu ekki í FRAMKVÆMD fyrr en notandinn hefur samþykkt áætlunina.
═══ HAMUR 1: ÁÆTLUN ═══
Lestu verkefnið og allar fyrirliggjandi úttektir (skýrslur um tækniskuld, yfirferðir á skjölun, högunarkort, hreinsunarskýrslur). Séu þær engar skaltu gera stutta könnun fyrst.
Skilaðu nútímavæðingaráætlun sem markdown-skrá, `MODERNIZATION_PLAN.md`, í rót verkefnisins. Áætlunin verður að innihalda:
1. GRUNNLÍNA NÚVERANDI STÖÐU
- Keyrðu prófasvítuna og skráðu: heildarfjölda prófa, staðist, sleppt, fallið
- Keyrðu úttekt á háðum pökkum (`npm audit` / `pip audit` / sambærilegt) og skráðu fjölda veikleika
- Keyrðu typecheck og skráðu fjölda villna
- Keyrðu linter og skráðu fjölda viðvarana
- Skráðu núverandi fjölda háðra pakka og hversu margir eru úreltir
2. TILLÖGUR AÐ BREYTINGUM (raðað í lotur)
Fyrir hverja lotu skaltu telja hverja breytingu með:
| # | Breyting | Skrá(r) | Áhætta | Vinna | Rökstuðningur |
Lota 1 — skjótur ávinningur (undir 30 mín hver, lítil áhætta)
Lota 2 — uppfærslur háðra pakka (minni háttar og plástrar fyrst, svo stórar útgáfur)
Lota 3 — kóðagæði (dauður kóði, brot á venjum, tagaöryggi)
Lota 4 — högun (byggingarbætur, lagfæring á lagskiptingu)
Lota 5 — prófanir og skjölun (göt í þekju, úrelt skjöl)
3. HVAÐ VERÐUR EKKI BREYTT (og af hverju)
Teldu skýrt upp það sem þú íhugaðir en hafnaðir. Það byggir traust.
4. AFTURHVARFSLEIÐ
Hvernig má snúa við ef illa fer (greinastefna, hversu fínkorna færslurnar eru).
5. ÁÆTLUÐ ÁHRIF
| Mæling | Fyrir | Áætlað eftir |
- Fjöldi prófa, hlutfall sem stenst, fjöldi veikleika, tagavillur, viðvaranir úr linter
STOPPAÐU HÉR. Skilaðu áætluninni og bíddu eftir yfirferð notandans. Ekki framkvæma neitt fyrr en notandinn segir til.
═══ HAMUR 2: FRAMKVÆMD ═══
Þegar notandinn hefur samþykkt (hann má breyta áætluninni fyrst) skaltu keyra hverja lotu:
Fyrir hverja breytingu:
1. Gerðu breytinguna
2. Keyrðu typecheck — verður að standast
3. Keyrðu prófin — verða að standast (eða skjalfestu af hverju próf þarf réttilega að breytast)
4. Vistaðu með lýsandi skilaboðum og hefðbundnu forskeyti: fix:, feat:, refactor:, deps:, test:, docs:, ci:, perf:
Reglur:
- EIN rökleg breyting í hverri færslu. Getirðu ekki lýst henni í einni setningu skaltu skipta henni.
- AÐEINS GRÆNT-Í-GRÆNT. Hver færsla verður að skilja verkefnið eftir í virku ástandi.
- ÞRIGGJA-TILRAUNA REGLAN: felli breyting prófin og þrjár tilraunir til lagfæringar mistakast skaltu `git revert` aftur í síðustu grænu stöðu, skrá bilunina og halda áfram.
- Aldrei þvinga push. Aldrei henda gagnagrunnstöflum. Aldrei eyða gögnum.
- Eftir hverjar 3–5 breytingar skaltu uppfæra `MODERNIZATION_PLAN.md` með framvindu (haka við það sem er búið).
Þegar allar lotur eru búnar skaltu skila LOKASKÝRSLU neðst í `MODERNIZATION_PLAN.md`:
| Mæling | Fyrir | Eftir | Breyting |
- Fjöldi prófa, hlutfall sem stenst, veikleikar, tagavillur, viðvaranir úr linter
- Listi yfir framkvæmdar breytingar með commit-auðkennum
- Listi yfir breytingar sem var sleppt, með ástæðum
- Ráðlögð næstu skref
TAKMARKANIR:
- Alltaf áætlun á undan framkvæmd. Áætlunin er samningurinn.
- Notandinn verður að samþykkja áætlunina áður en nokkrum kóða er breytt.
- Hver breyting verður að vera sannreynd (typecheck + próf) áður en hún er vistuð.
- Veldu minnstu breytinguna sem nær markmiðinu.
- Ekki endurskrifa kóða sem er ekki í áætluninni. Umfangsagi.
VERKEFNI TIL NÚTÍMAVÆÐINGAR:
{{Límdu inn slóð verkefnisins eða lýstu því sem þarf að nútímavæða}}
Leiðbeiningar
Run the audit prompts first (Self-Optimize, Tech Debt, Repo Clean, Doc Review) to generate findings. Then run this prompt — it reads the findings, produces a plan for your review, and only executes after you approve. You stay in control.
Ábendingar
The plan is the contract. Edit it before approving — remove changes you disagree with, reorder waves, adjust scope. The AI follows the approved plan, nothing more.
The three-strike rule prevents infinite loops. If something can't be fixed in three attempts, the AI reverts and moves on instead of burning your context window.