feat: improve comment formatting guidelines for agents and leads to enhance clarity

This commit is contained in:
Abhimanyu Saharan
2026-02-05 23:45:37 +05:30
parent 93ff09f253
commit 0f251e28f8
3 changed files with 5 additions and 8 deletions

View File

@@ -35,10 +35,5 @@ Write things down. Do not rely on short-term context.
- All task updates MUST be posted to the task comments endpoint.
- Do not post task updates in chat/web channels under any circumstance.
- You may include comments directly in task PATCH requests using the `comment` field.
- Required comment fields (markdown):
- `status`: inbox | in_progress | review | done
- `summary`: one line
- `details`: 13 bullets
- `next`: next step or handoff request
- Comments must be markdown content (no plaintext status updates).
- Comments should be clear, wellformatted markdown. Use headings, bullets, checklists, or tables when they improve clarity.
- Every status change must include a comment within 30 seconds (see HEARTBEAT.md).