ඔබේ කේත පද්ධතියේ ලුහුබැඳි බග් එකක් හඳුනාගත් විට, එය "කොහොමද" යන්නට පමණක් නොව "ඇයි" යන්නටත් පිළිතුරු දෙන්න ඕන. මැයි 2026 දී එක් කෝපි ගනුදෙනුවක් වැරදි ගණනකින් සීමා වූ පසු, ලේඛකයා සහ Claude AI එකට "Trace Lock" නමැති නව ක්රමයක් සොයාගෙන ගියේය.
කොහොමද බග් එක සිදු වුනේ කියන්නම්: පසුබැසීමේ දත්ත (244 g) නිවැරදිව products.stock_virtual_grams ට ලියන ලද්දේ, ඉදිරිපස එය කියවූ නමුත් බඩු වර්ගයේ (half‑pound) ග්රෑම් අගය (227 g) භාවිතා කරමින් ගණනය කළ නිසා 2 බෑග් වෙනුවට 1ක් පමණක් පෙන්වුණා. ඒ වගේම, පසුගිය හය මාස තුළ තවත් නළල‑අතර සම්බන්ධතා වැරදි 5ක් හමු වුණා.
මෙවැනි "cross‑layer contract drift" බග් ගණනාවක් එකතු වීමේ හේතුව, ලියන පැත්ත (write‑side) සිට පෙන්වන පැත්ත (render‑side) දක්වා දත්ත ගමන් කරන අතරමඟේ එකක් හෝ දෙකක් සමඟ සමානකාරී නොවීමයි. කණ්ඩායම් වල code review, SRE, QA වැනි පිරිසක් මේ වැරදි අල්ලා ගනී, නමුත් තනි සංවර්ධකයෙකුට මේවා මතකයෙන් පිටුපසට යනවා.
Claude සමඟ සිතුවේ, මෙම සම්බන්ධතා මතකයෙන් ඉවත් කර, කේත ගබඩාවේ දැකගත හැකි ලේඛන (artifact) ලෙස සුරකින්න. එයින්ම "Trace Lock" උපන්වා. එක් Trace එකක් පහත පරිදි 5 artefact වලින් සම්පූර්ණ වේ:
- Artifact 1 – Registry: markdown වගුවක්, එක් පේළියක් එක් Trace එකක්. ID, Anchor (SSOT), Trace nodes, Why, Last edited වැනි තොරතුරු ඇත.
- Artifact 2 – Fuse test: Anchor function එකේ වර්තමාන නිවැරදි හැසිරීම පරීක්ෂා කරන පිනින් test එක. "Correct now" කියන්නේ "future‑proof" නොවෙයි.
- Artifact 3 – Governance rule: data flow එකේ සීමා, validation, transformation නියම කරන නීතිය. මෙය CI/CD pipeline එකේ enforce කරයි.
- Artifact 4 – Documentation snippet: කෙටි, සරල විස්තරයක්, කේත comments හෝ README එකේ රැඳී, කවුරුන්දෙත් තේරුම් ගැනීමට ඉඩ දේ.
- Artifact 5 – Ownership record: ඒ Trace එකේ අයත් ව්යාපෘතිය, කණ්ඩායම, සහ අලුත් කරන අයගේ නාමය ලියා තබා, කාලයත් සමඟ පරීක්ෂා කරයි.
මෙම 5 artefact සකස් කිරීමෙන්, එක Trace එකක් lock කිරීමේ කාලය සාමාන්යයෙන් 30‑60 මිනිත්තු අතර වේ. ඒ කියන්නේ, මීළඟට ඔබට හෝ AI tool එකට එම සම්බන්ධතාවය තේරුම් ගැනීමට, ගොනුව ගොනුව සෙවීමට නොව, registry එකක් බලලාම ඉක්මනින් පිළිතුරු ලැබේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ තරුණ සංවර්ධකයින්, ස්වයං අධ්යයන කරුවන්, සහ තරුණ ව්යාපාරිකයින්ට Trace Lock එකේ ප්රයෝජනය විශාලයි. පළමු වරට, කේතයේ data flow එකේ ගැටළු මතකයෙන් ඉවත් කර, ලේඛන‑පදනම් අධික්ෂේපයක් ලබා දෙන නිසා, වැඩිදුරටත් bugs ගණන අඩු වේ. දෙවනුව, AI pair‑programming tools (Claude, GitHub Copilot) සමඟ ඒ artefact ගොඩනැගීමේදී, ඒ tools වලට ඉතිහාසය තේරුම් ගැනීමට පහසු වේ – අලුත් ප්රොජෙක්ට් එකකට ගොඩනැගීමේදී “පෙර කරපු දේ” එකක් නොමැතිව පසුබැසීමක් නොවේ.
ඉතිරියට, කේත පාලනය (governance) සහ test coverage වැඩිවීම නිසා, ලොකල් වෙළෙඳපොළේ නිෂ්පාදන, e‑commerce, fintech වැනි ක්ෂේත්රවල reliability ඉහළ යයි. මෙය ශ්රී ලංකාවේ තාක්ෂණික ආර්ථිකයට විශ්වාසය ගොඩනැගීමට, ආයෝජකයින්ට ආකර්ෂණීය වීමට, සහ අපේ තරුණයින්ට ජාත්යන්තර මට්ටමේ best practice එකක් අරගෙන වැඩ කිරීමට මඟ පෙන්වයි.
අවසන් වශයෙන්, Trace Lock එක ඔබේ කේතයෙහි “අඳුරු” කොටස් දෘශ්යම කරයි, ඒ නිසා අනාගතයේදී අලුත් සංවර්ධකයෙක් හෝ AI tool එකත් එක්ක වැඩ කරන විට, එකම තොරතුරක් දෙකේම අඩංගු වේ. මේකෙන් bugs අඩු වෙයි, සංවර්ධන වේගය වැඩි වෙයි, සහ ඔබේ පද්ධතිය තවත් ආරක්ෂිත වේ.
