Traceability Overview — Orchestrator Agent¶
Full traceability chain: Flow Story → Specification → Instruction / Skill.
Flow Stories¶
ID |
Title |
Status |
Satisfied By |
|---|---|---|---|
Guide Agent Creation |
draft |
||
Review Existing Agent |
draft |
||
Control Review Depth |
draft |
||
Verify Traceability Chain |
draft |
||
Describe Instructions and Skills in Sphinx |
draft |
||
Link Instructions and Skills to Needs |
draft |
||
Define Agent as Sphinx-Needs Object |
draft |
||
Agent Object Aggregates Instructions and Skills |
draft |
||
Agent Bootstraps Itself via MCP |
draft |
||
Schema Validation via MCP at Startup |
draft |
||
Sphinx Project Integration via Prompt |
draft |
||
No Self-Installation into Target Project |
draft |
||
ubCode Chat Participant |
draft |
||
Read-Only Agent After Delivery |
draft |
||
Built-in ubCode MCP Knowledge |
draft |
||
Human-Readable Agent Documentation |
draft |
||
Agents Callable via Copilot Prompt |
draft |
||
ubCode Can Invoke ubFlow Agents |
draft |
||
Resolve Target Documentation Project |
draft |
||
Validate Documentation Project Scope |
draft |
||
Use ubCode MCP to Access Sphinx-Needs Objects |
draft |
||
Auto-Install ubCode MCP on Demand |
draft |
||
Fixed Execution Workflow for All Agents |
draft |
||
Orchestrator Agent per Agent Family |
draft |
||
Predefined Workflow Types |
draft |
||
Agent Family Management |
draft |
||
Define Agent Family as Sphinx-Needs Object |
draft |
||
Agent Family Links to Its Member Agents |
draft |
||
Orchestrator Is the Family Entry Point |
draft |
||
Orchestrator Carries the Family Name |
draft |
||
Orchestrator Identifies and Routes Workflow |
draft |
||
Orchestrator Enforces the Five-Phase Workflow |
draft |
||
Orchestrator Uses ubCode MCP for All Needs Access |
draft |
||
Orchestrator Ensures ubCode MCP Is Available |
draft |
||
Full need ID display with source links |
draft |
||
ubFlow bootstraps its instructions from the ubCode extension |
draft |
||
Reference driving instruction or skill in every decision |
draft |
||
Mark undocumented decisions with NO FLOW |
draft |
||
Guarantee critical rules survive MCP bootstrap failure |
draft |
||
Write all agent documentation content in valid RST syntax |
draft |
||
Give every agent a meaningful name instead of a number |
draft |
||
Deploy companion bootstrap instructions file with every family installation |
draft |
Specifications¶
ID |
Title |
Status |
Satisfies |
Implemented By |
Supported By |
|---|---|---|---|---|---|
Full need ID output — no abbreviation |
draft |
||||
Need IDs rendered with an inline source link |
draft |
||||
flowinst and flowskill described as RST directives |
draft |
||||
flowinst separates what from how |
draft |
||||
flowinst and flowskill link to a flowspec |
draft |
||||
agent need as single identity object |
draft |
||||
agent need as complete aggregation point |
draft |
||||
Step-by-step agent creation workflow |
draft |
||||
Agent creation verifies all linked IDs via MCP before writing |
draft |
||||
Agent review supports three selectable check modes |
draft |
||||
Traceability review resolves every instruction and skill ID |
draft |
||||
Minimal bootstrap-only .agent.md |
draft |
||||
Schema validation at startup with installer-aware fallback |
draft |
||||
Built-in ubCode MCP knowledge requires no manual setup |
draft |
||||
Guided project integration with confirmation gate |
draft |
||||
ubFlow internals never written to target project |
draft |
||||
ubFlow delivered as ubCode chat participant |
draft |
||||
ubFlow is non-editable after delivery |
draft |
||||
Generated agent file placed in .github/agents/ with @-invokable name |
draft |
||||
Generated agents support delegation from other agents |
draft |
||||
Human-readable agent overview on request |
draft |
||||
ubFlow stub contains bootstrap call only |
draft |
||||
ubFlow fetches its instructions via agent-scoped MCP call |
draft |
||||
Reference driving instruction or skill in every decision output |
draft |
||||
Mark meaningful undocumented decisions discretely with NO FLOW |
draft |
||||
Sync always-load needs into copilot-instructions.md |
draft |
||||
Use correct RST and Sphinx directive syntax for all authored content |
draft |
||||
Agent IDs must use a meaningful name segment, never a number |
draft |
||||
Installer deploys companion bootstrap instructions file per family |
draft |
Instructions¶
ID |
Title |
Status |
Implements |
|---|---|---|---|
Always print need IDs in full and link to their source |
draft |
||
Describe every agent rule as a flowinst or flowskill RST directive |
draft |
||
Keep flowinst and flowskill strictly separated by what vs. how |
draft |
||
Always set :implements: or :supports: link on instructions and skills |
draft |
||
Define an agent via a single .. agent:: directive with all required fields |
draft |
||
Verify the agent need aggregates all its instructions and skills |
draft |
||
Guide the user through agent creation in five confirmed steps |
draft |
||
Run only the user-selected review modes when checking an agent |
draft |
||
Generate .agent.md as a minimal bootstrap block only |
draft |
||
Validate schema at startup and handle missing types contextually |
draft |
||
Present an installation plan and wait for confirmation before delegating to the Installer |
draft |
||
Never write ubFlow-internal needs into the target project |
draft |
||
Place generated .agent.md in .github/agents/ with correct name frontmatter |
draft |
||
Generate a plain-language agent summary when requested |
draft |
||
Bootstrap full instruction set from ubCode extension on session start |
draft |
||
Reference the driving FLIN\_ or FLSK\_ in every decision |
draft |
||
Mark meaningful undocumented decisions with (NO FLOW) |
draft |
||
Keep copilot-instructions.md in sync with always-load needs |
draft |
||
Deploy companion bootstrap instructions file when generating agent files |
draft |
Skills¶
ID |
Title |
Status |
Supports |
|---|---|---|---|
Render a need ID as a linked source reference |
draft |
||
Decide whether content belongs in flowinst or flowskill |
draft |
||
Execute the five-step agent creation workflow |
draft |
||
Perform syntactic, semantic, and traceability review checks |
draft |
||
Query ubCode MCP schema and handle missing types |
draft |
||
Cite a driving FLIN\_ or FLSK\_ with a source link |
draft |
||
RST and Sphinx directive syntax for common authoring patterns |
draft |
||
Author the companion bootstrap instructions file for a ubFlow agent family |
draft |