mcpField
H
horizon-track

horizon-track

github.com/ruvnetAgent workflows80.0k746 installsUpdated today
Repository

About horizon-track

horizon-track is a skill for managing objectives that span multiple sessions, days, or weeks. It organizes work into milestones, preserves progress in memory, and flags schedule or scope drift.

Key features

  1. 01Define objectives and milestones
  2. 02Persist horizon state in memory
  3. 03Review progress at session start
  4. 04Record session work and blockers
  5. 05Detect schedule and scope drift
  6. 06Store milestone learnings

Use cases

  1. 01Track a multi-week feature
  2. 02Manage a research program across sessions
  3. 03Monitor a migration against milestones

MCP support

Uses MCP memory storage and retrieval for horizon state and session records, and an intelligence pattern-store hook for completed milestones.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ruvnet/ruflo --skill horizon-track

After installing, type/horizon-trackin Claude Code to confirm it loaded.

Details

From the project README

Horizon Track

Track long-running objectives that span multiple sessions, days, or weeks.

When to use

When an objective is too large for a single session — multi-week features, research programs, migration projects, or any work that requires persistent progress tracking across conversations.

Steps

  1. Initialize horizon — define the objective, target date, and 3-7 milestones
  2. Store horizon — call mcp__plugin_ruflo-core_ruflo__memory_store with namespace horizons and key horizon-[name]:
    {
      "objective": "...",
      "created": "2026-04-28",
      "targetDate": "2026-05-15",
      "milestones": [
        {"id": "m1", "name": "...", "criteria": "...", "status": "pending"},
        {"id": "m2", "name": "...", "criteria": "...", "status": "pending"}
      ],
      "currentMilestone": "m1",
      "sessions": []
    }
    
  3. Session check-in — at the start of each session:
    • Recall horizon: mcp__plugin_ruflo-core_ruflo__memory_retrieve key horizon-[name] namespace horizons
    • Review milestone status
    • Assess drift (are we still on track?)
    • Plan this session's contribution
  4. Work and record — as work progresses:
    • Update milestone status
    • Record session summary
    • Store intermediate findings
  5. Session check-out — at the end of each session:
    • Update horizon state in memory
    • Record what was accomplished
    • Note blockers or scope changes
    • Estimate remaining effort
  6. Milestone completion — when a milestone is done:
    • Verify completion criteria met
    • Store learned patterns via mcp__plugin_ruflo-core_ruflo__hooks_intelligence_pattern-store
    • Advance to next milestone
  7. Drift detection — flag when:
    • Progress rate suggests target date will be missed
    • Scope has grown beyond original definition
    • Dependencies have changed
    • Approach needs fundamental rethinking

Memory namespaces

  • horizons — active horizon definitions and state
  • horizon-sessions — per-session summaries keyed by [horizon]-[date]
  • horizon-learnings — patterns and insights discovered during the horizon

Comments

Markdown supported