fusion

name	fusion
description	AI-orchestrated task board (Fusion) interface. Use when working with the Fusion task management system, creating or managing tasks, understanding task workflows, organizing work into missions, or interfacing with the Fusion dashboard. Triggers on "create a task", "list tasks", "show board", "plan a mission", "check task status", "import issues", or any Fusion interaction.

<essential_principles>

Fusion is an AI-orchestrated task board. You throw in rough ideas; AI specifies, executes, reviews, and delivers them.

Task lifecycle: Triage → Todo → In Progress → In Review → Done → Archived

• Triage — AI auto-generates a full specification (PROMPT.md) with steps, file scope, and acceptance criteria
• Todo — Scheduler resolves dependencies and queues for execution
• In Progress — Executor agent works in a git worktree: plan → review → execute → review per step
• In Review — Completed work ready for merge (auto-merge or PR-based)
• Done — Merged to main branch
• Archived — Removed from active board view

Missions provide hierarchical planning above tasks: Mission → Milestone → Slice → Feature → Task

Available tools: Fusion registers tools (prefixed fn_*). No CLI commands or Bash needed — use the registered tools directly.

Naming boundary: The published skill surface uses fn_* tool names (for example fn_task_create, fn_mission_create). Engine runtime sessions also inject additional fn_* tools (for example fn_review_spec, fn_spawn_agent) that are not part of the published skill surface.

Engine runtime tools: Triage/executor/merger/heartbeat sessions include auto-injected engine tools that are not part of the published skill surface. See references/engine-tools.md for the canonical runtime-only catalog and usage boundaries.

Tool categories:

• Task tools — fn_task_create, fn_task_update, fn_task_list, fn_task_show, fn_task_logs_read, fn_task_attach, fn_task_pause, fn_task_unpause, fn_task_retry, fn_task_bypass_review, fn_task_duplicate, fn_task_refine, fn_task_delete, fn_task_browse_gitlab_project_issues, fn_task_import_gitlab_project_issues, fn_task_browse_gitlab_group_issues, fn_task_import_gitlab_group_issues, fn_task_browse_gitlab_merge_requests, fn_task_import_gitlab_merge_requests, fn_task_plan
• Workflow tools — fn_workflow_list, fn_workflow_get, fn_workflow_validate, fn_workflow_create, fn_workflow_update, fn_workflow_delete, fn_workflow_settings, fn_trait_list, fn_workflow_select, fn_workflow_step_resume
• GitHub tools — fn_task_import_github, fn_task_import_github_issue, fn_task_browse_github_issues
• Mission tools — fn_mission_create, fn_mission_list, fn_mission_show, fn_mission_list_goals, fn_mission_link_goal, fn_mission_unlink_goal, fn_mission_backfill_assertions, fn_mission_delete, fn_mission_set_status, fn_mission_clear_blocked, fn_mission_update, fn_milestone_add, fn_slice_add, fn_feature_add, fn_feature_delete, fn_slice_delete, fn_milestone_delete, fn_slice_activate, fn_feature_link_task, fn_feature_repoint_task, fn_feature_unlink_task, fn_feature_set_status, fn_mission_reconcile, fn_feature_repair_validation, fn_feature_update, fn_milestone_update
• Goal tools — fn_goal_list, fn_goal_create, fn_goal_archive, fn_goal_show
• Agent tools — fn_agent_stop, fn_agent_start, fn_agent_create, fn_agent_update, fn_agent_set_instructions, fn_agent_read_evaluations, fn_agent_evaluation_followup, fn_agent_delete, fn_list_agents, fn_delegate_task, fn_agent_show, fn_agent_org_chart
• Skills tools — fn_skills_search, fn_skills_install
• Insight tools — fn_insight_list, fn_insight_show, fn_insight_run_list, fn_insight_run_show
• Other tools — fn_web_fetch, fn_secret_get, fn_experiment_finalize

• Dashboard — Use /fn command to start/stop the dashboard

</essential_principles>

Based on the user's request, route to the appropriate workflow:

Task operations:

• Create, list, show, manage tasks → workflows/task-management.md
• Understand task columns, lifecycle, statuses → workflows/task-lifecycle.md

Planning and specifications:

• Plan complex work, break down ideas → workflows/specifications.md
• Organize into missions, milestones, slices → workflows/specifications.md

Dashboard and CLI:

• Start dashboard, use CLI commands, settings → workflows/dashboard-cli.md

If the intent is simple and clear (e.g., "create a task to fix the login bug"), execute directly using the appropriate fn_* tool without loading a workflow file. Only load workflows for guidance on complex operations or when the user needs help understanding Fusion concepts.

<quick_reference>

Create a task: Use fn_task_create with a descriptive message. Include the problem AND desired outcome, and set priority (low/normal/high/urgent) when urgency matters.

List tasks: Use fn_task_list to see all tasks grouped by column. Use column param to filter.

Show task details: Use fn_task_show with the task ID (e.g., FN-001) to see steps, progress, and log.

Planner oversight eye badge: On dashboard task cards, an eye icon means plannerOverseerState is non-idle — not that a human viewed the task. States: watching = passive monitoring; steering/recovering = active overseer guidance or repair; awaiting-confirmation = human decision required. For human operators, the dashboard task detail Activity → Interventions view provides overseer state/intervention context. CLI/pi agents should not assume fn_task_show exposes that transient dashboard-only state; if the dashboard path is unavailable, avoid claiming it was inspected and escalate or leave a handoff note instead of racing Fusion's recovery loop.

Plan complex work: Use fn_task_plan for AI-guided planning that interviews you before creating the task.

Import GitHub issues: Use fn_task_browse_github_issues to preview, then fn_task_import_github_issue for specific issues.

Start dashboard: Use /fn command. /fn stop to stop. /fn status to check.

Mission planning: Use fn_mission_create for high-level objectives, then add milestones, slices, and features.

</quick_reference>

<known_limitations>

These operations are not available via extension tools and require the dashboard or CLI:

• Moving tasks between columns — No tool for column moves (handled by the AI engine)
• Workflow steps — Creating/managing workflow step definitions requires the dashboard
• Settings — Changing settings requires the dashboard or fn settings set CLI command
• Task comments — Adding comments or steering guidance requires CLI (fn task comment, fn task steer) or the dashboard comments tab
• Merge operations — Merging completed tasks requires CLI (fn task merge) or auto-merge

For these operations, guide the user to the dashboard (/fn) or CLI commands documented in workflows/dashboard-cli.md.

</known_limitations>

<reference_index>

Reference	When to Use
references/cli-commands.md	Full CLI command reference
references/task-structure.md	Task file structure and storage
references/extension-tools.md	All extension tools with parameters
references/best-practices.md	Tips for effective Fusion usage
references/fusion-capabilities.md	Complete feature catalog
references/engine-tools.md	Engine session-scoped runtime tools (not extension-invokable)
references/skill-patterns.md	Patterns used in this skill's design

</reference_index>