Features Documentation

Home > Features

This section documents amplihack-rs feature implementations.

Power Steering

Intelligent guidance system that prevents common mistakes and ensures work completeness:

• Overview
• Architecture Refactor
• Configuration
• Customization Guide
• Worktree Support
• Troubleshooting

Self-Heal

• Auto-Restage Framework Assets on Version Change — startup-time version-stamp check that re-runs amplihack install automatically when the binary version no longer matches ~/.amplihack/.installed-version.

Update Check

• Post-Update Install — Re-exec New Binary — after amplihack update downloads a new binary, the post-update install step spawns the new binary as a subprocess instead of running the old binary's compiled-in install code (issue #683).
• Install/Update PATH Conflict Handling — detects stale system binaries that shadow ~/.local/bin, prefers safe user-local update targets, and reports manual sudo repair guidance without attempting privileged writes.
• Framework Bundle Compatibility — validates smart-orchestrator source and staged bundles so stale monolithic recipes cannot survive install/update repair (issue #734).
• Startup Self-Update Prompt — Subprocess-Safe Skip — startup self-update prompt skips automatically in CI, delegated agents, non-TTY stdin, with --subprocess-safe, or when AMPLIHACK_NONINTERACTIVE / AMPLIHACK_AGENT_BINARY is set; emits a single skip-line to stderr (issue #625).

Workflow Recovery

• Workflow-Owned PR Recovery Readiness — recover existing pull requests through default-workflow, reuse the PR branch, verify hook and additive-copy readiness, and finalize only through workflow-owned steps.
• Existing Branch Finalization Runbook — inspect, preserve, validate, publish, and merge an already-implemented branch; includes the post-v0.9.77 issue-658 branch as the concrete example.
• Recipe Subprocess and Hook Input Contracts — recipe-runner child environment and hook input compatibility contract; see the recipe environment reference and hook input contract.

GitHub Distribution

• GitHub Distribution — publish agent bundles to GitHub repositories via the gh CLI, with idempotent uploads, visibility control, and tagged releases.

Additional Features

• amplihack-rs Parity Reference - subprocess prompt delivery configuration, binary capability matrix, doctor diagnostics, and Rust API.