- Windsurf Codemaps AI द्वारा टिप्पणीकृत एक structured code map है, जो डेवलपर्स को codebase को तेज़ी और सटीकता से समझने में मदद करने वाला एक नया code exploration tool है
- जहाँ मौजूदा AI coding tools कोड लिखने के automation पर केंद्रित हैं, वहीं Codemaps का लक्ष्य understanding-first engineering है, और यह SWE‑1.5 तथा Claude Sonnet 4.5 मॉडल पर आधारित है
- यह codebase के भीतर feature flow को विज़ुअली दिखाता है, सटीक code location पर तुरंत ले जाता है, और “trace guide” के ज़रिए संबंधित code groups की व्याख्या देखने देता है
- Cascade जैसे मौजूदा chat-based agents की तुलना में इसकी context connectivity और navigation efficiency अधिक है, और
@{codemap} reference feature से agent के काम का प्रदर्शन बेहतर होता है
- AI को केवल replacement नहीं, बल्कि engineers की समझ और accountability को मजबूत करने वाले collaborative tool के रूप में स्थापित करता है
कोड समझने का महत्व और Codemaps का आगमन
- software development सिर्फ coding नहीं, बल्कि समस्या की समझ से शुरू होता है
- AI जो कोड की जगह लिख देता है, productivity बढ़ाता है, लेकिन डेवलपर और कोड के बीच समझ का disconnect पैदा कर सकता है
- high-difficulty और high-value कामों में यह दूरी गंभीर inefficiency में बदल सकती है
- Cognition इस बात पर ज़ोर देता है कि ज़रूरत “दिमाग बंद करने वाली AI” नहीं, बल्कि “दिमाग चालू करने वाली AI” की है
- Codemaps, SWE‑1.5 और Claude Sonnet 4.5 पर आधारित AI-annotated code map है, जो DeepWiki और Ask Devin की तकनीक का विस्तारित रूप है
Codemaps क्यों
- हर engineering task की शुरुआत कोड को समझने से होती है, और बड़े codebase में navigation और memory पर बहुत समय खर्च होता है
- नए engineers को पूरी तरह दक्ष होने में 3~9 महीने लगते हैं, और senior engineers onboarding पर प्रति सप्ताह 5 घंटे से अधिक खर्च करते हैं
- Stripe के सर्वे के अनुसार legacy maintenance productivity में गिरावट का प्रमुख कारण है
- मौजूदा AI coding tools सामान्य Q&A पर केंद्रित हैं, इसलिए वे focused onboarding और precise navigation को ठीक से support नहीं करते
- Codemaps को इन सीमाओं को दूर करने वाले सटीक code-based mapping tool के रूप में डिज़ाइन किया गया है
real-time problem-centric mapping features
- इसे Windsurf में Cmd + Shift + C से चलाया जाता है, जहाँ आप task goal दर्ज कर सकते हैं या auto suggestion चुन सकते हैं
- Fast(SWE‑1.5) या Smart(Sonnet 4.5) mode में से चुना जा सकता है
- हर Codemap code snapshot पर आधारित होता है और ZDR principle का पालन करता है
- visual node map के ज़रिए code structure को explore किया जा सकता है, और क्लिक करने पर सटीक code location पर पहुँचा जा सकता है
- “See more” option से trace guide खोला जा सकता है, जहाँ code groups की व्याख्या विस्तार से मिलती है
- Cascade के भीतर
@{codemap} को कॉल करके किसी खास section को reference करने पर agent की context understanding और performance बेहतर होती है
‘Vibeslop’ के खिलाफ़ एक तरीका
- “Vibe coding” जब बिना सोचे-समझे AI code generation में बदल जाता है, तब समझ के बिना code maintenance एक समस्या बन जाती है
- Codemaps इंसान और AI को system structure, data flow, और dependencies की साझा समझ देता है, जिससे understanding gap कम होता है
- engineer की भूमिका लेखक से जवाबदेह व्यक्ति (accountability) की ओर बढ़ती है, जहाँ समझ के ज़रिए quality सुनिश्चित की जाती है
- लक्ष्य सिर्फ speed नहीं, बल्कि engineers को flow बनाए रखते हुए जटिल समस्याएँ आत्मविश्वास से हल करने में मदद करना है
- AI को केवल replacement नहीं, बल्कि high-value work को मजबूत करने और low-value work का बोझ कम करने वाले सहयोगी साधन के रूप में पेश किया गया है
आगे की योजना
- Codemaps, internal agents के indexing और analysis results को इंसानों के लिए विज़ुअल रूप में दिखाने का पहला चरण है
- अभी इसे teams के बीच sharing और learning के लिए इस्तेमाल किया जा सकता है
- आगे Devin और Cascade जैसे agents की problem-solving क्षमता पर इसके असर को benchmark करने की योजना है
- Codemap के बीच links, annotation features, और open
.codemap protocol की परिभाषा पर विचार किया जा रहा है
- Fast Context feature के साथ मिलाकर automatic context engineering को इंसानों के पढ़ने योग्य रूप में विकसित करने का लक्ष्य है
- Codemaps, नवीनतम Windsurf और DeepWiki versions में उपलब्ध है
3 टिप्पणियां
जब भी मैं deepwiki का इस्तेमाल करता हूँ, मैं प्रभावित हो जाता हूँ, इसलिए इस फीचर से भी उम्मीदें हैं!
काश यह VS Code में भी आ जाता
Hacker News राय
यह पढ़कर कुछ बातें ध्यान में आईं
यह एक और Fortune 500 के लिए बना AI प्रोडक्ट लगता है। छोटे और मझोले टीमों के लिए शायद उतना उपयुक्त न हो
सच कहें तो ऐसे static analysis आधारित diagram tools बहुत पहले से मौजूद हैं, और LLM इसे बनाकर दे देता है, इसके अलावा इसमें बहुत नई बात नहीं है
onboarding का मतलब सिर्फ flowchart दिखाना नहीं है, बल्कि टीम के पास जो problem context है उसे साझा करना है। CRUD या MVC जैसे boilerplate से ज़्यादा ज़रूरी है कि हमारी टीम के खास pattern और constraints समझाए जाएँ
LLM से बने visualization की ताकत यह है कि उसमें ऐसा judgment और common sense आता है, इसलिए वह ज़्यादा intuitive लगता है
क्या कोई ऐसे static analysis tools recommend कर सकता है? हो सके तो open source हो, और Python, Java, JavaScript, खासकर Angular, support करता हो
मैंने काफी समय बाद Windsurf खोला और “Upgrade Available” पर क्लिक किया, तो इस पेज पर ले गया
वहाँ दिया गया कमांड
sudo apt-get upgrade windsurfअसल में पूरे सिस्टम के packages upgrade कर देने वाला जोखिमभरा कमांड हैअच्छी बात यह रही कि मैंने सीधे
sudo apt-get install --only-upgrade windsurfसे इसे हल कर लियावैसे नया जोड़ा गया Codemaps फीचर काफ़ी बढ़िया है और इसे आज़माना चाहिए
apt-get upgrade $PACKAGEका गैर-सहज syntax वाकई अजीब है। सही syntax तो manual में भी नहीं हैकाश और लोग Windsurf इस्तेमाल करते
मैं एक senior engineer के तौर पर agentic coding और सामान्य coding साथ में करता हूँ, और Windsurf एक कम आंका गया tool है
जब Codemaps फीचर पहली बार आया था, तब मुझे यह सच में बहुत अच्छा लगा
मैं कई हफ्तों से Codemaps इस्तेमाल कर रहा हूँ और यह शानदार है। code changes बढ़ने पर maintenance थोड़ा झंझटभरा हो सकता है, लेकिन हल निकलने लायक लगता है
मैंने Sonnet 4, Sequential Thinking, और Tavily MCP server के combination से जल्दी एक SaaS prototype बनाया। कीमत भी ठीक-ठाक है
Windsurf भी अच्छा है, लेकिन pricing policy की वजह से कंपनी-भर में अपनाने का विचार छोड़ दिया
विचार दिलचस्प है, लेकिन अगर बना हुआ diagram सही न हो तो उल्टा गलतफ़हमी पैदा करने का जोखिम है
आखिर अगर इंसान को फिर से verify ही करना पड़े, तो tool का मकसद कमजोर पड़ जाता है
ऐसे फीचर्स सिर्फ business context के बिना code connections दिखाते हैं, इसलिए उनकी उपयोगिता सीमित है
AI architecture के “why” को नहीं समझता। आखिरकार मुझे लगता है कि design docs और code पढ़ना बेहतर है
deepwiki उदाहरण या Codemap लिंक देख लें तो समझ आता है
debugging करते समय तो सच में उतनी जानकारी काफी होती है
मुझे लगता है यह approach समस्या हल करने की सही दिशा है
आधे-अधूरे AI products बनाने के बजाय, codebase को इंसान और LLM दोनों के लिए समझने लायक बनाना ज़्यादा अहम है
ऐसे self-documenting systems बड़ी कंपनियों में development fatigue कम कर सकते हैं
(सह-लेखक) सवालों का स्वागत है!
1 मिनट का demo video देख सकते हैं
यह Cognition के CTO Steven का idea है। उन्हें spotlight पसंद नहीं है, लेकिन इस बार उन्होंने सच में बढ़िया काम किया है
उनका ट्वीट भी देख सकते हैं
3 साल पहले मैंने इसी तरह के idea पर एक side project बनाया था
LLM आने से पहले मैंने खुद AST parser बनाकर Go और Java code के रिश्ते निकाले और Graphviz से visualize किया था
regex आधारित filters भी जोड़े थे, और अनजान codebase समझने में यह सच में बहुत उपयोगी था
अब वह packagemap.co पर अभी भी है, लेकिन काफ़ी पुराना हो चुका है
लक्ष्य यह था कि developer code structure को space में समझ सके और VR environment में context देखते हुए काम कर सके
उससे जुड़ा लेख यहाँ है
फीचर सुझाव: अच्छा होगा अगर Github Action के ज़रिए repository का Codemap अपने-आप generate हो, README में शामिल हो, और बड़े PR आने पर अपने-आप update भी हो
code visualization का idea अच्छा है, लेकिन कई बार इसमें “खराब विचारों में फँस जाने” का जोखिम होता है
ज़्यादातर diagrams अपनी मंशा ठीक से नहीं पहुँचा पाते, और उल्टा उन्हें समझने में समय लगता है
लोग असल में code या mathematics पढ़ते हुए अपने दिमाग में अपना visual model बना लेते हैं
उदाहरण के लिए, अगर किसी Flutter app का visualization किया गया हो लेकिन widget tree structure न दिखे, तो वह मेरे mental model से टकराता है
आखिरकार ऐसी visualization कुछ-कुछ वैसी है जैसे उपन्यास पढ़ते समय दिमाग में दृश्य बनना।
अभी यक़ीन नहीं है कि LLM ऐसी तकनीक है जो “वह code movie जिसे आप देखना चाहते हैं” बना सके