Installer Agent¶
The Installer agent guides developers through the interactive setup of an ubFlow agent family inside their repository. It validates prerequisites, detects conflicts, and produces a deterministic, reproducible installation. It also supports upgrading existing installations and rolling back failures. |
Agent Definition
- Installer Flow Stories
- Installer Specifications
- Target Location
- Epic Management
- Determinism and Verification
- Target Folder Layout
- Template and Version Selection
- Partial Agent Selection
- Prerequisite Check and Auto-Install
- Update and Upgrade
- Conflict Detection
- Rollback and Uninstall
- Configuration Persistence
- Post-Install Validation
- ubFlow Agent Stub
- Installer Instructions
- Installer Skills
- Traceability Overview — Installer Agent
ID |
Title |
Type |
|---|---|---|
ubFlow Installer agent |
agent |
|
Always start by loading your instructions from ubCode |
flowinst |
|
Always detect the repository root before asking for a target path |
flowinst |
|
Always verify prerequisites before writing any file |
flowinst |
|
Always detect conflicts before rendering the template |
flowinst |
|
Always resolve the package version from ubflow_package.json, not from git |
flowinst |
|
Always present epic and agent selection before rendering |
flowinst |
|
Always write files atomically and roll back on failure |
flowinst |
|
Always write an installation manifest after a successful installation |
flowinst |
|
Always persist the answers file after a successful installation |
flowinst |
|
Always show a diff and require confirmation before upgrading |
flowinst |
|
Always validate the installed documentation before reporting success |
flowinst |
|
Use the manifest to uninstall — never delete files not listed in it |
flowinst |
|
Always locate the family source by searching repo and extension in order |
flowinst |
|
Always prepare the family source and clean up only what was extracted |
flowinst |
|
Deploy the ubFlow agent stub after every install or upgrade |
flowinst |
|
Deploy companion bootstrap instructions file after every install or upgrade |
flowinst |
|
Detect repository root and validate target path |
flowskill |
|
Resolve SemVer tags from remote template |
flowskill |
|
Invoke Copier in interactive, replay, pretend, and update modes |
flowskill |
|
Write and verify the installation manifest |
flowskill |
|
Check prerequisites and optionally auto-install |
flowskill |
|
Scan for Sphinx-Needs ID and file-path conflicts |
flowskill |
|
Write files atomically via staging and roll back on failure |
flowskill |
|
Scan installed RST for undefined Sphinx-Needs references |
flowskill |
|
Write the ubFlow agent stub file |
flowskill |
|
Write the companion bootstrap instructions file |
flowskill |
|
Repository root detection |
flowspec |
|
Target folder prompt and validation |
flowspec |
|
Epic enumeration from user-story tags |
flowspec |
|
Epic selection prompt |
flowspec |
|
Epic-filtered template rendering |
flowspec |
|
Deterministic Copier invocation from local source |
flowspec |
|
Installation manifest format |
flowspec |
|
Verify command implementation |
flowspec |
|
Output confinement and folder structure |
flowspec |
|
Package version from ubflow_package.json |
flowspec |
|
Per-agent selection prompt in Copier |
flowspec |
|
Pre-installation dependency check script |
flowspec |
|
Auto-install of Python prerequisites via pip |
flowspec |
|
Update invocation from local package source |
flowspec |
|
Pre-upgrade diff summary from local source |
flowspec |
|
Sphinx-Needs ID collision detection |
flowspec |
|
File path collision detection and per-file confirmation |
flowspec |
|
Uninstall command using manifest |
flowspec |
|
Atomic write with auto-rollback on failure |
flowspec |
|
Copier answers file location and schema |
flowspec |
|
Answers file used for prompt pre-population |
flowspec |
|
Undefined Sphinx-Needs reference scan |
flowspec |
|
Sphinx build as final validation gate |
flowspec |
|
ubflow_package.json schema |
flowspec |
|
Family source discovery (directory or zip) |
flowspec |
|
Family source preparation (directory pass-through or zip extraction) |
flowspec |
|
Installer creates the ubFlow agent stub idempotently |
flowspec |
|
Installer creates the companion bootstrap instructions file idempotently |
flowspec |
|
Installer target location |
flowstory |
|
Installer epic approvals |
flowstory |
|
Epics |
flowstory |
|
Deterministic installation |
flowstory |
|
Single target folder |
flowstory |
|
Template and version selection |
flowstory |
|
Partial agent selection |
flowstory |
|
Prerequisite and dependency check |
flowstory |
|
Update and upgrade |
flowstory |
|
Conflict detection |
flowstory |
|
Rollback and uninstall |
flowstory |
|
Installation configuration persistence |
flowstory |
|
Post-install validation |
flowstory |
|
Local family source bundled with ubCode |
flowstory |
|
Package manifest declaration |
flowstory |
|
Merge ubFlow configuration into existing ubproject.toml |
flowstory |
|
Installer deploys the ubFlow agent stub |
flowstory |
|
Installer deploys the companion bootstrap instructions file |
flowstory |