fusion

<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:** <!-- BEGIN: tool-categories (auto-generated by scripts/sync-fusion-skill-tools.mjs — do not edit by hand) --> - **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` <!-- END: tool-categories --> - **Dashboard** — Use `/fn` command to start/stop the dashboard </essential_principles> <routing> 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. </routing> <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>