upstream-contribute

$upstream-contribute — meta-loop: rockie users improve rockie

$propose-harness-change packages improvements against the user's own local clone of rockie-codex. $upstream-contribute is the public counterpart: it dispatches a PR against saml212/rockie-codex so the next release ships the pattern to everyone.

This is the meta-loop. Researchers using rockie-codex in their own work uncover patterns that generalize — a tighter [DEAD-END] query, a hook that catches a stuck-detector edge case, a skill that helps across disciplines. The skill captures one of those, generalizes it, and opens a reviewable PR. The maintainers merge; the next user benefits.

When to run

• The user says "upstream this", "contribute back", "anything generalizable here", "open-source this".
• $clean finishes an audit and emits the post-audit nudge (see clean/SKILL.md → "Post-audit hook").
• A [LEARN harness-upstream] or [LEARN cross-discipline] block was written this session and the user wants to act on it.

Run at most once per session, near the end. Don't dispatch the writer sub-agent during active work — the user wants to review the candidates before any forking happens.

Codex doesn't expose repo-defined slash commands the way Claude Code does, so the practical invocation path is $upstream-contribute or natural language ("contribute back upstream").

Method

The skill mirrors the Generator / Verifier / Updater rigor of $propose-harness-change and adds a Scout step in front (since the upstream PR is a more public artifact than a local patch).

1. Scout (this skill, in-session)

Read recent context to identify candidates:

# [LEARN] rows added this session
/usr/bin/sqlite3 ${OPENCLAW_WORKSPACE_DIR}/memory/workflow.db "
  SELECT category, rule, mistake, correction
  FROM learnings
  WHERE created_at >= datetime('now','-6 hours')
  ORDER BY created_at DESC
"

# Files changed in the last N commits
git log --since='6 hours ago' --name-only --pretty=format:'%h %s'

# Any new skill / hook / script files
git diff --name-only HEAD~5..HEAD -- '${OPENCLAW_SKILLS_DIR}/' '${OPENCLAW_WORKSPACE_DIR}/hooks/' '${OPENCLAW_WORKSPACE_DIR}/scripts/' \
  | grep -E '\.(md|sh|py)$' || true