diff --git a/Models/PromptVersion.php b/Models/PromptVersion.php
index 7ab2aad..949ee41 100644
--- a/Models/PromptVersion.php
+++ b/Models/PromptVersion.php
@@ -8,6 +8,22 @@ use Core\Tenant\Models\User;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
+/**
+ * Prompt version snapshot for history and rollback.
+ *
+ * Captures the state of a prompt at a point in time, enabling
+ * version history and rollback via the restore() method.
+ *
+ * @property int $id
+ * @property int $prompt_id
+ * @property int $version
+ * @property string|null $system_prompt
+ * @property string|null $user_template
+ * @property array|null $variables
+ * @property int|null $created_by
+ * @property \Carbon\Carbon|null $created_at
+ * @property \Carbon\Carbon|null $updated_at
+ */
 class PromptVersion extends Model
 {
     protected $fillable = [