---
name: add-phpengine-plugin
description: Create or modify a discoverable PHP plugin for the phpengine backend. Use when the user asks to create a plugin, add a menu entry, or add a permission in the phpengine project. Fetches the official recipe and follows it step by step.
---

# Add a phpengine Plugin

## Step 1 — Fetch the official recipe (mandatory, every time)

Fetch this URL before doing anything else, it is the single source of truth:

```
https://gogs.gvoci.com/softword/phpengine/raw/main/specs/rules/add-plugin.md
```

Use whatever fetch tool is available (web fetch, curl, ...). Never rely on
memory or prior knowledge of its content: it may have changed.

If the fetch fails, stop and ask the user to paste the file. Do not proceed
without it.

## Step 2 — Follow the recipe exactly

Execute the steps in the fetched recipe in order, without skipping or
reinterpreting them.

## Basecode root (path override)

All repository-relative paths in the recipe resolve from this basecode root:

```
phengine/
```

Example: the recipe's `src/Modules/` means `phengine/src/Modules/`, so a plugin
named `Example` is created at:

```
phengine/src/Modules/Example/Example.php
```

## Docs referenced by the recipe

When the recipe links other specs (e.g. `add-api-endpoint.md`,
`module-index.md`), resolve them against the same base:
`https://gogs.gvoci.com/softword/phpengine/raw/main/specs/` and fetch them
before acting on the related step.