KAN-73: document and validate MCP ticket description format

app/Mcp/Tools/UpdateTicket.php

@@ -2,7 +2,9 @@
 
 namespace App\Mcp\Tools;
 
+use App\Actions\Tickets\Support\TicketDescriptionFormat;
 use App\Actions\Tickets\UpdateProjectTicket;
+use App\Mcp\Support\DescribesTicketWriting;
 use App\Mcp\Support\KanbanGitMcp;
 use App\Mcp\Support\TicketUpdateInput;
 use Illuminate\Contracts\JsonSchema\JsonSchema;
@@ -20,6 +22,8 @@ use Laravel\Mcp\Server\Tools\Annotations\IsDestructive;
 #[IsDestructive(false)]
 class UpdateTicket extends Tool
 {
+    use DescribesTicketWriting;
+
     public function __construct(
         private readonly KanbanGitMcp $kanbanGitMcp,
         private readonly TicketUpdateInput $ticketUpdateInput,
@@ -46,7 +50,7 @@ class UpdateTicket extends Tool
         return [
             'ticket_id' => $schema->integer()->description('Existing ticket ID.')->required(),
             'title' => $schema->string()->max(255)->description('Nonblank title; omit to preserve.'),
-            'description' => $schema->string()->nullable()->description('Description; null clears it.'),
+            'description' => $schema->string()->nullable()->description('Description; null clears it. '.TicketDescriptionFormat::instructions()),
             'ticket_type_id' => $schema->integer()->description('Type ID from get_project_configuration.'),
             'ticket_priority_id' => $schema->integer()->description('Priority ID from get_project_configuration.'),
             'parent_ticket_id' => $schema->integer()->nullable()->description('Parent-enabled ticket in this project; null removes the parent. Cycles are forbidden.'),
@@ -60,7 +64,7 @@ class UpdateTicket extends Tool
                 'text' => $schema->string()->description('Nonblank criterion text.')->required(),
                 'checked' => $schema->boolean()->description('Checked state, defaults to false for supplied items.'),
                 'indent' => $schema->integer()->min(0)->max(8)->description('Indent level, defaults to 0; cannot skip a level.'),
-            ])->withoutAdditionalProperties())->description('Ordered replacement checklist. Omitted items are removed. [] clears; omit field to preserve; null is invalid.'),
+            ])->withoutAdditionalProperties())->description('Ordered replacement checklist. Omitted items are removed. [] clears; omit field to preserve; null is invalid. '.TicketDescriptionFormat::criteriaInstructions()),
             'field_values' => $schema->array()->items($schema->object([
                 'ticket_field_definition_id' => $schema->integer()->description('Project field ID, supplied once.')->required(),
                 'value_number' => $schema->number()->nullable()->description('Value for a numeric field; null clears.'),