ஒரு டெவலப்பர் பல மாதங்களாகப் பயன்படுத்தி வந்த Claude Code பணிப்பாய்வை (workflow) OpenCode-க்கு மாற்றியபோது, கோப்பு கையாளுதல் (file handling), விதிகள் ஏற்றுதல் (rule loading), கருவி இருப்பு (tool inventory), திறன் மெட்டாடேட்டா (skill metadata) மற்றும் குறுக்கு-அமர்வு நினைவகம் (cross-session memory) ஆகிய அனைத்தும் செயலிழப்பதைக் கண்டறிந்தார். அவர் ஆவணப்படுத்திய இந்தத் தீர்வுகள், Claude சூழலில் இருந்து திறந்த மூல (open-source) மாற்றத்திற்கு மாறுபவர்களுக்கு ஒரு நடைமுறை சரிபார்ப்புப் பட்டியலாக (checklist) இப்போது பயன்படுகின்றன.
ஏன் இந்த இடமாற்றம் முக்கியமானது
Claude Code பயனர்கள், ஒரு AI-ஆல் இயக்கப்படும் கோடிங் உதவியாளரைத் தடையின்றி இயக்க விதிகள் (rules), திறன் வரையறைகள் (skill definitions) மற்றும் நினைவகப் பதிவுகள் (memory logs) போன்ற ஒரு தொகுக்கப்பட்ட கோப்புகளைச் சார்ந்துள்ளனர். ஆசிரியரின் அமைப்பு விதிகளை ஏற்றுவதை நிறுத்தி, கோப்புகளைக் குழப்பிக் கொண்டதோடு, token பயன்பாடும் அதிகரித்ததால், அவரது அன்றாட கோடிங் உதவியாளர் நம்பகத்தன்மையற்றதாக மாறியது. OpenCode "அனுமதி சார்ந்த பாதுகாப்பு" (permission-first security), OpenRouter மூலம் மாடல் சாராத அணுகல் (model-agnostic access) மற்றும் பயன்படுத்தியதற்கு மட்டும் பணம் செலுத்தும் (pay-as-you-go) விலை நிர்ணயம் ஆகியவற்றைத் தருவதாகக் கூறி ஈர்க்கிறது. ஆனால் இந்த மாற்றம் ஒரு எளிய நகலெடுப்பு (copy-paste) அல்ல; OpenCode எதிர்பார்க்கும் வடிவத்தில் ஒவ்வொரு அங்கத்தையும் நீங்கள் மீண்டும் அறிவிக்க வேண்டும்.
உடைப்பு ஏற்படக் காரணமானவை
Claude Code, CLAUDE.md என்ற கோப்பைப் பயன்படுத்தியது, ஆனால் OpenCode அதைத் தவிர்த்துவிட்டு, கூடுதல் மெட்டாடேட்டாவிற்காக AGENTS.md ஐப் படிக்கிறது. இந்த இரண்டு அமைப்புகளும் ஒன்றிற்குப் பதில் ஒன்று பயன்படுத்தக்கூடியவை என்று ஆசிரியர் நினைத்ததால், பல முக்கியத் தகவல்கள் OpenCode-க்குத் தெரியாமல் போயின.
நேரடித் தோல்விகள் மற்றும் அவற்றைச் சரிசெய்யும் முறை
விதி கோப்பு புறக்கணிக்கப்படுகிறது (Rules file ignored)
OpenCode ஒருபோதும் CLAUDE.md ஐப் படிப்பதில்லை; அது AGENTS.md ஐ மட்டுமே பகுப்பாய்வு செய்கிறது. கோப்பின் பெயரை மாற்றுவது மட்டும் போதாது, ஏனெனில் உள்ளடக்கத்தை புதிய வடிவத்தில் மீண்டும் அறிவிக்க வேண்டும்.
Fix: ஒரு புதிய AGENTS.md ஐ உருவாக்கி, விதிகளின் உரையை நகலெடுக்கவும், புதிய OpenCode அமர்வைத் தொடங்கி ஏஜென்ட்டிடம் “எனது விதிகள் என்ன?” என்று கேட்கவும். அதால் விதிகளைக் கூற முடியாவிட்டால், விதிகள் ஏற்றப்படவில்லை என்று அர்த்தம்.கருவி இருப்பு காணவில்லை (Tooling inventory missing)
திறன்கள் மற்றும் MCP (multi-cloud platform) சர்வர்களை நகலெடுக்க வேண்டியிருந்த இடமாற்றக் கட்டளை (migration command) தோல்வியடைந்தது, ஏனெனில் பதிவு செய்யப்படாத கருவிகளின் இருப்பைக் கண்டறிய OpenCode-ஆல் முடியாது.
Fix: Claude Code கருவிகள் இன்னும் இயங்கிக் கொண்டிருக்கும்போதே, ஒவ்வொரு திறனையும் கட்டளையும் (command) ஒவ்வொன்றையும் கைமுறையாகப் பட்டியலிடவும். எவற்றை OpenCode-இல் மீண்டும் உருவாக்க வேண்டும் மற்றும் எவற்றைத் தவிர்க்க வேண்டும் என்பதைத் தீர்மானிக்கவும்.திறன்களிலிருந்து front-matter நீக்கப்படுகிறது (Front-matter stripped from skills)
மாற்றப்பட்ட திறன் கோப்புகள் (skill files), மாடல் ஒதுக்கீடு மற்றும் கருவி கையாளுதல் வழிமுறைகள் உள்ளிட்ட அவற்றின் front-matter-ன் பெரும்பகுதியை இழந்தன. OpenCode ஒரு சில புலங்களை (fields) மட்டுமே மதிக்கிறது, எனவே இறக்குமதி செய்யப்பட்ட திறன்கள் கணிக்க முடியாத வகையில் செயல்பட்டன.
Fix: இறக்குமதி செய்யப்பட்ட ஒவ்வொரு திறனையும் பழுதானதாகக் கருதுங்கள். மிகவும் பயன்படுத்தப்படும் மூன்று திறன்களை ஆரம்பத்திலிருந்து மீண்டும் உருவாக்குங்கள், அவை ஆதரிக்கப்படும் புலங்களை மட்டுமே கொண்டுள்ளதை உறுதி செய்யவும். பயன்படுத்தப்படாத திறன் கோப்புகளை நீக்கவும்.குறுக்கு-அமர்வு நினைவகம் இல்லை (No cross-session memory)
Claude Code ஒரு நிலையான வரலாற்றைப் (persistent history) பராமரித்தது, அதை ஆசிரியர் சூழலுக்காக (context) நம்பியிருந்தார். OpenCode அமர்வுகளுக்கு இடையே நினைவகத்தைப் பராமரிப்பதில்லை, எனவே மாற்றத்திற்கு அடுத்த நாள் உதவியாளர் அனைத்தையும் “மறந்துவிட்டது”.
Fix: AGENTS.md இல் ஒரு தெளிவான அறிவுறுத்தலைச் சேர்க்கவும்: “ஒவ்வொரு அமர்வின் முடிவிலும், என்ன செய்யப்பட்டது, என்ன நிலுவையில் உள்ளது மற்றும் எடுக்கப்பட்ட முடிவுகள் ஆகியவற்றை உள்ளடக்கிய ஒரு சிறிய சுருக்கத்தை session-log.md இல் இணைக்கவும்.” இதன் மூலம் அமர்வுப் பதிவு (session log) தொடர்ச்சிக்குத் தேவையான ஒரே உண்மையான ஆதாரமாக மாறும்.
stakes: நீங்கள் எதை வெல்கிறீர்கள் மற்றும் எதை இழக்கிறீர்கள்
வெற்றிகள் (Wins)
- Permission-first security: OpenCode எந்தவொரு செயலையும் செய்வதற்கு முன் அனுமதி கேட்கிறது, இது தற்செயலான குறியீடு மாற்றங்களைக் குறைக்கிறது.
- Model freedom: ஒரு ஒற்றை API key மூலம் OpenRouter வழியாகப் பல மாடல்களைப் பயன்படுத்தலாம், இது உங்கள் உள்ளமைவு கோப்புகளை (configuration files) மாற்றாமலேயே சோதனைகளைச் செய்ய அனுமதிக்கிறது.
- Cost control: கட்டணம் பயன்பாட்டின் அடிப்படையில் உள்ளது, இது token பயன்பாடு அதிகரிக்கும் போது அதிக செலவாகும் நிலையான சந்தா முறையைத் தவிர்க்கிறது.
இழப்புகள் (Losses)
- உள்ளமைக்கப்பட்ட நீண்டகால நினைவகம் இல்லாததால், நீங்கள் கைமுறையாக ஒரு பதிவைப் (log) பராமரிக்க வேண்டும்.
- வரையறுக்கப்பட்ட திறன் மெட்டாடேட்டா (skill metadata), உங்கள் பெரும்பாலான தனிப்பயன் கருவிகளை மீண்டும் உருவாக்கத் தூண்டுகிறது.
ஒரு நடைமுறை இடமாற்ற சரிபார்ப்புப் பட்டியல்
- முதலில் AGENTS.md ஐ உருவாக்கவும் – வேறு எந்தக் கோப்புகளையும் இறக்குமதி செய்வதற்கு முன் உங்களுக்குத் தேவையான ஒவ்வொரு விதியையும் அறிவிக்கவும்.
- ஒரு session-log அறிவுறுத்தலைச் சேர்க்கவும் – AGENTS.md இன் மேற்பகுதியில் “சுருக்கத்தைச் சேர்க்கவும்” (append summary) என்ற விதியைப் பதிவிடவும்.
- முக்கிய மூன்று திறன்களை மீண்டும் உருவாக்கவும் – ஆதரிக்கப்படும் புலங்களை மட்டும் நகலெடுக்கவும்; ஒவ்வொரு திறனையும் தனித்தனியாகச் சோதிக்கவும்.
- MCP-களை கைமுறையாக மீண்டும் அறிவிக்கவும் – நீங்கள் இன்னும் அணுக வேண்டிய ஒவ்வொரு சர்வர் அல்லது கிளவுட் எண்ட்பாயிண்டையும் (cloud endpoint) பட்டியலிடவும்.
- சரிபார்க்கவும் (Validate) – ஒரு புதிய OpenCode அமர்வைத் தொடங்கி, அதன் விதிகள், திறன் பட்டியல் மற்றும் நினைவக நிலை குறித்து உதவியாளரிடம் கேட்கவும்.
சுருக்கம் (Takeaway)
Claude Code இலிருந்து OpenCode-க்கு மாறுவது என்பது கோப்புகளை நகர்த்துவது பற்றியது அல்ல, மாறாக உதவியாளரை இயக்கும் அறிவிப்புகளை (declarations) மீண்டும் வடிவமைப்பதைப் பற்றியது. இந்த செயல்முறை உங்களை அடிப்படை விதிகளுக்குக் கட்டுப்படுத்தவும், அத்தியாவசியத் திறன்களை மீண்டும் உருவாக்கவும், ஒரு கைமுறை நினைவகப் பதிவைப் பின்பற்றவும் கட்டாயப்படுத்துகிறது, ஆனால் இது மலிவான, மாடல் சாராத AI உதவியைப் பெறுவதற்கான கதவையும் திறக்கிறது. வசதியை விடக் கட்டுப்பாட்டிற்கு நீங்கள் தயாராக இருந்தால், மேலே உள்ள சரிபார்ப்புப் பட்டியலைப் பின்பற்றி, இறக்குமதி செய்யப்பட்ட ஒவ்வொரு அங்கத்தையும் ஒரு புதிய தொடக்கமாகக் கருதுங்கள்.