rpi — Skillopedia

$rpi - Full Lifecycle Orchestrator Quick ref: - - , then report. Execute this workflow. Do not only describe it. RPI is autonomous unless is set. The user touchpoint is after validation, or after a real blocked state exhausts retries. Read references/autonomous-execution.md when you need the full autonomy contract. When an external executor fails but the code surface may still be valid, read references/codex-executor.md and recover through Codex direct checks before declaring a source-level regression. Codex Lifecycle Guard When this skill runs in Codex hookless mode ( is set or is ), run: Le…

\"\ncheck \"SKILL.md has name: rpi\" \"grep -q '^name: rpi' '$SKILL_DIR/SKILL.md'\"\ncheck \"references/ directory exists\" \"[ -d '$SKILL_DIR/references' ]\"\ncheck \"references/ has at least 3 files\" \"[ \\$(ls '$SKILL_DIR/references/' | wc -l) -ge 3 ]\"\ncheck \"SKILL.md mentions research phase\" \"grep -qi 'research' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions plan phase\" \"grep -qiE '/plan|plan' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions pre-mortem phase\" \"grep -qi 'pre-mortem' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions crank phase\" \"grep -qiE '(/crank|\\\\\\$crank)' '$SKILL_DIR/SKILL.md'\"\ncheck \"SKILL.md mentions vibe phase\" \"grep -qiE '/vibe|vibe' '$SKILL_DIR/SKILL.md' '$SKILL_DIR/references/phase-data-contracts.md'\"\ncheck \"SKILL.md mentions post-mortem phase\" \"grep -qi 'post-mortem' '$SKILL_DIR/SKILL.md'\"\ncheck \"RPI docs mention next-work handoff metadata\" \"grep -q 'queue claim/finalize metadata' '$SKILL_DIR/SKILL.md' '$SKILL_DIR/references/phase-data-contracts.md'\"\ncheck \"phase-data-contracts documents claim lifecycle\" \"grep -q 'claim_status' '$SKILL_DIR/references/phase-data-contracts.md' && grep -q 'release the claim back to available state' '$SKILL_DIR/references/phase-data-contracts.md'\"\ncheck \"gate4-loop-and-spawn documents claim before consume\" \"grep -q 'claim the current cycle' '$SKILL_DIR/references/gate4-loop-and-spawn.md' && grep -q 'Never mark an item consumed at pick-time' '$SKILL_DIR/references/gate4-loop-and-spawn.md'\"\ncheck \"RPI docs mention repo execution profile\" \"grep -qi 'repo execution profile' '$SKILL_DIR/SKILL.md' '$SKILL_DIR/references/phase-data-contracts.md'\"\ncheck \"RPI docs mention execution packet\" \"grep -qi 'execution packet' '$SKILL_DIR/SKILL.md' '$SKILL_DIR/references/phase-data-contracts.md'\"\ncheck \"RPI docs mention contract_surfaces\" \"grep -q 'contract_surfaces' '$SKILL_DIR/SKILL.md' '$SKILL_DIR/references/phase-data-contracts.md'\"\ncheck \"RPI docs mention done_criteria\" \"grep -q 'done_criteria' '$SKILL_DIR/SKILL.md' '$SKILL_DIR/references/phase-data-contracts.md'\"\ncheck \"phase-data-contracts documents execution packet\" \"grep -q 'execution_packet' '$SKILL_DIR/references/phase-data-contracts.md' && grep -qi 'repo execution profile' '$SKILL_DIR/references/phase-data-contracts.md'\"\n\necho \"\"; echo \"Results: $PASS passed, $FAIL failed\"\n[ $FAIL -eq 0 ] && exit 0 || exit 1\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":2696,"content_sha256":"e8bd9b5266195a9ce286ee0b44321c6207ed59e13fd36934bf4f6f7df0a51eb3"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"$rpi - Full Lifecycle Orchestrator","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Quick ref: ","type":"text"},{"text":"$discovery","type":"text","marks":[{"type":"code_inline"}]},{"text":" -> ","type":"text"},{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]},{"text":" -> ","type":"text"},{"text":"$validation","type":"text","marks":[{"type":"code_inline"}]},{"text":", then report.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Execute this workflow. Do not only describe it.","type":"text","marks":[{"type":"strong"}]},{"text":" RPI is autonomous unless ","type":"text"},{"text":"--interactive","type":"text","marks":[{"type":"code_inline"}]},{"text":" is set. The user touchpoint is after validation, or after a real blocked state exhausts retries. Read ","type":"text"},{"text":"references/autonomous-execution.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/autonomous-execution.md","title":null}}]},{"text":" when you need the full autonomy contract.","type":"text"}]},{"type":"paragraph","content":[{"text":"When an external executor fails but the code surface may still be valid, read ","type":"text"},{"text":"references/codex-executor.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/codex-executor.md","title":null}}]},{"text":" and recover through Codex direct checks before declaring a source-level regression.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Codex Lifecycle Guard","type":"text"}]},{"type":"paragraph","content":[{"text":"When this skill runs in Codex hookless mode (","type":"text"},{"text":"CODEX_THREAD_ID","type":"text","marks":[{"type":"code_inline"}]},{"text":" is set or ","type":"text"},{"text":"CODEX_INTERNAL_ORIGINATOR_OVERRIDE","type":"text","marks":[{"type":"code_inline"}]},{"text":" is ","type":"text"},{"text":"Codex Desktop","type":"text","marks":[{"type":"code_inline"}]},{"text":"), run:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao codex ensure-start 2>/dev/null || true","type":"text"}]},{"type":"paragraph","content":[{"text":"Let ","type":"text"},{"text":"$validation","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"$post-mortem","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"$handoff","type":"text","marks":[{"type":"code_inline"}]},{"text":" own hookless closeout through ","type":"text"},{"text":"ao codex ensure-stop","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Core Contract","type":"text"}]},{"type":"paragraph","content":[{"text":"RPI delegates via ","type":"text"},{"text":"$discovery","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"$validation","type":"text","marks":[{"type":"code_inline"}]},{"text":" as ","type":"text"},{"text":"separate skill invocations","type":"text","marks":[{"type":"strong"}]},{"text":". Keep strict delegation on by default; do not compress phases, replace phase skills with direct agent spawns, or skip ","type":"text"},{"text":"$validation","type":"text","marks":[{"type":"code_inline"}]},{"text":". Read ","type":"text"},{"text":"../shared/references/strict-delegation-contract.md","type":"text","marks":[{"type":"link","attrs":{"href":"../shared/references/strict-delegation-contract.md","title":null}}]},{"text":" for the full anti-compression contract.","type":"text"}]},{"type":"paragraph","content":[{"text":"When the runtime supports phase isolation, keep ","type":"text"},{"text":"$rpi","type":"text","marks":[{"type":"code_inline"}]},{"text":" visible in the main session and run each phase contract through isolated transport: phase skill name in, bounded handoff artifact in, phase artifact/verdict/next action out. The transport may be a daemon job, process runner, or subagent wrapper, but it must execute the declared phase skill contract rather than doing phase work directly. See ","type":"text"},{"text":"references/isolation-contract.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/isolation-contract.md","title":null}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Context Density Rule","type":"text"}]},{"type":"paragraph","content":[{"text":"At every phase boundary, preserve only context that carries intent, boundary, evidence, decision, constraint, or next action. Omit or link anything else. The domain entry is ","type":"text"},{"text":"../domain/references/context-density-rule.md","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"RPI owns one lifecycle objective across all phases. Preserve the discovered ","type":"text"},{"text":"epic_id","type":"text","marks":[{"type":"code_inline"}]},{"text":" when present; otherwise preserve the original goal and execution packet objective. A child bead or one ready slice is context, not a replacement objective. ","type":"text"},{"text":"\u003cpromise>PARTIAL\u003c/promise>","type":"text","marks":[{"type":"code_inline"}]},{"text":" from ","type":"text"},{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]},{"text":" means retry Phase 2 on the same objective.","type":"text"}]},{"type":"paragraph","content":[{"text":"Preserve the ","type":"text"},{"text":"Intent-to-Loop Hexagon","type":"text","marks":[{"type":"link","attrs":{"href":"../../docs/architecture/intent-to-loop-hexagon.md","title":null}}]},{"text":" boundary as the objective crosses ","type":"text"},{"text":"shape_intent","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"persist_intent","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"plan_slices","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"execute_wave","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"validate_acceptance","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"record_evidence","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Route And Classify","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Create ","type":"text"},{"text":".agents/rpi/","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Resolve ","type":"text"},{"text":"--from","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"default, ","type":"text"},{"text":"research","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"plan","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"pre-mortem","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"brainstorm","type":"text","marks":[{"type":"code_inline"}]},{"text":" -> discovery","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"implementation","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"crank","type":"text","marks":[{"type":"code_inline"}]},{"text":" -> implementation","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"validation","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"vibe","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"post-mortem","type":"text","marks":[{"type":"code_inline"}]},{"text":" -> validation","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the input is a bead and ","type":"text"},{"text":"--from","type":"text","marks":[{"type":"code_inline"}]},{"text":" is absent, resolve it with ","type":"text"},{"text":"bd show","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"epic -> implementation with that epic","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"child with parent -> implementation with the parent epic","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Classify complexity:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"fast","type":"text","marks":[{"type":"code_inline"}]},{"text":": short/simple goal or ","type":"text"},{"text":"--fast-path","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"standard","type":"text","marks":[{"type":"code_inline"}]},{"text":": medium goal or one scope keyword","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"full","type":"text","marks":[{"type":"code_inline"}]},{"text":": ","type":"text"},{"text":"--deep","type":"text","marks":[{"type":"code_inline"}]},{"text":", complex-operation keyword, 2+ scope keywords, or >120 chars","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Log ","type":"text"},{"text":"RPI mode: rpi-phased (complexity: \u003clevel>)","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Track state compactly:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"text"},"content":[{"text":"rpi_state = {\n goal: \"\u003cgoal string>\",\n epic_id: null,\n phase: \"\u003cdiscovery|implementation|validation>\",\n complexity: \"\u003cfast|standard|full>\",\n test_first: \u003ctrue by default; false only when --no-test-first>,\n cycle: 1,\n verdicts: {}\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Phase DAG","type":"text"}]},{"type":"paragraph","content":[{"text":"Enter at the routed phase and run every phase after it.","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Discovery:","type":"text","marks":[{"type":"strong"}]},{"text":" invoke ","type":"text"},{"text":"$discovery \u003cgoal> [--interactive] --complexity=\u003clevel>","type":"text","marks":[{"type":"code_inline"}]},{"text":" directly or through phase-isolated skill transport. On DONE, read ","type":"text"},{"text":".agents/rpi/execution-packet.json","type":"text","marks":[{"type":"code_inline"}]},{"text":" or the run archive and preserve its objective spine. On BLOCKED, stop with the discovery verdict.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Implementation:","type":"text","marks":[{"type":"strong"}]},{"text":" invoke ","type":"text"},{"text":"$crank \u003cepic-id>","type":"text","marks":[{"type":"code_inline"}]},{"text":" when the packet has ","type":"text"},{"text":"epic_id","type":"text","marks":[{"type":"code_inline"}]},{"text":"; otherwise invoke ","type":"text"},{"text":"$crank .agents/rpi/execution-packet.json","type":"text","marks":[{"type":"code_inline"}]},{"text":", directly or through phase-isolated skill transport. Pass ","type":"text"},{"text":"--test-first","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"--no-test-first","type":"text","marks":[{"type":"code_inline"}]},{"text":" through. On DONE, record ","type":"text"},{"text":"ao ratchet record implement 2>/dev/null || true","type":"text","marks":[{"type":"code_inline"}]},{"text":" and continue. On PARTIAL or BLOCKED, retry the same objective up to 3 total attempts.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Validation:","type":"text","marks":[{"type":"strong"}]},{"text":" invoke ","type":"text"},{"text":"$validation \u003cepic-id> --complexity=\u003clevel>","type":"text","marks":[{"type":"code_inline"}]},{"text":" when an epic exists; otherwise invoke ","type":"text"},{"text":"$validation --complexity=\u003clevel>","type":"text","marks":[{"type":"code_inline"}]},{"text":", directly or through phase-isolated skill transport. Add ","type":"text"},{"text":"--strict-surfaces","type":"text","marks":[{"type":"code_inline"}]},{"text":" when ","type":"text"},{"text":"--quality","type":"text","marks":[{"type":"code_inline"}]},{"text":" is set. On FAIL, extract findings, re-run ","type":"text"},{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]},{"text":" on the same objective, then re-run ","type":"text"},{"text":"$validation","type":"text","marks":[{"type":"code_inline"}]},{"text":", up to 3 total validation attempts. On DONE, record ","type":"text"},{"text":"ao ratchet record vibe 2>/dev/null || true","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Report:","type":"text","marks":[{"type":"strong"}]},{"text":" summarize phase verdicts and epic status using ","type":"text"},{"text":"references/report-template.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/report-template.md","title":null}}]},{"text":". With ","type":"text"},{"text":"--loop","type":"text","marks":[{"type":"code_inline"}]},{"text":", restart from discovery on FAIL while ","type":"text"},{"text":"cycle \u003c max_cycles","type":"text","marks":[{"type":"code_inline"}]},{"text":". With ","type":"text"},{"text":"--spawn-next","type":"text","marks":[{"type":"code_inline"}]},{"text":", read ","type":"text"},{"text":".agents/rpi/next-work.jsonl","type":"text","marks":[{"type":"code_inline"}]},{"text":" and suggest the next command without invoking it. Before emitting the report, apply the Context Density Rule: every line should carry intent, boundary, evidence, decision, constraint, or next action.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Phase Data Contract","type":"text"}]},{"type":"paragraph","content":[{"text":"The execution packet carries the repo execution profile through ","type":"text"},{"text":"contract_surfaces","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"done_criteria","type":"text","marks":[{"type":"code_inline"}]},{"text":", and queue claim/finalize metadata. Keep the latest alias at ","type":"text"},{"text":".agents/rpi/execution-packet.json","type":"text","marks":[{"type":"code_inline"}]},{"text":" and read ","type":"text"},{"text":"references/phase-data-contracts.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/phase-data-contracts.md","title":null}}]},{"text":" for schemas and archive paths.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Complexity-Scaled Gates","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Pre-mortem","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"low\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"fast\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": inline review, no spawning (","type":"text"},{"text":"--quick","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"medium\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"standard\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": inline fast default (","type":"text"},{"text":"--quick","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"high\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"full\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": full council, 2-judge minimum; max 3 total attempts","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Final Vibe","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"low\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"fast\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": inline review, no spawning (","type":"text"},{"text":"--quick","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"medium\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"standard\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": inline fast default (","type":"text"},{"text":"--quick","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"high\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"full\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": full council, 2-judge minimum; max 3 total attempts","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Post-mortem (STEP 2)","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"low\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"fast\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": inline review, no spawning (","type":"text"},{"text":"--quick","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"medium\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"standard\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": inline fast default (","type":"text"},{"text":"--quick","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"complexity == \"high\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"\"full\"","type":"text","marks":[{"type":"code_inline"}]},{"text":": full council, 2-judge minimum; max 3 total attempts","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Flags","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Flag","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--from=\u003cphase>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"discovery","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Start at discovery, implementation, or validation","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--interactive","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"off","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Human gates in discovery/validation","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--auto","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"on","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Fully autonomous default","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--loop --max-cycles=\u003cn>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"off / 3","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Iterate when validation fails","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--spawn-next","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"off","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Surface follow-up work after reporting","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--test-first","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"on","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Pass strict-quality preference to ","type":"text"},{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--no-test-first","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"off","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Explicitly opt out of strict-quality","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--fast-path","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--deep","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"auto","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Force fast or full complexity","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--quality","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"off","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Make validation strict surfaces blocking","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--dry-run","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--no-budget","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"off","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Report only, or disable phase time budgets","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"User says:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"$rpi \"add user authentication\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" Run discovery, implementation, validation, then report.","type":"text"}]},{"type":"paragraph","content":[{"text":"User says:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"$rpi --from=implementation ag-23k","type":"text","marks":[{"type":"code_inline"}]},{"text":" Resolve the bead scope, run implementation and validation, then report.","type":"text"}]},{"type":"paragraph","content":[{"text":"User says:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"$rpi --deep \"refactor payment module\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" Use full council gates across the lifecycle.","type":"text"}]},{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"references/examples.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/examples.md","title":null}}]},{"text":" for resume, interactive, and loop examples.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshooting","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Problem","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Response","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Discovery BLOCKED","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Stop and report discovery's manual-intervention reason","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]},{"text":" returns PARTIAL","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Retry ","type":"text"},{"text":"$crank","type":"text","marks":[{"type":"code_inline"}]},{"text":" on the same objective; do not narrow to a child slice","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Validation FAIL","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Re-crank with findings, then re-validate, up to 3 total attempts","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Packet shape unclear","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"references/phase-data-contracts.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/phase-data-contracts.md","title":null}}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"External executor fails","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"references/codex-executor.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/codex-executor.md","title":null}}]},{"text":", run direct Codex validation, and only create follow-up work for reproducible source failures","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference Documents","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/autonomous-execution.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/autonomous-execution.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/complexity-scaling.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/complexity-scaling.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/context-windowing.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/context-windowing.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/codex-executor.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/codex-executor.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/error-handling.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/error-handling.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/examples.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/examples.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/gate-retry-logic.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/gate-retry-logic.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/gate4-loop-and-spawn.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/gate4-loop-and-spawn.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/isolation-contract.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/isolation-contract.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/phase-budgets.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/phase-budgets.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/phase-data-contracts.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/phase-data-contracts.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/report-template.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/report-template.md","title":null}}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/troubleshooting.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/troubleshooting.md","title":null}}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"rpi","author":"@skillopedia","source":{"stars":375,"repo_name":"agentops","origin_url":"https://github.com/boshu2/agentops/blob/HEAD/skills-codex/rpi/SKILL.md","repo_owner":"boshu2","body_sha256":"022f04110e2f9f44d6d6757317752c249b30396d7d98aab162bbd33535f96454","cluster_key":"671fdd72d4ae6ba706a3f95a80ff19fb1d6350439c504f023b31f916a3d66330","clean_bundle":{"format":"clean-skill-bundle-v1","source":"boshu2/agentops/skills-codex/rpi/SKILL.md","attachments":[{"id":"32d80718-3998-5218-a2eb-585eccf30dc3","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/32d80718-3998-5218-a2eb-585eccf30dc3/attachment.json","path":".agentops-generated.json","size":267,"sha256":"65c96b4eae881dd1aca91f501d86422bcc7973355fed1b441a5e81181a732079","contentType":"application/json; charset=utf-8"},{"id":"f8d842ec-5962-5d39-926e-9bd4c6e414f3","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/f8d842ec-5962-5d39-926e-9bd4c6e414f3/attachment.md","path":"prompt.md","size":2365,"sha256":"705c108786a3a019851b9a510e65ecbe3f8603020f62694ccf18269f3758826f","contentType":"text/markdown; charset=utf-8"},{"id":"797d59bc-16aa-5eb5-8a8e-0b946485a0ab","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/797d59bc-16aa-5eb5-8a8e-0b946485a0ab/attachment.md","path":"references/autonomous-execution.md","size":2402,"sha256":"fd7b4b93eb795912f7dcef29aa0975b768ac2f19df535379ca41e52233340398","contentType":"text/markdown; charset=utf-8"},{"id":"dde235e7-908c-592a-a2c4-8c1ea73dc55c","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/dde235e7-908c-592a-a2c4-8c1ea73dc55c/attachment.md","path":"references/codex-executor.md","size":1272,"sha256":"e86cd0ba593465b75381f58664b7ec222adaf31bf4ad7ffdaffa2384c64dfd26","contentType":"text/markdown; charset=utf-8"},{"id":"bc0103ee-557d-535c-8b8f-05627b2ddec5","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/bc0103ee-557d-535c-8b8f-05627b2ddec5/attachment.md","path":"references/complexity-scaling.md","size":1577,"sha256":"93e0a3f7e49e0bbf050bbe6c8069880beb24031708b1cfb0190ad1dc6a5d8d2e","contentType":"text/markdown; charset=utf-8"},{"id":"b3f4135d-cdde-59e9-ae1f-3ae9cee7a471","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/b3f4135d-cdde-59e9-ae1f-3ae9cee7a471/attachment.md","path":"references/context-windowing.md","size":1510,"sha256":"93da8129a8e9758a18275ba4b0ea9b24ae327e5a19e9081e2a49f058bbf31024","contentType":"text/markdown; charset=utf-8"},{"id":"0157f72e-6e0e-5ee4-ad6e-f55b6af1f39e","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/0157f72e-6e0e-5ee4-ad6e-f55b6af1f39e/attachment.md","path":"references/error-handling.md","size":799,"sha256":"8155efe8adbd95dcc03a160ec8985fc649572e6bb1c6f708a472daa8e69c8b7a","contentType":"text/markdown; charset=utf-8"},{"id":"48dea7e7-b6d6-5981-b16c-56670d072c5e","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/48dea7e7-b6d6-5981-b16c-56670d072c5e/attachment.md","path":"references/examples.md","size":714,"sha256":"143f54e5579c8fdbf3b72d2b944db7b37afbd188df3f7e00690817ed0c06f7e5","contentType":"text/markdown; charset=utf-8"},{"id":"79e7a65b-c9d7-5451-9d75-f20ceffeb87d","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/79e7a65b-c9d7-5451-9d75-f20ceffeb87d/attachment.md","path":"references/gate-retry-logic.md","size":4255,"sha256":"a7208b5613ef90ccf49a370520e834d698dcb6dee73693fcf65aef1e96016c45","contentType":"text/markdown; charset=utf-8"},{"id":"1d42acce-cdec-51ee-89e4-04131085a280","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/1d42acce-cdec-51ee-89e4-04131085a280/attachment.md","path":"references/gate4-loop-and-spawn.md","size":5102,"sha256":"9dfe59cf241d1679f0112903807d1655bf38e299560a46257d18e2ba7c16609d","contentType":"text/markdown; charset=utf-8"},{"id":"4a2adf7f-4583-5930-80fb-dcdf20f432d2","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/4a2adf7f-4583-5930-80fb-dcdf20f432d2/attachment.md","path":"references/isolation-contract.md","size":6976,"sha256":"dd583d5a3e6a39350d6c099f560aa0be9155c6c181d304d68408586b39051639","contentType":"text/markdown; charset=utf-8"},{"id":"b45c86c8-8efa-5e85-8a09-f224bc85dc77","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/b45c86c8-8efa-5e85-8a09-f224bc85dc77/attachment.md","path":"references/phase-budgets.md","size":4034,"sha256":"e84def2b0a654c7693addba0a9e154452c65f53f7f9aef355985b8ddc7d479f6","contentType":"text/markdown; charset=utf-8"},{"id":"d7389add-a3a3-5507-9c5e-d3cf58b689f6","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/d7389add-a3a3-5507-9c5e-d3cf58b689f6/attachment.md","path":"references/phase-data-contracts.md","size":4786,"sha256":"0dfb96949b3a5216466306f799937081f2fc09cd36c224adc7cb4c5031761202","contentType":"text/markdown; charset=utf-8"},{"id":"6ecba837-8248-50e1-9dd4-9abf4b1b53f3","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/6ecba837-8248-50e1-9dd4-9abf4b1b53f3/attachment.md","path":"references/report-template.md","size":1399,"sha256":"d6a0eb73bc02d8ceeefcc8cc694ffa9560d37e7cdbae9e4ca413a4382dd38081","contentType":"text/markdown; charset=utf-8"},{"id":"a1d6051a-89e3-5b90-a86a-e300c164ba58","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/a1d6051a-89e3-5b90-a86a-e300c164ba58/attachment.md","path":"references/troubleshooting.md","size":561,"sha256":"224e2c4a02c1d91cb03f3196379fc5737472b1c70ecf27bd5c8298a88fe7072f","contentType":"text/markdown; charset=utf-8"},{"id":"e6b0f4c1-a842-5636-bd43-f87eb98651d6","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/e6b0f4c1-a842-5636-bd43-f87eb98651d6/attachment.sh","path":"scripts/validate.sh","size":2696,"sha256":"e8bd9b5266195a9ce286ee0b44321c6207ed59e13fd36934bf4f6f7df0a51eb3","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"0effe9af10c6e8fa2a7c618a8f8e8e3c50a277ea4a49d87e3e94031d4d881e3b","attachment_count":16,"text_attachments":16,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills-codex/rpi/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"general","category_label":"General"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"general","import_tag":"clean-skills-v1","description":"Run discovery, crank, validation."}},"renderedAt":1782980415980}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.