| name | gestor-module-integration |
| description | Use when creating, fixing, reviewing, or refactoring gestor modules in Conn2Flow private projects. Especially when there is risk of forgetting modulo-id, JSON, the *_start() function, final autorun, switch($_GESTOR["opcao"]), switch($_GESTOR["ajax-opcao"]), resources, hooks, API, or widget integration. |
| user-invocable | false |
Gestor module integration
Use this skill when the task is not only an isolated business rule, but a structural adjustment in a gestor module.
When to use
- create a new module in
gestor/modulos/
- fix a module that responds only partially at runtime
- refactor a module with risk of breaking bootstrap, interface, or AJAX
- review a module diff that looks functional in the file, but incomplete inside gestor
Procedure
- Reread one simple module and one richer module as references before the first edit.
- Confirm the module's structural contract: bootstrap, JSON, resources, pages, variables, hook, API, widget, and the
*_start() function when applicable.
- If the task touches a hook, API, or widget, include those layers in the reading and diff instead of concluding from the main PHP file alone.
- After the first substantive edit, validate in the smallest scope capable of falsifying the integration.
- If structural doubt remains, reread the Conn2Flow core flow that includes the module and closes interface or AJAX before expanding the diff.
Common snippet mistakes
- do not use
$_REQUEST[$post_nome] without isset() or empty()
- confirm that the database call is the correct function (
banco_select, banco_update, etc.)
- confirm PHP strings with
; and templates with correct tags
- for AJAX, confirm sending
ajaxOpcao and handling it in $_GESTOR['ajax-opcao']
- when using model helpers, verify consistency of
modelo_var_troca, modelo_var_troca_tudo, modelo_tag_val, modelo_tag_troca_val, modelo_var_in, and modelo_tag_del
What this skill prevents
- a module with business functions but no
*_start()
- a normal branch without
interface_iniciar() and interface_finalizar()
- an AJAX branch without
interface_ajax_iniciar() and interface_ajax_finalizar()
- JSON, pages, or variables inconsistent with the PHP and HTML
- forgotten hooks, API, or widget pieces when the module depends on them
