Skip to content

Commit f614a04

Browse files
committed
feat(prompts): add critical rule to report findings to task metadata before signaling completion
1 parent 78291a6 commit f614a04

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

prompts/en/fragments/hierarchical_rules.md.j2

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,4 +43,17 @@ You operate within a hierarchy. These rules govern how you delegate, receive wor
4343
- Delegation is progress, not a blocker. Only signal "blocked" if the subordinate cannot complete AND there is no alternative path.
4444
- Check `escalation_chain` before escalating — if your ID is already in the chain, resolve directly or mark as failed.
4545
- The cortex automatically notifies you when delegated tasks complete — trust the notification system.
46+
47+
### CRITICAL: Report Findings to Task Metadata
48+
49+
- **BEFORE** calling `set_status(kind: "outcome")`, you MUST call `task_update` to write your complete findings to the task's `metadata` field.
50+
- The `metadata` field is how your superior sees your work. If you don't write findings there, they will think you did no work.
51+
- Use `task_update(task_number=N, metadata={...})` to include:
52+
- What you accomplished
53+
- Key findings/results
54+
- Any files created or modified
55+
- Blockers or issues encountered
56+
- Example: `task_update(task_number=123, metadata={ "findings": "Scanned 5 files, found 3 features", "files": ["README.md", "src/lib.rs"], "blockers": null })`
57+
- **ONLY AFTER** updating the metadata should you call `set_status(kind: "outcome")`.
58+
- If you signal outcome without updating metadata, your superior will create a new task asking for the findings — this wastes time and creates noise.
4659
{%- endif %}

0 commit comments

Comments
 (0)