chatcrystal-task-writeback

ChatCrystal Task Writeback

Use this skill after meaningful work completes. Let ChatCrystal Core decide whether a memory should be skipped, merged, or created.

Workflow

1. Trigger only after substantive work completes and the result produced reusable knowledge.
2. Good candidates include:
3. a durable fix
4. a meaningful pitfall
5. a reusable pattern
6. an explicit engineering decision
7. If write_task_memory is available and the runtime has a stable run or session key, call it with:
8. mode: "auto"
9. source_run_key: the stable run or session key
10. task.goal, task.task_kind, task.project_dir, task.cwd, task.branch
11. task.source_agent when known
12. memory.summary: concise and durable, not chatty
13. memory.outcome_type: one of pitfall, fix, pattern, decision
14. memory.root_cause, memory.resolution, memory.error_signatures, memory.files_touched, memory.tags when relevant
15. Use mode: "manual" only for an explicit manual save flow, never as a silent fallback for automatic writeback.
16. Default to project-scoped knowledge. Only use global scope for clearly cross-project knowledge and only in an explicit manual save flow.
17. Report the persistence result accurately:
18. created
19. merged
20. skipped

Example MCP Input

Use this shape when calling write_task_memory after a completed task with a stable run key:

{
  "mode": "auto",
  "source_run_key": "agent-session-or-run-id",
  "scope": "project",
  "task": {
    "goal": "Fix MCP recall schema validation",
    "task_kind": "debug",
    "project_dir": "/path/to/project",
    "cwd": "/path/to/project",
    "branch": "fix/mcp-recall-schema",
    "files_touched": [
      "server/src/services/memory/schemas.ts",
      "server/src/cli/mcp/server.ts"
    ],
    "error_signatures": [
      "invalid_type",
      "recall_for_task schema mismatch"
    ],
    "source_agent": "codex"
  },
  "memory": {
    "summary": "MCP tool schemas must stay aligned with memory service request shapes; mismatches surface as validation failures before tool execution.",
    "outcome_type": "fix",
    "root_cause": "The MCP tool input shape diverged from the service schema.",
    "resolution": "Reused the shared request shape in the MCP server registration.",
    "files_touched": [
      "server/src/services/memory/schemas.ts",
      "server/src/cli/mcp/server.ts"
    ],
    "tags": [
      "mcp",
      "memory-loop",
      "schema"
    ]
  }
}

Full Mode

Full mode requires ChatCrystal Core plus MCP access to write_task_memory.

• Do not reimplement skip or merge logic in the skill.
• Trust Core to decide whether the memory should be skipped, merged, or created.
• If the tool reports skipped, keep the task result but do not force persistence.

Degraded Mode

If ChatCrystal Core or the MCP tool is unavailable, or if no stable run key exists for automatic writeback:

• Do not claim that the memory was saved.
• Emit a structured memory candidate in the response for later save.
• Keep the candidate aligned with the write_task_memory.memory payload shape so it can be reused later.
• Do not instruct the runtime to auto-install ChatCrystal Core as part of the skill flow.