The deployed Engine that maintains, improves, and repairs engine-template.
An Engine is the externalized state, memory, guardrails, and control plane a non-engineer uses to direct cold-booting AI sessions on a project. This repository is a fully deployed Engine whose project is the template itself: it is a real deployed Engine built from engine-template and run against it, so the bugs a freshly-generated repo would hit surface here first and get fixed at the source.
- Receives updates from engine-template.
module_manager.py upgradefetches a tagged release from the recorded update source (home_repositoryin.engine/engine.json→StarshipSuperjam/engine-template) and opens a reviewed pull request — the engine never overwrites itself in place. - Is built to contribute fixes back to engine-template through the
external-contributionmodule, so a repair made here can travel upstream (this path is not yet exercised end to end — see Status). - Governs its own changes. Every change lands through the protected-branch review gate on
main; the operator's merge is the binding approval.
docs/ holds the written design for engine-template — what it does, the principles
behind it, how it fits together, and the decisions that got it there. First written in a separate design
workspace and carried here as intended design, it has since been reconciled document by document to describe
engine-template as built, AI-compared against one pinned commit and edited under per-item operator
rulings (decision 0320) —
and then settled: the operator accepted the reconciled capability documents as the ratified baseline
(decision 0331), so changing one
now requires the operator's recorded re-acceptance at the merge.
Read the product spec index first: it records the pinned commit the corpus describes, explains what settling does and does not guarantee, and that the code these documents describe lives in that other repository, not this one.
/engine-status— where the project stands and what needs attention./engine-help— what the engine can do and how to ask./engine-conduct— tune how the engine works with you.
This repository is deployed and update-ready. Performing its maintenance mission end-to-end additionally
requires a working checkout of engine-template to change, and the external-contribution submit path has not
yet been exercised end-to-end — both deferred until needed.
Apache License 2.0 with the Commons Clause condition — see LICENSE.