skenetechnologies/skene/deploy-telemetry

Deploy Telemetry

Set up analytics infrastructure via the Skene CLI.

Agent behavior rules

• Autonomous. Run CLI commands, report results, suggest next step. No mid-flow questions except for genuine blockers.
• CLI is the source of truth. Do NOT fabricate migration schemas or client code if the CLI fails.
• User cannot type into agent terminals. Pipe safe defaults for routine prompts. Kill stuck terminals.
• Upstream push can be a genuine blocker. Ask the user in chat to confirm before running uvx skene push — it POSTs skene-context/engine.yaml, {output_dir}/feature-registry.json when present, and the latest trigger migration to Skene Cloud (it does not generate SQL; run uvx skene build first if artifacts are missing).

Steps

1. Discover CLI options

Run uvx skene push --help to see available flags. Use only flags that appear in the output.

1. Verify prerequisites

• skene-context/engine.yaml must exist; trigger SQL lives under supabase/migrations/ as *_skene_triggers.sql after uvx skene build (older projects may use legacy *skene_trigger* / *skene_telemetry* filenames).
• Feature registry: default skene-context/feature-registry.json (or {output_dir} from config; legacy skene/feature-registry.json auto-detected). If missing, push still runs but omits the registry until build creates it.
• If engine or migrations are missing: tell the user to run uvx skene build first, then retry deploy.
• ls supabase/ 2>/dev/null — if missing: "No Supabase directory. Set up Supabase first."

1. Ask user to confirm

Tell the user: "uvx skene push uploads engine, feature-registry.json (if present), and latest *_skene_triggers.sql to upstream. Proceed?" Wait for confirmation.

1. Run push

After user confirms, run uvx skene push with appropriate flags from --help output. Report which migration file was packaged (latest eligible under supabase/migrations/) and that upstream received the deploy.

1. Report result

Engine path, registry path (if packaged), trigger migration path, next step: apply DB migrations locally if needed (supabase db push), then "Run /skene-status to verify."

1. Privacy reminder (one line)

"Remember GDPR/CCPA consent management before production tracking."

Error handling

• CLI failure: Report error, suggest fix.
• Permission errors: Give user the command for their terminal.

Output

Deploy result (or error), paths used, next step (/skene-status).