engine

Orchestrates a persistent phase-based engineering cycle with role agents and risk gates.

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/GuilhermeBrancalhao/ENGINE-CODEX --skill engine-guilhermebrancalhao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: engine
Source: https://github.com/GuilhermeBrancalhao/ENGINE-CODEX/tree/main/skills/engine
Command: npx skills add https://github.com/GuilhermeBrancalhao/ENGINE-CODEX --skill engine-guilhermebrancalhao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long engineering prompts pasted into a skill lose effectiveness after a few turns because the instructions sink in context and vanish after compaction. This Skill replaces prompt text with on-disk state: the cycle lives in .engine/estado.json and a UserPromptSubmit hook re-injects a compact status card every turn, so the engineering mode persists for the whole session. ## Core Features & Use Cases - Phase cycle with enforced transitions: DESCOBERTA → ANÁLISE → EVOLUÇÃO → PLANO → gate → BUILD ⇄ TESTE → REVISÃO → DOC → ENTREGA, with out-of-graph transitions refused by the CLI. - Role-based subagents: nine roles (descobridor, cartografo, arquiteto, designer, implementador, testador, revisor, sentinela, documentador) dispatched per phase, where only the implementador has broad write access and the revisor structurally cannot fix code silently. - Risk gates and plan gate: the risk hook blocks dangerous actions with [R<n>] codes requiring explicit user confirmation, and the plan gate pauses for user approval of architecture and stack decisions. - Use Case: Start a full end-to-end feature build by running /engine add user authentication, letting the motor drive discovery, planning with an approval gate, implementation, testing, review, and documentation while state survives context compaction. ## Quick Start Ask the AI to run /engine followed by a one-sentence objective, such as "/engine build a REST API for task management", to start the persistent engineering cycle.

Frequently Asked Questions about engine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a persistent engineering cycle in Claude Code?▼

Run /engine followed by a one-sentence objective. The skill invokes the plugin CLI through hooks/engine.sh with ENGINE_RAIZ set to the current project directory, which creates the cycle state in .engine/estado.json and enters the DESCOBERTA phase.

How do I resume an engineering cycle in a new session?▼

Use /engine retomar to resume an existing cycle. The CLI reads the persisted state file and presents a re-entry summary, so the phase, scope, and decisions survive across sessions and context compaction.

Why does python -m ferramentas.cli fail with ModuleNotFoundError?▼

The plugin package is not on sys.path in the user's project directory. Always invoke the CLI via bash "${CLAUDE_PLUGIN_ROOT}/hooks/engine.sh" "${CLAUDE_PLUGIN_ROOT}/ferramentas/cli.py", which detects py, python3, or python at runtime on any platform.

What happens when the risk hook blocks an action with [R<n>]?▼

The action is locked and must not be retried through another tool or path. Present what you intend to do and its impact to the user, then request confirmation with clickable options before proceeding.

Can I run a planning-only cycle without writing code?▼

Yes, append --dry to the /engine command. This runs a cycle that only plans and reports without writing files, useful for evaluating architecture and approach before committing to implementation.

What are the limitations of the phase transition graph?▼

Transitions outside the defined graph (DESCOBERTA through ENTREGA) are refused by the CLI in code. If a transition is refused, the intended phase is wrong; the machine cannot be bypassed, and the plan gate is the only mandatory per-phase stop.