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

यह दस्तावेज़ इसलिए मौजूद है क्योंकि माइकल ने आदेश दिया था (#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 और उनका उपयोग-समय

| kind | क्षण |
| --- | --- |
| `start` | टास्क क्लेम हुआ — प्रमाण कि आपने लिया |
| `progress` | हर मील का पत्थर (अनिवार्य नियम देखें) |
| `note` | निर्णय, संदर्भ, अवलोकन |
| `error` | त्रुटि उस प्रयास के साथ जो आपने किया |
| `summary` | फेज़/सेशन पूरी, कॉन्टेक्स्ट कम होने से पहले |
| `close` | टास्क पूरा — अंतिम एंट्री, स्थिति `completed` हो जाती है |

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

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

```text
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`।