ChatCrystal Task Recall

Use this skill as a thin workflow on top of ChatCrystal Core. Do not invent a parallel memory system in the skill.

Workflow

1. Decide whether the task is substantial enough to justify recall.
2. Trigger for non-trivial implement, refactor, migration, config, investigate, or optimization work.
3. Skip trivial edits, one-line answers, or purely conversational requests.
4. If recallfortask is available, call it before substantive work with:

- mode: "task" - task.goal: the concrete task objective - task.taskkind: the best matching task kind - task.projectdir and task.cwd when repository context exists - task.branch when known - task.relatedfiles or task.filestouched when known - task.source_agent when the runtime has a stable value

1. Treat projectmemories as primary context and globalmemories as supplemental context.
2. Apply recalled pitfalls, patterns, and prior decisions before proposing or writing code.

Example MCP Input

Use this shape when calling recallfortask for implementation or investigation work:

{
  "mode": "task",
  "task": {
    "goal": "Add a paginated notes export endpoint",
    "task_kind": "implement",
    "project_dir": "/path/to/project",
    "cwd": "/path/to/project",
    "branch": "feature/export-notes",
    "related_files": [
      "server/src/routes/notes.ts",
      "shared/types/index.ts"
    ],
    "source_agent": "codex"
  },
  "options": {
    "project_limit": 5,
    "global_limit": 3,
    "include_relations": true
  }
}

Full Mode

Full mode requires ChatCrystal Core plus MCP access to recallfortask.

• Prefer the current repository or workspace path so Core can derive project_key.
• Surface relevant warnings such as no-project-key or no-matches, but do not treat them as failures.
• If recall returns nothing useful, continue the task normally.

Degraded Mode

If ChatCrystal Core or the MCP tool is unavailable:

• Continue the task without blocking.
• State briefly that long-term recall is unavailable in this environment.
• Do not claim that any memory was recalled.
• Do not instruct the runtime to auto-install ChatCrystal Core as part of the skill flow.