ආයුබෝවන්, තාක්ෂණික සංවර්ධකයින්! ඔබගේ ප්රොජෙක්ට් එකේ Claude කේත ඒජන්ට් (code agent) සකස් කරන විට, දෝෂ සහිත කේතයක් නිර්මාණය වීමෙන් ඔබේ වැඩ කාලය ගතවනවාද? මේකට විසඳුමක් තියෙනවා.
බොහෝ ව්යාපෘතිවල CLAUDE.md, AGENTS.md, skills (/.claude/skills/…) සහ agents (/.claude/agents/…) යන නාලිකා හතරක් පවතිනවා. ඒවා අතර එකම තොරතුරු පිටපත් කරලා තබන නිසා, එක් තැනක වෙනස්කම් කරලා අනෙක තැනට යාවත්කාලීන නොවීමෙන් “ඩ්රිෆ්ට්” සිදුවේ.
උදාහරණයක් ලෙස, අපේ UI ලයිබ්රරිය්හි CSS‑module රටාව ලියන ලද විස්තරය, බිල්ඩ් කොන්ෆිග් එකට නොගැලපෙයි. ඒක අනුව ඒජන්ට් එක රූපලාවන්ය අංග නාස්ති කරයි. තවත් උදාහරණයක් – ටෙස්ට් ටෙම්ප්ලේට් එක beforeAll වල mock සකස් කරයි, නමුත් afterEach තුළ ඒ mock නැවත සකස් කරන නිසා දෙවන ටෙස්ට් එක අසාර්ථක වෙයි.
මෙවැනි ගැටලු වලින් මිදීමට, ලේඛන එකක් කවදා ලෝඩ් වෙයි සහ කවුද ඒක අවශ්ය කරනවා යන දෙකම සලකා බලන්න. “Surface Loads” සඳහා CLAUDE.md / AGENTS.md භාවිතා කරන්න; “Skill on demand” සඳහා තනි task‑type එකකට ගැලපෙන skill ගොනුවක් තබන්න; වැඩපිළිවෙළක් හෝ ප්රතිපත්තියක් නම් agent එකක්; ඉතිරිවූ “අත්හැරිය නොහැකි” කොටසක් නම් hook එකක් ලෙස කේතයේ නියමිත ස්ථානයට තබන්න.
අවශ්ය තොරතුරු හතරේ ප්රශ්න අසන්න: 1) ෆෝල්ඩරය තුළ ඇති සියලු වෙනස්කම්ට අදාලද? – CLAUDE.md. 2) එක් වැඩකට ගැලපෙන, ගැඹුරු දැනුමක්ද? – skill. 3) රූපවාහිනියක් හෝ ක්රියාකාරීත්වයක්ද? – agent. 4) කේතයෙන් හැරවිය නොහැකි නියමයක්ද? – hook.
ඉන්පසු ලේඛන සකස් කිරීමේ නියමය සරලයි: එක් තොරතුරක් එක ගොනුවේම තබා, අනෙකුත් ගොනුවලට ඒකට ලින්ක් දෙනවා. අපි මෙය සිදු කළ පසු, CLAUDE.md / AGENTS.md ගොනු තුළ 3 පේළි පමණ නියමයන් තබා, skill ගොනුවේ ගැඹුරු රටා, agent ගොනුවේ workflow, reference doc එකේ API විස්තර යනාදීන් සකස් කළා.
ශ්රී ලංකාවට ඇති වැදගත්කම
මෙම ක්රමය ශ්රී ලංකාවේ තරුණ සංවර්ධකයන්ට කේත ලේඛන කළමනාකරණය ඉගෙන ගැනීමට ප්රායෝගික උදාහරණයක්. පාඨමාලා හෝ වැඩමුළු වලදී ඩ්රිෆ්ට් ලේඛන වලින් සිදුවන බාධක ඉක්මනින් හඳුනාගත හැකිවීම, දෝෂ හඳුනාගැනීමේ කාලය අඩු කරයි. ව්යාපාරික තලයේ, AI‑driven code agents භාවිතා කරන සමාගම්ට token පරිභෝගය 11% කින් අඩු වීම, සම්පූර්ණ පරිසරයක කාර්යක්ෂමතාව වැඩි කරයි. මෙය දේශීය තාක්ෂණ ආරම්භකයන්ට ගෝලීය AI best‑practice සමඟ සමානව වැඩ කිරීමට අවස්ථාව සලසයි.
අවසන් වශයෙන්, ලේඛන පරීක්ෂා කිරීමේ ක්රමයක් ලෙස grep භාවිතා කර, සියලු උදාහරණ කේතයේ තිබේදැයි තහවුරු කිරීම, sub‑agent එකක් මඟින් ලේඛන පමණක් ලබා දී ප්රශ්න අසීමෙන් ලැබෙන පිළිතුරු කේතයට ගැලපේදැයි පරීක්ෂා කිරීම යනාදීන් අත්හදා බැලිය හැක. මේ ක්රියාවලියෙන් ලේඛන සහ කේතය එකට ගත නොහැකි වැරදි ඉක්මනින් හඳුනාගත හැකිවීම, සංවර්ධන කණ්ඩායම්ගේ debug session කාලය ඉතා අඩු කරයි.
