eforge-build/eforge/eforge-workflow

/eforge:workflow

Configure the eforge workflow preset for this project using the native Pi workflow wizard. Answers four questions to select one of five presets and writes the matching config keys to eforge/config.yaml.

In Pi, this skill is backed by native select-overlay panels (showSelectOverlay / showSearchableSelectOverlay) for each question, providing a visual picker experience. The underlying preset logic and config keys are identical to the Claude Code /eforge:workflow skill.

Commands

• /eforge:workflow — auto-detects mode (init if not configured, reconfigure if already configured)
• /eforge:workflow:init — always runs the full wizard from scratch
• /eforge:workflow:reconfigure — shows current config summary before the wizard

Four wizard dimensions

The wizard asks four questions in sequence:

1. Development context (solo vs team)

• Solo — you are the only developer merging to trunk
• Team — multiple developers merge PRs; code review gates are active

2. Landing action (merge vs PR)

• Direct merge (merge) — the artifact branch is merged directly into the base branch. Solo only (requires build.allowLocalMergeToTrunk: true).
• Pull request (pr) — a GitHub PR is opened from the artifact branch. Required for team use.

3. Stacked PRs (git-spice or none)

• No stacking — standard single-branch builds
• git-spice stacking — each build PR normally targets the parent artifact branch. During landing, eforge can repair a missing integrated parent by choosing trunk as the effective base for an initially untracked child or by retargeting a child that is already tracked, then runs provider repo sync, branch restack, and a remote-base freshness proof before submitting the PR. Requires git-spice and git-spice repo init.

When stacking is selected, the wizard checks whether git-spice is available. If not found on $PATH, it offers three remediation choices: disable stacking, configure a custom path, or cancel.

4. Automatic stack sync (only when stacking enabled)

• Yes — enables daemon-owned after-build sync (stacking.sync.afterBuild: true). After each build completes, the daemon runs eforge stack sync automatically from the project root. When active builds are running, sync is deferred until those builds complete.
• No — sync the stack manually with /eforge:stack:sync

Five workflow presets

The four dimensions map to one of five presets:

Config keys each preset writes

For stacking presets where the user provides a custom git-spice path, stacking.gitSpice.command is also written.

Related skills