flow-discover

1# Discover contract
2 
3Execute research only after explicit invocation. Run discovery in the main
4conversation, using its available file and delegation tools. Carry forward the
5requirements and constraints already supplied by the user. Set `OCTO_SKILL_FILE` to the
6absolute path of this loaded `SKILL.md` supplied by the host, then run the block
7below. It finds the installation even when Codex has not run trusted hooks or
8created the stable plugin link. An explicit host root can be used when the host
9supplies no skill path; stop if neither source resolves this installation.
10 
11```bash
12OCTO_ROOT="${CLAUDE_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT:-${OCTO_ROOT:-}}}"
13if [[ -n "${OCTO_SKILL_FILE:-}" ]]; then
14  [[ "$OCTO_SKILL_FILE" == /* && -f "$OCTO_SKILL_FILE" ]] || exit 1
15  OCTO_ROOT="$(cd "$(dirname "$OCTO_SKILL_FILE")" && pwd -P)"
16  while [[ "$OCTO_ROOT" != / && ! -f "$OCTO_ROOT/.claude-plugin/plugin.json" && ! -f "$OCTO_ROOT/.codex-plugin/plugin.json" ]]; do
17    OCTO_ROOT="$(dirname "$OCTO_ROOT")"
18  done
19fi
20[[ -n "$OCTO_ROOT" && -f "$OCTO_ROOT/scripts/orchestrate.sh" && -f "$OCTO_ROOT/skills/flow-discover/SKILL.md" ]] || {
21  printf '%s\n' 'Cannot resolve this installed Octopus skill' >&2
22  exit 1
23}
24```
25 
26For a **new discovery only**, execute this bootstrap in the same shell call as
27the root-resolution block above, before loading preparation or writing project
28state. Do not split these two blocks across shell calls:
29 
30```bash
31RUN_TIMESTAMP="$(date +%s)"
32…