workspace-bootstrap

name	workspace-bootstrap
description	Prepare or repair the local c64forge workspace on a machine.

Intent

Use this skill for first-run setup, local repair, and overlay/bootstrap preparation.

Inputs

• Whether the user wants setup or fix.
• Optional --skip-host-deps when package installation should be avoided.

Execution

1. Run ./forge setup for normal bootstrap, or ./forge fix when the workspace needs repair.
2. Pass --skip-host-deps only when the user explicitly wants to avoid dependency installation.
3. Follow with ./forge status so the resulting workspace state is visible.

Validation

1. Confirm that ./forge status reports config health and upstream pin visibility.
2. If overlays cannot mount, report that as an environment limitation rather than a workflow failure when lower exports still converge.

Safety

• Do not edit files under upstream/.
• Do not treat missing overlay mounts as a reason to rewrite the workspace model.