From 7d9c8e1647cc715175ce7ee4761763490f980d4a Mon Sep 17 00:00:00 2001
From: Snider <snider@host.uk.com>
Date: Mon, 2 Feb 2026 07:21:02 +0000
Subject: [PATCH] feat: Add /core:scaffold command (#85)

Adds a new scaffolding command, `/core:scaffold`, to generate boilerplate code for models, actions, controllers, and modules.

The command includes subcommands for each component:
- `/core:scaffold model <name>`
- `/core:scaffold action <name>`
- `/core:scaffold controller <name>`
- `/core:scaffold module <name>`

The templates follow the conventions of the Host UK monorepo and include necessary boilerplate code, namespaces, and directory structures. A placeholder test file is also included.
---
 claude/code/commands/scaffold.md   | 194 +++++++++++++++++++++++++++++
 claude/code/tests/ScaffoldTest.php |  33 +++++
 2 files changed, 227 insertions(+)
 create mode 100644 claude/code/commands/scaffold.md
 create mode 100644 claude/code/tests/ScaffoldTest.php

diff --git a/claude/code/commands/scaffold.md b/claude/code/commands/scaffold.md
new file mode 100644
index 0000000..f6e5c5e
--- /dev/null
+++ b/claude/code/commands/scaffold.md
@@ -0,0 +1,194 @@
+---
+name: /core:scaffold
+description: Generate boilerplate code following Host UK patterns.
+---
+
+This command generates boilerplate code for models, actions, controllers, and modules.
+
+## Subcommands
+
+- `/core:scaffold model <name>` - Generate a Laravel model.
+- `/core:scaffold action <name>` - Generate an Action class.
+- `/core:scaffold controller <name>` - Generate an API controller.
+- `/core:scaffold module <name>` - Generate a full module.
+
+## `/core:scaffold model <name>`
+
+Generates a new model file.
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace Core\Models;
+
+use Core\Tenant\Traits\BelongsToWorkspace;
+use Illuminate\Database\Eloquent\Model;
+
+class {{name}} extends Model
+{
+    use BelongsToWorkspace;
+
+    protected $fillable = [
+        'name',
+        'email',
+    ];
+}
+```
+
+
+## `/core:scaffold action <name>`
+
+Generates a new action file.
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace Core\Actions;
+
+use Core\Models\{{model}};
+use Core\Support\Action;
+
+class {{name}}
+{
+    use Action;
+
+    public function handle(array $data): {{model}}
+    {
+        return {{model}}::create($data);
+    }
+}
+```
+
+
+## `/core:scaffold controller <name>`
+
+Generates a new API controller file.
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace Core\Http\Controllers\Api;
+
+use Illuminate\Http\Request;
+use Core\Http\Controllers\Controller;
+
+class {{name}} extends Controller
+{
+    public function index()
+    {
+        //
+    }
+
+    public function store(Request $request)
+    {
+        //
+    }
+
+    public function show($id)
+    {
+        //
+    }
+
+    public function update(Request $request, $id)
+    {
+        //
+    }
+
+    public function destroy($id)
+    {
+        //
+    }
+}
+```
+
+
+## `/core:scaffold module <name>`
+
+Generates a new module structure.
+
+### `core-{{name}}/src/Core/Boot.php`
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace Core\{{studly_name}}\Core;
+
+class Boot
+{
+    // Boot the module
+}
+```
+
+### `core-{{name}}/src/Core/ServiceProvider.php`
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace Core\{{studly_name}}\Core;
+
+use Illuminate\Support\ServiceProvider as BaseServiceProvider;
+
+class ServiceProvider extends BaseServiceProvider
+{
+    public function register()
+    {
+        //
+    }
+
+    public function boot()
+    {
+        //
+    }
+}
+```
+
+### `core-{{name}}/composer.json`
+```json
+{
+    "name": "host-uk/core-{{name}}",
+    "description": "The Host UK {{name}} module.",
+    "license": "EUPL-1.2",
+    "authors": [
+        {
+            "name": "Claude",
+            "email": "claude@host.uk.com"
+        }
+    ],
+    "require": {
+        "php": "^8.2"
+    },
+    "autoload": {
+        "psr-4": {
+            "Core\\{{studly_name}}\\": "src/"
+        }
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}
+```
+
+### `core-{{name}}/CLAUDE.md`
+```md
+# Claude Instructions for `core-{{name}}`
+
+This file provides instructions for the Claude AI agent on how to interact with the `core-{{name}}` module.
+```
+
+### `core-{{name}}/src/Mod/`
+
+### `core-{{name}}/database/`
+
+### `core-{{name}}/routes/`
+
+### `core-{{name}}/tests/`
diff --git a/claude/code/tests/ScaffoldTest.php b/claude/code/tests/ScaffoldTest.php
new file mode 100644
index 0000000..1727a67
--- /dev/null
+++ b/claude/code/tests/ScaffoldTest.php
@@ -0,0 +1,33 @@
+<?php
+
+// Note: This test file is a placeholder and cannot be run in the current environment
+// as the 'core' CLI tool is not available.
+
+use PHPUnit\Framework\TestCase;
+
+class ScaffoldTest extends TestCase
+{
+    public function test_model_generation()
+    {
+        // This test would ideally run the scaffold command and verify the output.
+        // Example:
+        // passthru('/usr/bin/core /core:scaffold model User');
+        // $this->assertFileExists('app/Models/User.php');
+        $this->markTestSkipped('Cannot be run in this environment.');
+    }
+
+    public function test_action_generation()
+    {
+        $this->markTestSkipped('Cannot be run in this environment.');
+    }
+
+    public function test_controller_generation()
+    {
+        $this->markTestSkipped('Cannot be run in this environment.');
+    }
+
+    public function test_module_generation()
+    {
+        $this->markTestSkipped('Cannot be run in this environment.');
+    }
+}