# Kungfu Agent Onboarding

> Discover the exact Kungfu Project, WorkConsole, WorkRef, Skill catalog, and Core Work state admitted to this OpenCode process.

- Skill: `kungfu-systems/kungfu-agent-onboarding-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kungfu-systems/kungfu-agent-onboarding-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kungfu-systems/kungfu-agent-onboarding-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: kungfu-systems (https://skillmd.com/u/kungfu-systems)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kungfu-systems/kungfu-agent-onboarding-3

---


# Kungfu Agent Onboarding

When `KUNGFU_AGENT_ENVIRONMENT=native-interactive`, use the in-process
environment envelopes before acting:

- `KUNGFU_AGENT_CONSOLE_ENVELOPE` identifies the exact Project, WorkConsole,
  SessionAttempt, runtime Profile, and optional WorkRef.
- `KUNGFU_SKILL_CONTEXT` advertises the compact Skill catalog. Load full Skill
  instructions only through the declared Kungfu entrypoint.
- `KUNGFU_AGENT_CONTEXT` and its entrypoints are discovery pointers, not a
  prior chat transcript.
- `KUNGFU_PRIOR_TRANSCRIPT_BYTES=0` means continuity comes from Core evidence,
  never hidden provider conversation state.

Confirm current facts with read-only commands when needed:

```sh
"$KUNGFU_CLI_BIN" agent console current --json
"$KUNGFU_CLI_BIN" agent bootstrap-status --json
"$KUNGFU_CLI_BIN" agent capabilities --json
"$KUNGFU_CLI_BIN" skill catalog --json
"$KUNGFU_CLI_BIN" work status --workspace <path> --initiative-id <id> --assignment-id <id>
"$KUNGFU_CLI_BIN" agent session list --json
```

A bare `kungfu run opencode` launch is intentionally Work-unbound so many
terminal windows can start in the same Project. As soon as you choose or accept
one Assignment, and before editing files or invoking a Work mutation, run:

```sh
"$KUNGFU_CLI_BIN" agent console bind-work --initiative-id <id> --assignment-id <id> --json
```

Keep the provider UI available when bootstrap is pending or degraded, but do
not create, bind, or mutate Work until `kungfu agent bootstrap-status --json` reports
`state: verified`.

The `plan-native-bind-work` and `bind-native-work` capability names are
internal Session protocol operations, not public CLI entrypoints; never invoke
them through `kungfu agent session`.

When durable Work may reduce continuity, handoff, evidence, duplicate retry,
or external-write risk, submit only bounded structured signals to `kungfu agent
work-advisory --signals <signals.json> --json`. Never include a transcript,
hidden reasoning, credentials, or unrelated context. For `recommend`, show the
returned preview and ask its single confirmation. Only after confirmation use
the returned existing `kungfu.work.capture`, `kungfu.work.admit`, and
`kungfu.agent.console.bind-work` path, cite its receipts, and continue the
original task. Suppress a decline for the returned evidence root until the
structured evidence changes. Advice grants no external authority.

For Skill reuse or creation, send only rooted catalog/Work/requirements evidence,
candidate roots, enums, and booleans to `kungfu agent skill-advisory --signals
<signals.json> --json`. Consume its shared policy root
`sha256:dc8ebb873760e55c40ef19b8354ba1e2b91706064a48dec00b1eb8dac0479267`;
do not reproduce the decision policy in provider prose. The result is read-only.

Do not continue unless it returns `status: bound`. If Kungfu reports
`native_work_already_active`, stop this Work in the current terminal and follow
the returned guidance; never bypass the guard or become a second writer.

Do not infer Work completion from terminal output or process exit. Mutate Work
only through public Profile/KFD actions and their receipts. The Kungfu TUI is
an observer of this native UI and never owns OpenCode input or transcript
bytes.