Skip to content

codex.md

Latest commit

 

History

History
53 lines (40 loc) · 2.05 KB

codex.md

File metadata and controls

53 lines (40 loc) · 2.05 KB
Raw

@AGENTS.md

@./.grok/agent/orca-contribution.md

Codex CLI — Orca contribution notes

Codex loads root AGENTS.md for product rules. This file (and CLAUDE.md) is a project_doc fallback for contribution process on the innocarpe fork.

Process (summary)

Item Value
Primary $HOME/Projects/OpenSources/orca — always main
Worktrees $HOME/Projects/OpenSources/orca-worktrees/fix-<N> from upstream/main
SSOT notes/orca-contribution/BOARD.md + HISTORY.md + PORTFOLIO.md (gitignored)
Dual PR upstream stablyai/orca + fork portfolio via .grok/skills/oss-pr-mirror
Merge north star skill orca-merge-playbook — focused + preserves + regression (not open volume)

Skills

./.grok/install-agent-skills.sh

Installs into .agents/skills/ (gitignored; Codex project skill discovery).
Canonical tracked skills: .grok/skills/*/SKILL.md.

  • orca-merge-playbook — always load on contribution work (merge-rate gates)
  • orca-contribution — full loop
  • oss-pr-mirror — dual-track PRs
  • orca-free-issue — scout/implement free issues (playbook-filtered)
  • orca-worktree — worktree create/cleanup

Dual PR quick path

ORCA_PRIMARY="${ORCA_PRIMARY:-$HOME/Projects/OpenSources/orca}"
MIRROR="$ORCA_PRIMARY/.grok/skills/oss-pr-mirror/scripts/mirror-upstream-pr.sh"
SYNC="$ORCA_PRIMARY/.grok/skills/oss-pr-mirror/scripts/sync-contribution-push.sh"
PREPARE="$ORCA_PRIMARY/.grok/skills/oss-pr-mirror/scripts/prepare-pr-followup.sh"

git push -u origin HEAD
gh pr create --repo stablyai/orca --base main --head innocarpe:<branch> ...
"$MIRROR" <upstream-pr-number>
# Every open-PR follow-up, before editing/replying:
"$PREPARE" # then edit, rerun tests, commit
"$SYNC" --comment "…"

Do not implement on primary main. Do not PR harness-only .grok/ commits to upstream.
Do not publish any open-PR follow-up before rebasing onto freshly fetched upstream/main. PR body must include Focused fix / Preserves / Evidence (orca-merge-playbook).