බැක්එන්ඩ් සංවර්ධනයේ අඳුරු පැත්තක් වන්නේ API ලේඛන නිතර නවීකරණය කිරීම. ලේඛන යාවත්කාලීන කිරීම කාලය ගත කරන වැඩක් වන අතර, නව විශේෂාංගයක් හෝ දෝෂයක් නිවැරදි කිරීමේදී එය "පසුකාලීනව" තබා දමයි.
අපේ කණ්ඩායම Voiden නමැති රෙපෝසිටරියක API ලේඛන රඳවා ඇත. ඒ රෙපෝසිටරියේ CLAUDE.md නාමක ගොනුවක් ඇත, එම ගොනුව Claude AI වෙත "නව endpoint එකක් එකතු වූ විට හෝ පවතින endpoint එකක් වෙනස් වූ විට ලේඛන යාවත්කාලීන කරන්න" යන නියෝගය දෙනවා. ඒ නිසා සංවර්ධකයා endpoint එක වෙනස් කරන තත්කාලිකයෙන්, Claude ස්වයංක්රියව ලේඛනය අලුත් කරයි.
වැඩපිළිවෙළ ඉතා සරළයි: සංවර්ධකයා කේතය වෙනස් කරයි → Claude ලේඛන වෙනස් කරයි → සංවර්ධකයා දෙකම එකවර සමාලෝචනය කර commit කරයි. මෙයින් ලේඛන වෙනත් වැඩක් ලෙස නොතේරෙයි, අමතක වීමේ අවදානම අඩුයි, පැරණි උදාහරණ හෝ අසත්ය තොරතුරු සතියකට පසු නොපවතී.
ඉතා රසවත් වශයෙන්, Voiden රෙපෝසිටරිය .void ගොනු භාවිතා කරයි. මේ ගොනු AI‑වලට කියවීමට පහසු වන අතර, Claude පමණක් නොව, අනාගතයේ වෙනත් AI හෝ LLM එකක්ද ඒ රෙපෝසිටරියට යොමු කළහොත් API, උදාහරණ, සම්මත නීති, ව්යාපෘති පසුබැසීම ඉක්මණින් අවබෝධ කරගත හැක. එමනිසා ලේඛනය මනුෂ්යයන්ට පමණක් නොව AI‑වලටද “හවුලේ” වීමක් වේ.
මෙම ක්රමය අපට AI උපදෙස් ලියන ආකාරය වෙනස් කළේය. "ලේඛන අලුත් කරන්න" කියා මතක තබාගන්න වෙනුවට, ඒ නියෝගය එකවර CLAUDE.md ගොනුවේ ඇතුළත් කර ඇත. ඉදිරියේදී ඕනෑම කාර්යයක් එම නියෝගය පිළිපදිනු ඇත, ඒ නිසා ඉතා අඩු පරිමාණ වැඩපිළිවෙළක් මගින් දිගුකාලීන ප්රශ්නයක් විසඳා ඇත.
ශ්රී ලංකාවට ඇති වැදගත්කම
- සංවර්ධකයින් – ලේඛන අලුත්වැඩියාවට වැය වන කාලය ඉතිරිව, වැඩි ප්රජාතන්ත්රික කේතය ලියන්නට අවකාශය ලැබේ.
- ඉගෙනුම් ශිෂ්යයින් – AI‑සහය ඇති ලේඛන මඟින් නව API භාවිතය ඉක්මනින් අධ්යයනය කළ හැක, පාඨමාලා වගුවක් වශයෙන් ප්රායෝගික උදාහරණ ලබාගත හැක.
- ව්යාපාර – ලේඛන අසත්ය තත්වයෙන් සිදු වන දෝෂ සහ අසමත්තා අවම කර, නිෂ්පාදන වේගය වැඩි කරයි. AI‑මූලික ලේඛන මොඩලයක් ඇතිවීමෙන්, අනාගතයේ බාහිර AI සේවා සමඟ ඒකාබද්ධ කිරීම පහසු වේ.
කෙටි වශයෙන්, AI සමඟ API ලේඛන නවීකරණය කිරීමේ කුඩා වැඩපිළිවෙළක්, සංවර්ධන කණ්ඩායම්වල ඉදිරි ගමනට නව මාර්ගයක් විවර කරයි. ඔබත් මේ ක්රමය අත්හදා බලන්න.
