synthesis_start

Load project context at session start.

When to Call

Call this tool at the beginning of every session when a user mentions a project. It loads the full context so the AI knows exactly where things left off.

Input Schema

Example Request

{
  "query": "my-api-project",
  "register_if_new": true
}

Response

{
  "success": true,
  "project": {
    "id": "my-api-project",
    "name": "My API Project",
    "status": "active",
    "description": "REST API with JWT auth"
  },
  "context": "# Project: My API\n\n## Current State\n...",
  "next_steps": [
    "Add API documentation",
    "Set up CI/CD pipeline"
  ],
  "recent_lessons": [
    {
      "title": "JWT timezone bug",
      "type": "incident",
      "preview": "Server was using local time..."
    }
  ]
}

Project Not Found

If the project doesn't exist and register_if_new is false:

{
  "success": false,
  "error": "PROJECT_NOT_FOUND",
  "message": "No project matching 'my-api-project' found",
  "suggestions": ["my-other-project", "api-v2"]
}

Registration

If register_if_new: true and the project doesn't exist, Synthesis will:

1. Create the project in your account
2. Generate starter context
3. Return the new project for immediate use