Traceability¶
This page shows the full traceability chain across all agents: FlowStory → FlowSpec → FlowInst / FlowSkill.
User Stories¶
User Story without specs 17 / 60
ID |
Title |
Type |
Status |
Section Name |
|---|---|---|---|---|
Resolve Target Documentation Project |
flowstory |
draft |
Shared Behavior |
|
Validate Documentation Project Scope |
flowstory |
draft |
Shared Behavior |
|
Use ubCode MCP to Access Sphinx-Needs Objects |
flowstory |
draft |
Shared Behavior |
|
Auto-Install ubCode MCP on Demand |
flowstory |
draft |
Shared Behavior |
|
Fixed Execution Workflow for All Agents |
flowstory |
draft |
Shared Behavior |
|
Orchestrator Agent per Agent Family |
flowstory |
draft |
Agent Families & Orchestration |
|
Predefined Workflow Types |
flowstory |
draft |
Agent Families & Orchestration |
|
Agent Family Management |
flowstory |
draft |
Agent Families & Orchestration |
|
Define Agent Family as Sphinx-Needs Object |
flowstory |
draft |
Agent Families & Orchestration |
|
Agent Family Links to Its Member Agents |
flowstory |
draft |
Agent Families & Orchestration |
|
Orchestrator Is the Family Entry Point |
flowstory |
draft |
Single Entry Point |
|
Orchestrator Carries the Family Name |
flowstory |
draft |
Single Entry Point |
|
Orchestrator Identifies and Routes Workflow |
flowstory |
draft |
Workflow Routing |
|
Orchestrator Enforces the Five-Phase Workflow |
flowstory |
draft |
Workflow Routing |
|
Orchestrator Uses ubCode MCP for All Needs Access |
flowstory |
draft |
ubCode MCP Integration |
|
Orchestrator Ensures ubCode MCP Is Available |
flowstory |
draft |
ubCode MCP Integration |
|
Merge ubFlow configuration into existing ubproject.toml |
flowstory |
draft |
Installer Flow Stories |
Specifications¶
Specs without User story link 0 / 57
No needs passed the filters
Specs without implementations 4 / 57
ID |
Title |
Type |
Status |
|---|---|---|---|
ubFlow delivered as ubCode chat participant |
flowspec |
draft |
|
ubFlow is non-editable after delivery |
flowspec |
draft |
|
Sphinx build as final validation gate |
flowspec |
draft |
|
ubflow_package.json schema |
flowspec |
draft |
Instructions¶
Instructions without Specification link 0 / 35
No needs passed the filters
Skills¶
Skills without Specification link 0 / 18
No needs passed the filters
Skills without Tool link 7 / 18
ID |
Title |
Type |
Status |
|---|---|---|---|
Decide whether content belongs in flowinst or flowskill |
flowskill |
draft |
|
RST and Sphinx directive syntax for common authoring patterns |
flowskill |
draft |
|
Author the companion bootstrap instructions file for a ubFlow agent family |
flowskill |
draft |
|
Write and verify the installation manifest |
flowskill |
draft |
|
Check prerequisites and optionally auto-install |
flowskill |
draft |
|
Write files atomically via staging and roll back on failure |
flowskill |
draft |
|
Write the companion bootstrap instructions file |
flowskill |
draft |
Tools¶
Tools without Specification link 4 / 4
ID |
Title |
Type |
Status |
|---|---|---|---|
Copier CLI |
flowtool |
approved |
|
Git CLI |
flowtool |
approved |
|
Sphinx Build |
flowtool |
approved |
|
ubCode MCP Server |
flowtool |
approved |
Tools without Skill link 0 / 4
No needs passed the filters
ubFlow Agent¶
ID |
Title |
Type |
Status |
|---|---|---|---|
ubFlow Installer agent |
agent |
draft |
|
ubFlow |
agent |
draft |
|
Always start by loading your instructions from ubCode |
flowinst |
draft |
|
Always detect the repository root before asking for a target path |
flowinst |
draft |
|
Always verify prerequisites before writing any file |
flowinst |
draft |
|
Always detect conflicts before rendering the template |
flowinst |
draft |
|
Always resolve the package version from ubflow_package.json, not from git |
flowinst |
draft |
|
Always present epic and agent selection before rendering |
flowinst |
draft |
|
Always write files atomically and roll back on failure |
flowinst |
draft |
|
Always write an installation manifest after a successful installation |
flowinst |
draft |
|
Always persist the answers file after a successful installation |
flowinst |
draft |
|
Always show a diff and require confirmation before upgrading |
flowinst |
draft |
|
Always validate the installed documentation before reporting success |
flowinst |
draft |
|
Use the manifest to uninstall — never delete files not listed in it |
flowinst |
draft |
|
Always locate the family source by searching repo and extension in order |
flowinst |
draft |
|
Always prepare the family source and clean up only what was extracted |
flowinst |
draft |
|
Deploy the ubFlow agent stub after every install or upgrade |
flowinst |
draft |
|
Deploy companion bootstrap instructions file after every install or upgrade |
flowinst |
draft |
|
Describe every agent rule as a flowinst or flowskill RST directive |
flowinst |
draft |
|
Keep flowinst and flowskill strictly separated by what vs. how |
flowinst |
draft |
|
Always set :implements: or :supports: link on instructions and skills |
flowinst |
draft |
|
Define an agent via a single .. agent:: directive with all required fields |
flowinst |
draft |
|
Verify the agent need aggregates all its instructions and skills |
flowinst |
draft |
|
Guide the user through agent creation in five confirmed steps |
flowinst |
draft |
|
Run only the user-selected review modes when checking an agent |
flowinst |
draft |
|
Generate .agent.md as a minimal bootstrap block only |
flowinst |
draft |
|
Validate schema at startup and handle missing types contextually |
flowinst |
draft |
|
Present an installation plan and wait for confirmation before delegating to the Installer |
flowinst |
draft |
|
Never write ubFlow-internal needs into the target project |
flowinst |
draft |
|
Place generated .agent.md in .github/agents/ with correct name frontmatter |
flowinst |
draft |
|
Generate a plain-language agent summary when requested |
flowinst |
draft |
|
Bootstrap full instruction set from ubCode extension on session start |
flowinst |
draft |
|
Deploy companion bootstrap instructions file when generating agent files |
flowinst |
draft |
|
Reference the driving FLIN\_ or FLSK\_ in every decision |
flowinst |
draft |
|
Mark meaningful undocumented decisions with (NO FLOW) |
flowinst |
draft |
|
Keep copilot-instructions.md in sync with always-load needs |
flowinst |
draft |
|
Always print need IDs in full and link to their source |
flowinst |
draft |
|
Detect repository root and validate target path |
flowskill |
draft |
|
Resolve SemVer tags from remote template |
flowskill |
draft |
|
Invoke Copier in interactive, replay, pretend, and update modes |
flowskill |
draft |
|
Write and verify the installation manifest |
flowskill |
draft |
|
Check prerequisites and optionally auto-install |
flowskill |
draft |
|
Scan for Sphinx-Needs ID and file-path conflicts |
flowskill |
draft |
|
Write files atomically via staging and roll back on failure |
flowskill |
draft |
|
Scan installed RST for undefined Sphinx-Needs references |
flowskill |
draft |
|
Write the ubFlow agent stub file |
flowskill |
draft |
|
Write the companion bootstrap instructions file |
flowskill |
draft |
|
Decide whether content belongs in flowinst or flowskill |
flowskill |
draft |
|
Execute the five-step agent creation workflow |
flowskill |
draft |
|
Perform syntactic, semantic, and traceability review checks |
flowskill |
draft |
|
Cite a driving FLIN\_ or FLSK\_ with a source link |
flowskill |
draft |
|
RST and Sphinx directive syntax for common authoring patterns |
flowskill |
draft |
|
Query ubCode MCP schema and handle missing types |
flowskill |
draft |
|
Author the companion bootstrap instructions file for a ubFlow agent family |
flowskill |
draft |
|
Render a need ID as a linked source reference |
flowskill |
draft |
|
Repository root detection |
flowspec |
draft |
|
Target folder prompt and validation |
flowspec |
draft |
|
Epic enumeration from user-story tags |
flowspec |
draft |
|
Epic selection prompt |
flowspec |
draft |
|
Epic-filtered template rendering |
flowspec |
draft |
|
Deterministic Copier invocation from local source |
flowspec |
draft |
|
Installation manifest format |
flowspec |
draft |
|
Verify command implementation |
flowspec |
draft |
|
Output confinement and folder structure |
flowspec |
draft |
|
Package version from ubflow_package.json |
flowspec |
draft |
|
Per-agent selection prompt in Copier |
flowspec |
draft |
|
Pre-installation dependency check script |
flowspec |
draft |
|
Auto-install of Python prerequisites via pip |
flowspec |
draft |
|
Update invocation from local package source |
flowspec |
draft |
|
Pre-upgrade diff summary from local source |
flowspec |
draft |
|
Sphinx-Needs ID collision detection |
flowspec |
draft |
|
File path collision detection and per-file confirmation |
flowspec |
draft |
|
Uninstall command using manifest |
flowspec |
draft |
|
Atomic write with auto-rollback on failure |
flowspec |
draft |
|
Copier answers file location and schema |
flowspec |
draft |
|
Answers file used for prompt pre-population |
flowspec |
draft |
|
ubflow_package.json schema |
flowspec |
draft |
|
Family source discovery (directory or zip) |
flowspec |
draft |
|
Family source preparation (directory pass-through or zip extraction) |
flowspec |
draft |
|
Undefined Sphinx-Needs reference scan |
flowspec |
draft |
|
Sphinx build as final validation gate |
flowspec |
draft |
|
Installer creates the ubFlow agent stub idempotently |
flowspec |
draft |
|
Installer creates the companion bootstrap instructions file idempotently |
flowspec |
draft |
|
flowinst and flowskill described as RST directives |
flowspec |
draft |
|
flowinst separates what from how |
flowspec |
draft |
|
flowinst and flowskill link to a flowspec |
flowspec |
draft |
|
agent need as single identity object |
flowspec |
draft |
|
agent need as complete aggregation point |
flowspec |
draft |
|
Step-by-step agent creation workflow |
flowspec |
draft |
|
Agent creation verifies all linked IDs via MCP before writing |
flowspec |
draft |
|
Agent review supports three selectable check modes |
flowspec |
draft |
|
Traceability review resolves every instruction and skill ID |
flowspec |
draft |
|
Minimal bootstrap-only .agent.md |
flowspec |
draft |
|
Schema validation at startup with installer-aware fallback |
flowspec |
draft |
|
Built-in ubCode MCP knowledge requires no manual setup |
flowspec |
draft |
|
Guided project integration with confirmation gate |
flowspec |
draft |
|
ubFlow internals never written to target project |
flowspec |
draft |
|
ubFlow delivered as ubCode chat participant |
flowspec |
draft |
|
ubFlow is non-editable after delivery |
flowspec |
draft |
|
Generated agent file placed in .github/agents/ with @-invokable name |
flowspec |
draft |
|
Generated agents support delegation from other agents |
flowspec |
draft |
|
Human-readable agent overview on request |
flowspec |
draft |
|
ubFlow stub contains bootstrap call only |
flowspec |
draft |
|
ubFlow fetches its instructions via agent-scoped MCP call |
flowspec |
draft |
|
Installer deploys companion bootstrap instructions file per family |
flowspec |
draft |
|
Full need ID output — no abbreviation |
flowspec |
draft |
|
Need IDs rendered with an inline source link |
flowspec |
draft |
|
Reference driving instruction or skill in every decision output |
flowspec |
draft |
|
Mark meaningful undocumented decisions discretely with NO FLOW |
flowspec |
draft |
|
Sync always-load needs into copilot-instructions.md |
flowspec |
draft |
|
Use correct RST and Sphinx directive syntax for all authored content |
flowspec |
draft |
|
Agent IDs must use a meaningful name segment, never a number |
flowspec |
draft |
|
Installer target location |
flowstory |
approved |
|
Installer epic approvals |
flowstory |
approved |
|
Epics |
flowstory |
approved |
|
Deterministic installation |
flowstory |
approved |
|
Single target folder |
flowstory |
approved |
|
Template and version selection |
flowstory |
draft |
|
Partial agent selection |
flowstory |
draft |
|
Prerequisite and dependency check |
flowstory |
draft |
|
Update and upgrade |
flowstory |
draft |
|
Conflict detection |
flowstory |
draft |
|
Rollback and uninstall |
flowstory |
draft |
|
Installation configuration persistence |
flowstory |
draft |
|
Post-install validation |
flowstory |
draft |
|
Local family source bundled with ubCode |
flowstory |
approved |
|
Package manifest declaration |
flowstory |
approved |
|
Merge ubFlow configuration into existing ubproject.toml |
flowstory |
draft |
|
Installer deploys the ubFlow agent stub |
flowstory |
draft |
|
Installer deploys the companion bootstrap instructions file |
flowstory |
draft |
|
Guide Agent Creation |
flowstory |
draft |
|
Describe Instructions and Skills in Sphinx |
flowstory |
draft |
|
Link Instructions and Skills to Needs |
flowstory |
draft |
|
Define Agent as Sphinx-Needs Object |
flowstory |
draft |
|
Agent Object Aggregates Instructions and Skills |
flowstory |
draft |
|
Review Existing Agent |
flowstory |
draft |
|
Control Review Depth |
flowstory |
draft |
|
Verify Traceability Chain |
flowstory |
draft |
|
Agent Bootstraps Itself via MCP |
flowstory |
draft |
|
Schema Validation via MCP at Startup |
flowstory |
draft |
|
Sphinx Project Integration via Prompt |
flowstory |
draft |
|
No Self-Installation into Target Project |
flowstory |
draft |
|
ubCode Chat Participant |
flowstory |
draft |
|
Read-Only Agent After Delivery |
flowstory |
draft |
|
Built-in ubCode MCP Knowledge |
flowstory |
draft |
|
Human-Readable Agent Documentation |
flowstory |
draft |
|
Agents Callable via Copilot Prompt |
flowstory |
draft |
|
ubCode Can Invoke ubFlow Agents |
flowstory |
draft |
|
Orchestrator Is the Family Entry Point |
flowstory |
draft |
|
Orchestrator Carries the Family Name |
flowstory |
draft |
|
Orchestrator Identifies and Routes Workflow |
flowstory |
draft |
|
Orchestrator Enforces the Five-Phase Workflow |
flowstory |
draft |
|
Orchestrator Uses ubCode MCP for All Needs Access |
flowstory |
draft |
|
Orchestrator Ensures ubCode MCP Is Available |
flowstory |
draft |
|
ubFlow bootstraps its instructions from the ubCode extension |
flowstory |
draft |
|
Deploy companion bootstrap instructions file with every family installation |
flowstory |
draft |
|
Resolve Target Documentation Project |
flowstory |
draft |
|
Validate Documentation Project Scope |
flowstory |
draft |
|
Use ubCode MCP to Access Sphinx-Needs Objects |
flowstory |
draft |
|
Auto-Install ubCode MCP on Demand |
flowstory |
draft |
|
Fixed Execution Workflow for All Agents |
flowstory |
draft |
|
Orchestrator Agent per Agent Family |
flowstory |
draft |
|
Predefined Workflow Types |
flowstory |
draft |
|
Agent Family Management |
flowstory |
draft |
|
Define Agent Family as Sphinx-Needs Object |
flowstory |
draft |
|
Agent Family Links to Its Member Agents |
flowstory |
draft |
|
Full need ID display with source links |
flowstory |
draft |
|
Reference driving instruction or skill in every decision |
flowstory |
draft |
|
Mark undocumented decisions with NO FLOW |
flowstory |
draft |
|
Guarantee critical rules survive MCP bootstrap failure |
flowstory |
draft |
|
Write all agent documentation content in valid RST syntax |
flowstory |
draft |
|
Give every agent a meaningful name instead of a number |
flowstory |
draft |
|
Copier CLI |
flowtool |
approved |
|
Git CLI |
flowtool |
approved |
|
Sphinx Build |
flowtool |
approved |
|
ubCode MCP Server |
flowtool |
approved |
|
ubFlow magic-word support in MCP server |
swspec |
draft |
|
Agent parameter for MCP need-query functions |
swspec |
draft |