Submit Branch

Publish the current branch as a pull request on mermaid-js/zenuml-core. Reuses an existing PR if one already exists for this branch.

Preconditions

The worktree must be in a committable state:

• Clean worktree — nothing to commit, just push. This is the ideal case.
• Scoped changes — all modified files relate to the current work. Stage and commit them.
• Mixed/unrelated changes — modified files include unrelated work. Stop and ask the user which files to include. Never auto-commit a mixed worktree.

To check: git status and review the file list. If in doubt, ask.

Steps

1. Check worktree state

git status

If dirty, evaluate whether changes are scoped (all related to the branch's purpose) or mixed. If mixed, stop and ask.

If scoped, stage the relevant files and commit with a descriptive message. Follow the repo's commit conventions (one-line message, Co-Authored-By trailer).

2. Push

git push -u origin <branch-name>

Use regular push — never force-push. If push fails due to upstream changes, report the conflict and stop.

3. Create or reuse PR

Check if a PR already exists:

gh pr view --json number,title,url 2>/dev/null

If a PR exists, report its URL and stop — nothing more to do.

If no PR exists, create one:

gh pr create --title "<concise title>" --body "$(cat <<'EOF'
## Summary
<bullet points>

## Test plan
<what was tested>
EOF
)"

The PR targets main on mermaid-js/zenuml-core.

Output

Report:

• SUBMITTED — PR number, URL, and branch name
• FAILED — what went wrong (dirty worktree, push conflict, gh error)

Does NOT

• Run tests or lint (use /validate-branch for that)
• Fix CI failures (use /babysit-pr for that)
• Merge the PR (use /land-pr for that)