onboarding

Automated workspace setup for Macrodata uses guided phase-based prompts to create identity, human profile, and workspace state files. It initializes structures like identity.md and workspace.md, reducing manual configuration time and preventing misconfigurations during first-run onboarding.

Before starting Macrodata onboarding, you need the Bun runtime installed. The onboarding process includes prerequisite checks that verify required tools are present and offers automated installation if Bun is missing from your environment.

Guided phase-based onboarding detects missing workspace context by checking if state files are absent or if it is the first run. It then uses minimal conversational prompts to gather identity details, preferred location, and project context to automatically populate the required files.

You can configure workspace permissions and project context using interactive conversational prompts. The onboarding process uses AskUserQuestion to present multiple-choice options for location, permissions, and basic context, improving the setup experience without requiring manual file edits.

First-run Macrodata identity initialization creates and populates essential state files including identity.md, human.md, today.md, workspace.md, and the initial topic structure. These files establish the foundational memory structure required for ongoing workspace operations.

Automated onboarding is designed specifically for first-run initialization or when state files are missing. If you already have existing identity and workspace state files configured correctly, you should not trigger the onboarding process to avoid overwriting your current Macrodata setup.