ਇੱਕ ਡਿਵੈਲਪਰ ਨੇ ਮਹੀਨਿਆਂ ਪੁਰਾਣਾ Claude Code ਵਰਕਫਲੋ OpenCode ਵਿੱਚ ਤਬਦੀਲ ਕੀਤਾ ਅਤੇ ਪਾਇਆ ਕਿ ਫਾਈਲ ਹੈਂਡਲਿੰਗ, ਰੂਲ ਲੋਡਿੰਗ, ਟੂਲ ਇਨਵੈਂਟਰੀ, ਸਕਿੱਲ ਮੈਟਾਡਾਟਾ ਅਤੇ ਕਰਾਸ-ਸੈਸ਼ਨ ਮੈਮੋਰੀ ਸਭ ਕੁਝ ਖਰਾਬ ਹੋ ਗਿਆ। ਉਸ ਦੁਆਰਾ ਦਸਤਾਵੇਜ਼ੀ ਕੀਤੇ ਗਏ ਫਿਕਸ ਹੁਣ ਉਨ੍ਹਾਂ ਲੋਕਾਂ ਲਈ ਇੱਕ ਵਿਵਹਾਰਕ ਚੈੱਕਲਿਸਟ ਵਜੋਂ ਕੰਮ ਕਰਦੇ ਹਨ ਜੋ Claude ਦੇ ਈਕੋਸਿਸਟਮ ਤੋਂ ਓਪਨ-ਸੋਰਸ ਵਿਕਲਪ ਵੱਲ ਜਾ ਰਹੇ ਹਨ।
ਮਾਈਗ੍ਰੇਸ਼ਨ ਕਿਉਂ ਮਹੱਤਵਪੂਰਨ ਸੀ
Claude Code ਯੂਜ਼ਰਸ ਇੱਕ ਤਰ੍ਹਾਂ ਨਾਲ ਬੰਨ੍ਹੇ ਹੋਏ ਫਾਈਲਾਂ ਦੇ ਸੈੱਟ—ਰੂਲਜ਼, ਸਕਿੱਲ ਡੈਫੀਨੇਸ਼ਨਜ਼ ਅਤੇ ਮੈਮੋਰੀ ਲੌਗਸ—ਤੇ ਨਿਰਭਰ ਕਰਦੇ ਹਨ ਤਾਂ ਜੋ ਇੱਕ AI-ਡਰਾਈਵਨ ਕੋਡਿੰਗ ਅਸਿਸਟੈਂਟ ਨੂੰ ਸੁਚਾਰੂ ਰੂਪ ਵਿੱਚ ਚਲਾਇਆ ਜਾ ਸਕੇ। ਜਦੋਂ ਲੇਖਕ ਦਾ ਸੈੱਟਅੱਪ ਰੂਲਜ਼ ਲੋਡ ਕਰਨਾ ਬੰਦ ਕਰ ਦਿੱਤਾ, ਫਾਈਲਾਂ ਮਿਕਸ ਕਰ ਦਿੱਤੀਆਂ ਅਤੇ ਟੋਕਨ ਵਰਤੋਂ ਵਿੱਚ ਤੇਜ਼ੀ ਆਈ, ਤਾਂ ਉਸਦਾ ਰੋਜ਼ਾਨਾ ਕੋਡਿੰਗ ਹੈਲਪਰ ਭਰੋਸੇਯੋਗ ਨਹੀਂ ਰਿਹਾ। OpenCode “permission-first security”, OpenRouter ਰਾਹੀਂ ਮਾਡਲ-ਐਗਨੌਸਟਿਕ ਐਕਸੈਸ ਅਤੇ pay-as-you-go ਕੀਮਤ ਦਾ ਵਾਅਦਾ ਕਰਦਾ ਹੈ, ਜੋ ਇਸਨੂੰ ਆਕਰਸ਼ਕ ਬਣਾਉਂਦਾ ਹੈ। ਪਰ ਇਹ ਤਬਦੀਲੀ ਸਿਰਫ਼ ਕਾਪੀ-ਪੇਸ ਨਹੀਂ ਹੈ; ਤੁਹਾਨੂੰ ਹਰ ਕੰਪੋਨੈਂਟ ਨੂੰ ਉਸ ਫਾਰਮੈਟ ਵਿੱਚ ਦੁਬਾਰਾ ਡਿਕਲੇਅਰ ਕਰਨਾ ਪਵੇਗਾ ਜਿਸ ਦੀ OpenCode ਉਮੀਦ ਕਰਦਾ ਹੈ।
ਟੁੱਟ-ਭੱਜ ਦਾ ਕਾਰਨ ਕੀ ਸੀ
Claude Code CLAUDE.md ਨਾਮ ਦੀ ਇੱਕ ਫਾਈਲ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਸੀ, ਜਿਸ ਨੂੰ OpenCode ਨਜ਼ਰਅੰਦਾਜ਼ ਕਰ ਦਿੰਦਾ ਹੈ ਅਤੇ ਇਸ ਦੀ ਬਜਾਏ ਵਾਧੂ ਮੈਟਾਡਾਟਾ ਲਈ AGENTS.md ਪੜ੍ਹਦਾ ਹੈ। ਲੇਖਕ ਨੇ ਮੰਨ ਲਿਆ ਸੀ ਕਿ ਦੋਵੇਂ ਸਿਸਟਮ ਆਪਸ ਵਿੱਚ ਬਦਲੇ ਜਾ ਸਕਦੇ ਹਨ, ਜਿਸ ਕਾਰਨ ਕਈ ਮੁੱਖ ਹਿੱਸੇ OpenCode ਲਈ ਅਦਿੱਖ ਰਹਿ ਗਏ।
ਅਸਲ ਅਸਫਲਤਾਵਾਂ ਅਤੇ ਉਹਨਾਂ ਨੂੰ ਕਿਵੇਂ ਸੁਧਾਰਨਾ ਹੈ
Rules file ignored
OpenCode ਕਦੇ ਵੀ CLAUDE.md ਨਹੀਂ ਪੜ੍ਹਦਾ; ਇਹ ਸਿਰਫ਼ AGENTS.md ਨੂੰ ਪਾਰਸ ਕਰਦਾ ਹੈ। ਫਾਈਲ ਦਾ ਨਾਮ ਬਦਲਣਾ ਕਾਫ਼ੀ ਨਹੀਂ ਹੈ ਕਿਉਂਕਿ ਸਮੱਗਰੀ ਨੂੰ ਨਵੇਂ ਫਾਰਮੈਟ ਵਿੱਚ ਦੁਬਾਰਾ ਡਿਕਲੇਅਰ ਕਰਨਾ ਪਵੇਗਾ।
Fix: ਇੱਕ ਨਵੀਂ AGENTS.md ਬਣਾਓ, ਰੂਲ ਟੈਕਸਟ ਨੂੰ ਕਾਪੀ ਕਰੋ, ਇੱਕ ਨਵਾਂ OpenCode ਸੈਸ਼ਨ ਸ਼ੁਰੂ ਕਰੋ ਅਤੇ ਏਜੰਟ ਨੂੰ ਪੁੱਛੋ “What are my rules?” ਜੇਕਰ ਇਹ ਉਹਨਾਂ ਨੂੰ ਨਹੀਂ ਦੱਸ ਸਕਦਾ, ਤਾਂ ਰੂਲਜ਼ ਲੋਡ ਨਹੀਂ ਹੋਏ ਹਨ।Tooling inventory missing
ਮਾਈਗ੍ਰੇਸ਼ਨ ਕਮਾਂਡ ਜਿਸ ਨੂੰ ਸਕਿੱਲਜ਼ ਅਤੇ MCP (multi-cloud platform) ਸਰਵਰਾਂ ਨੂੰ ਕਾਪੀ ਕਰਨਾ ਸੀ, ਅਸਫਲ ਰਹੀ ਕਿਉਂਕਿ OpenCode ਉਨ੍ਹਾਂ ਟੂਲਜ਼ ਦੀ ਇਨਵੈਂਟਰੀ ਨਹੀਂ ਬਣਾ ਸਕਦਾ ਜੋ ਕਦੇ ਰਜਿਸਟਰ ਨਹੀਂ ਕੀਤੇ ਗਏ ਸਨ।
Fix: ਜਦੋਂ ਤੱਕ Claude Code ਟੂਲਜ਼ ਚੱਲ ਰਹੇ ਹਨ, ਹਰ ਸਕਿੱਲ ਅਤੇ ਕਮਾਂਡ ਨੂੰ ਮੈਨੂਅਲੀ ਲਿਸਟ ਕਰੋ। ਫੈਸਲਾ ਕਰੋ ਕਿ ਕਿਹੜੇ OpenCode ਵਿੱਚ ਦੁਬਾਰਾ ਬਣਾਉਣੇ ਹਨ ਅਤੇ ਕਿਹੜੇ ਨੂੰ ਛੱਡਣਾ ਹੈ।Front-matter stripped from skills
ਪੋਰਟ ਕੀਤੀਆਂ ਗਈਆਂ ਸਕਿੱਲ ਫਾਈਲਾਂ ਨੇ ਆਪਣਾ ਜ਼ਿਆਦਾਤਰ ਫਰੰਟ-ਮੈਟਰ ਗੁਆ ਦਿੱਤਾ, ਜਿਸ ਵਿੱਚ ਮਾਡਲ ਅਸਾਈਨਮੈਂਟਸ ਅਤੇ ਟੂਲ ਹੈਂਡਲਿੰਗ ਡਾਇਰੈਕਟਿਵਜ਼ ਸ਼ਾਮਲ ਹਨ। OpenCode ਸਿਰਫ਼ ਕੁਝ ਖਾਸ ਫੀਲਡਾਂ ਦਾ ਹੀ ਸਨਮਾਨ ਕਰਦਾ ਹੈ, ਇਸ ਲਈ ਇੰਪੋਰਟ ਕੀਤੀਆਂ ਗਈਆਂ ਸਕਿੱਲਜ਼ ਅਣਪਛਾਤੇ ਤਰੀਕੇ ਨਾਲ ਕੰਮ ਕਰ ਰਹੀਆਂ ਸਨ।
Fix: ਹਰ ਇੰਪੋਰਟ ਕੀਤੀ ਸਕਿੱਲ ਨੂੰ ਖਰਾਬ ਮੰਨੋ। ਸਭ ਤੋਂ ਵੱਧ ਵਰਤੀਆਂ ਜਾਣ ਵਾਲੀਆਂ ਤਿੰਨ ਸਕਿੱਲਜ਼ ਨੂੰ ਸ਼ੁਰੂ ਤੋਂ ਦੁਬਾਰਾ ਬਣਾਓ, ਇਹ ਯਕੀਨੀ ਬਣਾਉਂਦੇ ਹੋਏ ਕਿ ਉਹਨਾਂ ਵਿੱਚ ਸਿਰਫ਼ ਸਮਰਥਿਤ ਫੀਲਡ ਹੀ ਹੋਣ। ਕਿਸੇ ਵੀ ਅਣਵਰਤੀ ਸਕਿੱਲ ਫਾਈਲ ਨੂੰ ਡਿਲੀਟ ਕਰ ਦਿਓ।No cross-session memory
Claude Code ਇੱਕ ਪਰਸਿਸਟੈਂਟ ਇਤਿਹਾਸ ਰੱਖਦਾ ਸੀ ਜਿਸ 'ਤੇ ਲੇਖਕ ਕੰਟੈਕਸਟ ਲਈ ਨਿਰਭਰ ਕਰਦਾ ਸੀ। OpenCode ਸੈਸ਼ਨਾਂ ਵਿੱਚ ਮੈਮੋਰੀ ਬਣਾਈ ਨਹੀਂ ਰੱਖਦਾ, ਇਸ ਲਈ ਸਵਿਚ ਕਰਨ ਦੇ ਅਗਲੇ ਦਿਨ ਹੀ ਅਸਿਸਟੈਂਟ ਸਭ ਕੁਝ “ਭੁੱਲ” ਗਿਆ।
Fix: AGENTS.md ਵਿੱਚ ਇੱਕ ਸਪਸ਼ਟ ਹਦਾਇਤ ਜੋੜੋ: “At the end of every session, append a short summary to session-log.md covering what was done, what is pending, and decisions made.” ਫਿਰ ਸੈਸ਼ਨ ਲੌਗ ਨਿਰੰਤਰਤਾ ਲਈ ਇਕਲੌਤਾ ਸੱਚ ਦਾ ਸਰੋਤ ਬਣ ਜਾਂਦਾ ਹੈ।
ਦਾਅਵਾਂ: ਤੁਸੀਂ ਕੀ ਜਿੱਤਦੇ ਹੋ ਅਤੇ ਕੀ ਗੁਆਉਂਦੇ ਹੋ
ਜਿੱਤਾਂ
- Permission-first security: OpenCode ਕਿਸੇ ਵੀ ਕਾਰਵਾਈ ਨੂੰ ਚਲਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਪੁੱਛਦਾ ਹੈ, ਜਿਸ ਨਾਲ ਗਲਤੀ ਨਾਲ ਹੋਣ ਵਾਲੇ ਕੋਡ ਬਦਲਾਅ ਘਟ ਜਾਂਦੇ ਹਨ।
- Model freedom: ਇੱਕ ਸਿੰਗਲ API key OpenRouter ਰਾਹੀਂ ਦਰਜਨਾਂ ਮਾਡਲਾਂ ਨੂੰ ਅਨਲੌਕ ਕਰਦੀ ਹੈ, ਜੋ ਤੁਹਾਨੂੰ ਕੌਂਫਿਗਰੇਸ਼ਨ ਫਾਈਲਾਂ ਬਦਲੇ ਬਿਨਾਂ ਪ੍ਰਯੋਗ ਕਰਨ ਦੀ ਇਜਾਜ਼ਤ ਦਿੰਦੀ ਹੈ।
- Cost control: ਬਿਲਿੰਗ ਵਰਤੋਂ-ਅਧਾਰਤ ਹੈ, ਜੋ ਕਿ ਫਲੈਟ-ਰੇਟ ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਤੋਂ ਬਚਾਉਂਦੀ ਹੈ ਜੋ ਟੋਕਨ ਦੀ ਵਰਤੋਂ ਵਧਣ 'ਤੇ ਮਹਿੰਗੀ ਹੋ ਸਕਦੀ ਹੈ।
ਨੁਕਸਾਨ
- ਕੋਈ ਇਨ-ਬਿਲਟ ਲੌਂਗ-ਟਰਮ ਮੈਮੋਰੀ ਨਹੀਂ ਹੋਣ ਦਾ ਮਤਲਬ ਹੈ ਕਿ ਤੁਹਾਨੂੰ ਇੱਕ ਮੈਨੂਅਲ ਲੌਗ ਰੱਖਣਾ ਪਵੇਗਾ।
- ਸੀਮਤ ਸਕਿੱਲ ਮੈਟਾਡਾਟਾ ਤੁਹਾਨੂੰ ਆਪਣੇ ਜ਼ਿਆਦਾਤਰ ਕਸਟਮ ਟੂਲਜ਼ ਨੂੰ ਦੁਬਾਰਾ ਬਣਾਉਣ ਲਈ ਮਜਬੂਰ ਕਰਦਾ ਹੈ।
ਇੱਕ ਵਿਵਹਾਰਕ ਮਾਈਗ੍ਰੇਸ਼ਨ ਚੈੱਕਲਿਸਟ
- ਪਹਿਲਾਂ AGENTS.md ਬਣਾਓ – ਕਿਸੇ ਵੀ ਹੋਰ ਫਾਈਲਾਂ ਨੂੰ ਇੰਪੋਰਟ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਤੁਹਾਨੂੰ ਲੋੜੀਂਦੇ ਹਰ ਰੂਲ ਨੂੰ ਡਿਕਲੇਅਰ ਕਰੋ।
- ਸੈਸ਼ਨ-ਲੌਗ ਹਦਾਇਤ ਜੋੜੋ – AGENTS.md ਦੇ ਸਿਖਰ 'ਤੇ “append summary” ਨਿਯਮ ਨੂੰ ਸ਼ਾਮਲ ਕਰੋ।
- ਤਿੰਨ ਸਭ ਤੋਂ ਮਹੱਤਵਪੂਰਨ ਸਕਿੱਲਜ਼ ਨੂੰ ਦੁਬਾਰਾ ਬਣਾਓ – ਸਿਰਫ਼ ਸਮਰਥਿਤ ਫੀਲਡਾਂ ਨੂੰ ਕਾਪੀ ਕਰੋ; ਹਰ ਸਕਿੱਲ ਨੂੰ ਵੱਖਰੇ ਤੌਰ 'ਤੇ ਟੈਸਟ ਕਰੋ।
- MCPs ਨੂੰ ਮੈਨੂਅਲੀ ਦੁਬਾਰਾ ਡਿਕਲੇਅਰ ਕਰੋ – ਹਰੇਕ ਸਰਵਰ ਜਾਂ ਕਲਾਉਡ ਐਂਡਪੁਆਇੰਟ ਦੀ ਸੂਚੀ ਬਣਾਓ ਜਿਸ ਤੱਕ ਤੁਹਾਨੂੰ ਅਜੇ ਵੀ ਪਹੁੰਚਣ ਦੀ ਲੋੜ ਹੈ।
- ਤਸਦੀਕ ਕਰੋ – ਇੱਕ ਨਵਾਂ OpenCode ਸੈਸ਼ਨ ਸ਼ੁਰੂ ਕਰੋ ਅਤੇ ਅਸਿਸਟੈਂਟ ਤੋਂ ਉਸਦੇ ਰੂਲਜ਼, ਸਕਿੱਲ ਲਿਸਟ ਅਤੇ ਮੈਮੋਰੀ ਸਟੇਟਸ ਬਾਰੇ ਪੁੱਛੋ।
ਮੁੱਖ ਨੁਕਤਾ
Claude Code ਤੋਂ OpenCode ਵਿੱਚ ਮਾਈਗ੍ਰੇਟ ਕਰਨਾ ਫਾਈਲਾਂ ਨੂੰ ਮੂਵ ਕਰਨ ਬਾਰੇ ਘੱਟ ਅਤੇ ਅਸਿਸਟੈਂਟ ਨੂੰ ਚਲਾਉਣ ਵਾਲੇ ਡਿਕਲੇਰੇਸ਼ਨਾਂ ਨੂੰ ਦੁਬਾਰਾ ਤਿਆਰ ਕਰਨ ਬਾਰੇ ਜ਼ਿਆਦਾ ਹੈ। ਇਹ ਪ੍ਰਕਿਰਿਆ ਤੁਹਾਨੂੰ ਮੁੱਖ ਰੂਲਜ਼ ਤੱਕ ਸੀਮਤ ਹੋਣ, ਜ਼ਰੂਰੀ ਸਕਿੱਲਜ਼ ਨੂੰ ਦੁਬਾਰਾ ਬਣਾਉਣ ਅਤੇ ਇੱਕ ਮੈਨੂਅਲ ਮੈਮੋਰੀ ਲੌਗ ਅਪਣਾਉਣ ਲਈ ਮਜ