install-wizard

What problem does it solve?

Manually setting up forge-harness (FH) for new projects or first-time installs is error-prone and time-consuming, with easy-to-miss configuration steps that break AI collaboration workflows and audit cadences. This skill eliminates that guesswork by automating the entire setup process with built-in safety guardrails.

Core Features & Use Cases

• Automated Environment Detection & Gap Diagnosis: Scans your system to identify missing FH components like plugins, zshrc hooks, sentinels, and audit configurations, with a clear score of your setup completeness.
• Interactive Per-Item Approval Workflow: Lets you review and approve each setup step individually, with previews for irreversible changes like file writes and shell modifications, so you never get unexpected changes.
• Multiple Execution Modes: Supports normal interactive setup, dry-run analysis for pre-setup planning, and inspection mode for re-runs on existing FH installs to fix only new gaps, plus special Mode D setup for FH developers building companion stores.
• Use Case: A developer who just cloned the forge-harness repo can run this wizard to automatically configure all required components, set up weekly audit reminders, and integrate FH with their existing project harness in minutes without manual configuration.

Quick Start

Run the install-wizard skill immediately after cloning forge-harness to automatically detect your environment, diagnose missing setup items, and guide you through interactive configuration of all required FH components.