Skip to content

/120-error-handling

- If any phase fails catastrophically (agent error, required file missing after agent run), **STOP** immediately and report: what phase failed, what file is missing, and what the user should do next. - Mechanic check failures continue to audit — they influence the decision but

From plugin
signum
1823 skills5 agents23 commands
> /plugin marketplace add heurema/signum
> /plugin install signum@signum

Command definition

120-error-handling.md

Error Handling

  • If any phase fails catastrophically (agent error, required file missing after agent run), **STOP** immediately and report: what phase failed, what file is missing, and what the user should do next.
  • Mechanic check failures continue to audit — they influence the decision but do not block Phase 3.
  • If codex or gemini times out (`exit 124`) or returns a non-zero exit code, mark as unavailable and continue.
  • **Never silently swallow errors.** All bash exit codes must be checked. If jq fails to parse a file, report it explicitly.
  • If the synthesizer produces an invalid audit_summary.json, stop Phase 4 and report the problem.
@heurema
Ships withsignum

Signum is a contract-first proof gate for agentic software changes: it turns a task into a reviewed contract, executes against that contract, audits the result, and packages evidence that humans and CI can inspect.

Stars on GitHub

Momentum

stars in total
18
Star history of heurema/signum on GitHub, a chart by star-history.com

Other commands on signum.

apply
Auto-invoked

apply

Command

Implement tasks from an OpenSpec change (Experimental)

@heurema@heuremaInstall Command
archive
Auto-invoked

archive

Command

Archive a completed change in the experimental workflow

@heurema@heuremaInstall Command
explore
Auto-invoked

explore

Command

Enter explore mode - think through ideas, investigate problems, clarify requirements

@heurema@heuremaInstall Command
propose
Auto-invoked

propose

Command

Propose a new change - create it and generate all artifacts in one step

@heurema@heuremaInstall Command
sync
Auto-invoked

sync

Command

Sync delta specs from a change to main specs

@heurema@heuremaInstall Command
update
Auto-invoked

update

Command

Update a change - revise existing planning artifacts and keep them coherent (Experimental)

@heurema@heuremaInstall Command

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command