commit

The user wants to commit work done across LiteStack. Because backend/ and frontend/ are separate git repositories (submodules), a meta-level commit is a few ordered steps, not one git commit. Get the order right or the meta-repo will point at commits that were never pushed.

Step 0: Write the session retrospective (mandatory)

Before anything else, run the /retro skill to record what went badly this session into docs/retro/. This is the project's mistake-memory that future agents read before touching code (root AGENTS.md → START HERE). Skip the file write only if the session was genuinely clean — but always run the skill so that judgement is made deliberately, not by omission. The retro file is a meta-repo file; it gets staged and committed in Step 4–5 below.

Step 1: Detect the operating mode

Read root .agents/OPERATING-MODE.md. In short:

git config -f .gitmodules submodule.liteend-go.url
git config -f .gitmodules submodule.litefront.url

• URLs point at canonical uxname/* → TEMPLATE mode (push submodules to upstream).
• URLs point at your own repos → DERIVED mode (push submodules to your repos).

If you are unsure which mode applies or whether you should push, ask the user in plain language before pushing.

Step 2: See what changed and where

git status                  # at meta root: shows which submodules are dirty + meta files
git submodule status

Step 3: Commit inside each changed submodule

For each submodule that has changes (backend and/or frontend):

cd <submodule>
# Run that project's own gate FIRST, from its AGENTS.md:
#   backend  → task check      (and task test:cov before pushing)
#   frontend → npm run check   (verify:push runs on pre-push)
git add -A && git commit       # conventional commits; the pre-commit hook re-runs the gate
git push                       # push to the submodule's remote (per the detected mode)
cd ..

Do not skip the submodule's pre-commit / pre-push hooks. Never use --no-verify — there is no CI behind them.