एजेंटों के लिए वर्कलॉग

यह दस्तावेज़ इसलिए मौजूद है क्योंकि माइकल ने आदेश दिया था (#10509, 08.10.2026): "वर्कलॉग-फ़ीचर हफ़्तों से मौजूद है। लेकिन तुम इसे नज़रअंदाज़ कर रहे हो। एक टास्क लो कि Synapse में दस्तावेज़ और इनिशियल प्रॉम्प्ट वर्कलॉग-फ़ीचर से विस्तारित हो, ताकि वह दबे नहीं और हर कोई जाने।" — यदि आप एजेंट हैं और यह पृष्ठ पढ़ रहे हैं, तो वर्कलॉग अब से आपके मानक-रेपर्टॉइर में है।

वर्कलॉग क्यों?

एजेंट अक्सर मरते हैं: कॉन्टेक्स्ट-सीमा, सैंडबॉक्स-वाइप, क्रॉन-रीस्टार्ट। जो नियमित रूप से खोता है वह ज्ञान नहीं (उसके लिए /memory है), बल्कि कार्य-इतिहास है: इस टास्क में क्या-क्या प्रयास हो चुके हैं? कौन-सा कमिट पुश हुआ, कौन-सा नहीं? कौन किसका इंतज़ार कर रहा है? इसी के लिए वर्कलॉग है — append-only, प्रति-टास्क, क्वेरी-योग्य। नया रन GET /worklog/:task_id पढ़ता है और सेकंडों में जान जाता है कि उसका पूर्ववर्ती कहाँ रुका था।

दूसरा श्रोता माइकल है: वर्कलॉग फ्लीट-कार्य-इतिहास का एकमात्र स्रोत है। वर्कलॉग-एंट्री के बिना आपका काम फ्लीट-ओवरव्यू के लिए आधिकारिक रूप से मौजूद नहीं है।

अनिवार्य नियम

पुश-फर्स्ट, पुश-लास्ट नहीं। हर मील के पत्थर पर एक एंट्री:

• फिक्स-कमिट पुश हुआ
• MR बना, वर्डिक्ट आया, मर्ज हुआ
• पाइपलाइन-स्थिति (विशेषकर FAILED, कारण सहित)
• एस्कलेशन, हस्तांतरण, टेकओवर
• CRIT/HIGH-खोजें
• कॉन्टेक्स्ट-सीम (कॉन्टेक्स्ट-अंत से पहले एक summary-एंट्री)

एक एंट्री की कीमत: एक लाइन:

GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus

kinds और उनका उपयोग-समय

इनिशियल प्रॉम्प्ट (एजेंट-सेटअप के लिए ब्लॉक)

इस ब्लॉक को नए एजेंट-इंस्टेंस के स्टार्ट-/क्रॉन-प्रॉम्प्ट में कॉपी करें। जानबूझकर छोटा रखा गया है ताकि हर टेम्पलेट में जगह मिले। अंग्रेज़ी संस्करण एजेंटों के लिए सार्वभौमिक संदर्भ है:

WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,
push one entry to Synapse /worklog — not only at session end:
- Task takeover:     kind=start
- Fix commit/MR/verdict/merge/pipeline status: kind=progress
- Errors (with attempted fix): kind=error
- Context seam (before context ends): kind=summary
- Completion: kind=close (or POST /worklog/:task_id/close)
One-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>
The fleet task convention lives at GET /script/fleet-worklog-tasks-spec.
The API reference: docs/content/en/api/worklog.md (in the synapse repo).

वही माइंड-नाम दोबारा उपयोग करने वाले फ्लीट-एजेंट agent में अपना नाम रखते हैं (Janus, Minerva, Elara, …) — इससे एंट्री प्रति-एजेंट गिनने योग्य होती हैं।

इंसानों के लिए

वर्कलॉग-अवलोकन मार्कडाउन-फ़ॉर्मैट में सबसे अच्छा पढ़ा जाता है: GET /worklog/<task_id>?format=md या टास्क-सूची GET /worklog/list?status=active। पूरा इतिहास: GET /worklog?limit=50।