AI කේතකරණ ඒජන්ට්වලට මාර්ගෝපදේශයක් වශයෙන් භාවිතා කරන AGENTS.md ගොනුව, රෙපෝ එකේ වෙනස්කම් සමඟ අලුත් නොවන්නේ නම්, එය ඉක්මනින් පරණවී යයි. ගොනුවේ විධාන, පරීක්ෂණ, රැකවරණ නීති ආදිය අස්ථාවරව පවතී නම්, ඒජන්ට්වල විශ්වාසය අඩු වෙයි.
මෙම ගැටලුවට විසඳුමක් ලෙස agents-md-facts නමැති CLI උපකරණය හඳුන්වා දෙන ලදී. මෙය රෙපෝ එකේ package.json, pyproject.toml, Cargo.toml හෝ go.mod වැනි සැබෑ කොන්ෆිග්රේෂන් ගොනු පරීක්ෂා කර, ඒවායේ සත්ය තොරතුරු පදනම් කරගෙන AGENTS.md ගොනුවේ කළමනාකරණ කොටසක් (managed block) ස්වයංක්රීයව ලියයි.
භාවිතා කරන ක්රමය පහත පියවරවලින් ගොඩනැගේ:
- Dry‑run:
npx agents-md-facts --dry-runවිධානයෙන් පළමුව සැලසුම බැලිය හැක. මෙය රෙපෝ එකේ සැබෑ සෙටප්, බිල්ඩ්, ටෙස්ට් ආදිය පෙන්වා දෙයි; ඔබට මෙය වැරදි නම්, මුලින්ම ස්ක්රිප්ට් හෝ කොන්ෆිග්රේෂන් යාවත්කාලීන කළ යුතුය. - Author/Refresh:
npx agents-md-factsක්රියාත්මක කිරීමෙන් AGENTS.md ගොනුවේසහටැග් අතර අලුත් කළමනාකරණ අන්තර්ගතය ලියයි. මෙම කොටස පළාත්ය වශයෙන් වෙනස් නොවේ; ඔබගේ අතිරේක සටහන්, උපදෙස්, “මිනිස්කෙනෙකුට පමණක් සලස්විය යුතු” කියුම් වැනි දේවල් එම ටැග් වලින් පිටත තබා ගත හැක. - Agent‑ready read: AGENTS.md ගොනුව විවෘත කර, එහි ලිඛිත විධාන, පරීක්ෂණ, නීති ආදිය AI ඒජන්ට්ටුට පරිච්ඡේදයක් ලෙස භාවිතා කරන්න. මෙය Node/TS වැනි උදාහරණයක් මත පදනම්ව සකස් කර ඇත.
මෙම ක්රියාවලියෙන් ලැබෙන ප්රධාන වාසිය නම්, AI ඒජන්ට්ටුට “පැරණි ස්ක්රිප්ට්” හෝ “අතුරුදන් වූ පාර” ගැන අසත්ය තොරතුරු ලබා නොදීමයි. ඒ නිසා කේත ලිවීමේ දෝෂ, අධික පිරිවැය, සහ අසාර්ථක වැඩ පිළිවෙළක් වළක්වා ගත හැක. තවත් වැදගත් කරුණක් නම්, AGENTS.md ගොනුවේ සියලුම ලයින් සැබෑ රෙපෝ තොරතුරු වලට සම්බන්ධ වන බැවින්, “පැතිකඩ” වැනි අතුරුදන් වීමක් නොමැත.
ශ්රී ලංකාවට ඇති වැදගත්කම
- විදුහල්පති සහ සිසුන් – AI‑සහයෝගී කේත ලිවීමේ පරීක්ෂණ වශයෙන් AGENTS.md භාවිතා කිරීමෙන්, පළපුරුදු නොවන සිසුන්ටත් නිවැරදි සෙටප් ක්රමයක් ඉක්මනින් ලබාගත හැක.
- දේශීය සංවර්ධකයින් – රෙපෝ එකේ සත්ය තොරතුරු මතම මාර්ගෝපදේශ ලිවීම නිසා, දෝෂ සහ අසත්ය විධාන නිසා සිදුවන වැඩ කාලය අඩු වේ.
- ව්යාපාරිකයන් – AI ඒජන්ට්ටුගේ විශ්වාසය වැඩි වීමෙන්, CI/CD පද්ධති ස්වයංක්රීය කිරීමේ ආරක්ෂිතම තත්ත්වයක් ලැබේ; මෙය වියදම් අඩු කිරීමේ හා නිෂ්පාදන කාලය කෙටි කිරීමේ අරමුණට ගැලපේ.
අවසානයේ, agents-md-facts CLI එක ඔබේ රෙපෝට සත්ය තොරතුරු පදනම් කරගෙන AGENTS.md ගොනුව ස්වයංක්රීයව නවීකරණය කරයි. ඒජන්ට්ටුට “පරණ” විධාන දැනුම් දීමේ අවදානම ඉවත් කර, කේත සංවර්ධනයේ කාර්යක්ෂමතාවය වැඩි කරයි. ඔබේ ව්යාපෘතියේ AGENTS.md ගොනුව අලුත් කර, AI සමඟ වැඩ කිරීමේ අලුත් යුගයක් අරඹන්න.
