Skip to content

The open-source app everyone uses to manage agents at work

Document imported heartbeat defaults

dotta6f1ce3bd60cc
diff --git a/doc/SPEC-implementation.md b/doc/SPEC-implementation.md
index 21406e18d9..b51a044708 100644
--- a/doc/SPEC-implementation.md
+++ b/doc/SPEC-implementation.md
@@ -868,6 +868,7 @@ Export/import behavior in V1:
- create a new company
- import into an existing company
- import recreates exported project workspaces and remaps portable workspace keys back to target-local workspace ids
+- import forces imported agent timer heartbeats off so packages never start scheduled runs implicitly
- import supports collision strategies: `rename`, `skip`, `replace`
- import supports preview (dry-run) before apply
- GitHub imports warn on unpinned refs instead of blocking
diff --git a/docs/guides/board-operator/importing-and-exporting.md b/docs/guides/board-operator/importing-and-exporting.md
index ae4f36a6ee..9923b0ae5e 100644
--- a/docs/guides/board-operator/importing-and-exporting.md
+++ b/docs/guides/board-operator/importing-and-exporting.md
@@ -140,6 +140,8 @@ The preview shows:
- **Env inputs** — Environment variables that may need values after import
- **Warnings** — Potential issues like missing skills or unresolved references
+Imported agents always land with timer heartbeats disabled. Assignment/on-demand wake behavior from the package is preserved, but scheduled runs stay off until a board operator re-enables them.
+
### Common Workflows
**Clone a company template from GitHub:**