# Engine.plan
URL: https://lsd.tools/docs/api-engine-plan
Updated: 2026-07-17

## Parameters

| name | type | default | description |
|---|---|---|---|
| `target` | `str \| Entity \| None` | `None` | one entity by name or instance; `None` plans every entity |

## Example

```python
plan = engine.plan("sales")
would_run = [s["step_class"] for s in plan["steps"] if s["will_run"]]
```

## Notes

Read-only: it reads the manifest and current parameters and writes nothing. Assumes `resume=True`
(the default `run` behaviour) and models a real run exactly — including the cache-broken cascade
(once any step reruns, later steps rerun too) and the frozen short-circuit (a frozen step is served
from cache and resets the cascade).

## See also

**API:** [diff](/docs/api-engine-diff) · [run](/docs/api-engine-run) · [Engine](/docs/api-engine)