Skip to content

Latest commit

 

History

History
51 lines (26 loc) · 4.49 KB

FAQ.md

File metadata and controls

51 lines (26 loc) · 4.49 KB

Entwurf FAQ

Short answers for people meeting Entwurf from a different agent-harness tradition.

Is Entwurf an agent factory or a subagent framework?

No. Entwurf is closer to a workshop than a factory: it connects independently owned, visible sibling sessions without turning them into workers of a new central runtime. A harness may run its own subagents or teams, but that remains the harness's responsibility.

What does Entwurf do?

It opens, reopens and messages visible sibling sessions across independent harnesses, each under a stable garden id. entwurf_fresh_call opens a new sibling in the caller's Herdr workspace or tmux session by default, entwurf_resume_call reopens a dormant pi or Claude Code sibling under the same id, and entwurf_v2 delivers a message, reply or hand-off to an existing one through the rail it actually supports. It does not reconstruct prompts, hydrate transcripts, manage credentials, or emulate another harness.

What is a garden id?

A garden id is the stable address of one visible, record-backed session. Think of it as an invitation to a shared workshop table, not a worker name, a pane id, a transcript id, or a worktree lease.

How are session state and project state separated?

Entwurf does not merge or isolate either one. Each harness keeps its own authentication, tools, transcript, and workspace policy. Git branches, worktrees, file locks, task allocation, and any coordination around a shared checkout belong to the operator and the harnesses involved; a garden id is never a file-isolation claim.

What happens to a harness's internal subagents?

The visible top-level session is the garden principal. Internal children remain inside that harness and do not receive a second garden id, separate delivery authority, or an Entwurf-managed access-control layer.

Does sending a message start a process?

No. entwurf_v2 only addresses an existing garden citizen and selects its supported delivery rail. entwurf_fresh_call opens a new visible sibling; entwurf_resume_call reopens a dormant pi or Claude Code citizen under the same id.

Can an agent retire a sibling on its own?

No. entwurf_retire_call (new in 0.41.0) attempts retirement of one Pi or Claude Code sibling, and only one the human operator explicitly requested. Seeing the tool, a coordinator role or the caller's identity is not permission; where a host provides an approval step it applies too, and Pi and pi-durable 1.3.0 have none by default. The configured Claude ACP child is also set to run without per-call permission prompts; that is source configuration, not measured ACP retirement. The record stays, so entwurf_resume_call can reopen the same id, and an unknown result is never a reason to retry.

Where do visible siblings open?

Inside Herdr, Entwurf opens a new unfocused tab in the caller's workspace and currently admits pi and Claude Code. Outside Herdr, it opens one of the fixed pi, pi-durable, Claude Code, Copilot, OMP, or Codex runtimes in a new window of the caller's tmux session, or of an existing session the caller names; without an explicit tmux placement, a Codex caller opens beside its own TUI pane. A dormant pi or Claude Code sibling reopens under the same id in a visible tmux window. The runtime keeps its own model, tools, authentication, and transcript.

Does Entwurf replace Herdr or tmux?

No. Herdr and tmux provide visible seats. Entwurf opens siblings into them, reopens dormant pi or Claude Code siblings, and carries identity, delivery, and receipts across independent harness sessions. A pane or tmux session is a location for a sibling, never its address or liveness proof.

How do I install it?

Use the direct installation route for the broader harness surface. In an existing Herdr workbench, use the Herdr integration guide; it activates only Herdr-integrated pi and Claude Code and leaves the rest to the direct route.

How do I start pi as a citizen?

After the direct install, run entwurf pi; it starts pi with Entwurf's control surface. The Herdr integration does not put entwurf on PATH, so its documented command remains pi --entwurf-control.

Where is the precise contract?

AGENTS.md owns the project invariants. DELIVERY.md, VERIFY.md, and docs/adding-a-harness.md own capability, evidence, and admission details.