Traceability Overview — Installer Agent¶
Full traceability chain: Flow Story → Specification → Instruction / Skill.
Flow Stories¶
ID |
Title |
Status |
Satisfied By |
|---|---|---|---|
Installer target location |
approved |
||
Installer epic approvals |
approved |
||
Epics |
approved |
||
Deterministic installation |
approved |
FLSP_UBFLOW_INST_006; FLSP_UBFLOW_INST_007; FLSP_UBFLOW_INST_008 |
|
Single target folder |
approved |
||
Template and version selection |
draft |
||
Partial agent selection |
draft |
||
Prerequisite and dependency check |
draft |
||
Update and upgrade |
draft |
||
Conflict detection |
draft |
||
Rollback and uninstall |
draft |
||
Installation configuration persistence |
draft |
||
Post-install validation |
draft |
||
Local family source bundled with ubCode |
approved |
FLSP_UBFLOW_INST_006; FLSP_UBFLOW_INST_010; FLSP_UBFLOW_INST_014; FLSP_UBFLOW_INST_015; FLSP_UBFLOW_INST_025; FLSP_UBFLOW_INST_026 |
|
Package manifest declaration |
approved |
||
Merge ubFlow configuration into existing ubproject.toml |
draft |
||
Installer deploys the ubFlow agent stub |
draft |
||
Installer deploys the companion bootstrap instructions file |
draft |
Specifications¶
ID |
Title |
Status |
Satisfies |
Implemented By |
Supported By |
|---|---|---|---|---|---|
Repository root detection |
draft |
||||
Target folder prompt and validation |
draft |
||||
Epic enumeration from user-story tags |
draft |
||||
Epic selection prompt |
draft |
||||
Epic-filtered template rendering |
draft |
||||
Deterministic Copier invocation from local source |
draft |
||||
Installation manifest format |
draft |
||||
Verify command implementation |
draft |
||||
Output confinement and folder structure |
draft |
||||
Package version from ubflow_package.json |
draft |
FLST_UBFLOW_INST_06; FLST_UBFLOW_INST_14; FLST_UBFLOW_INST_15 |
|||
Per-agent selection prompt in Copier |
draft |
||||
Pre-installation dependency check script |
draft |
||||
Auto-install of Python prerequisites via pip |
draft |
||||
Update invocation from local package source |
draft |
||||
Pre-upgrade diff summary from local source |
draft |
||||
Sphinx-Needs ID collision detection |
draft |
||||
File path collision detection and per-file confirmation |
draft |
||||
Uninstall command using manifest |
draft |
||||
Atomic write with auto-rollback on failure |
draft |
||||
Copier answers file location and schema |
draft |
||||
Answers file used for prompt pre-population |
draft |
||||
Undefined Sphinx-Needs reference scan |
draft |
||||
Sphinx build as final validation gate |
draft |
||||
ubflow_package.json schema |
draft |
||||
Family source discovery (directory or zip) |
draft |
||||
Family source preparation (directory pass-through or zip extraction) |
draft |
||||
Installer creates the ubFlow agent stub idempotently |
draft |
||||
Installer creates the companion bootstrap instructions file idempotently |
draft |
Instructions¶
ID |
Title |
Status |
Implements |
|---|---|---|---|
Always start by loading your instructions from ubCode |
draft |
||
Always detect the repository root before asking for a target path |
draft |
||
Always verify prerequisites before writing any file |
draft |
||
Always detect conflicts before rendering the template |
draft |
||
Always resolve the package version from ubflow_package.json, not from git |
draft |
FLSP_UBFLOW_INST_009; FLSP_UBFLOW_INST_010; FLSP_UBFLOW_INST_025; FLSP_UBFLOW_INST_026 |
|
Always present epic and agent selection before rendering |
draft |
FLSP_UBFLOW_INST_003; FLSP_UBFLOW_INST_004; FLSP_UBFLOW_INST_005 |
|
Always write files atomically and roll back on failure |
draft |
||
Always write an installation manifest after a successful installation |
draft |
||
Always persist the answers file after a successful installation |
draft |
||
Always show a diff and require confirmation before upgrading |
draft |
||
Always validate the installed documentation before reporting success |
draft |
||
Use the manifest to uninstall — never delete files not listed in it |
draft |
||
Always locate the family source by searching repo and extension in order |
draft |
||
Always prepare the family source and clean up only what was extracted |
draft |
||
Deploy the ubFlow agent stub after every install or upgrade |
draft |
||
Deploy companion bootstrap instructions file after every install or upgrade |
draft |
Skills¶
ID |
Title |
Status |
Supports |
|---|---|---|---|
Detect repository root and validate target path |
draft |
||
Resolve SemVer tags from remote template |
draft |
||
Invoke Copier in interactive, replay, pretend, and update modes |
draft |
||
Write and verify the installation manifest |
draft |
||
Check prerequisites and optionally auto-install |
draft |
||
Scan for Sphinx-Needs ID and file-path conflicts |
draft |
||
Write files atomically via staging and roll back on failure |
draft |
||
Scan installed RST for undefined Sphinx-Needs references |
draft |
||
Write the ubFlow agent stub file |
draft |
||
Write the companion bootstrap instructions file |
draft |