ContextQMD
Back to Ruflo

ruflo-goals

plugins/ruflo-goals/README.md

3.6.304.0 KB
Original Source

ruflo-goals

Long-horizon goal planning, deep research orchestration, and adaptive replanning.

Install

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-goals@ruflo

Features

  • Goal planning: GOAP-based action planning with precondition analysis and cost optimization
  • Deep research: Multi-source research orchestration (web, memory, codebase, patterns)
  • Horizon tracking: Persistent objectives across sessions with milestone checkpoints
  • Research synthesis: Evidence-graded reports with contradiction resolution
  • Dossier investigation: Recursive parallel fan-out across all ruflo sources for seed-driven investigation (ADR-099)

Commands

  • /goals -- List active horizons, check progress, view research

Skills

  • deep-research -- Orchestrate multi-phase research campaigns
  • goal-plan -- Create and execute GOAP action plans
  • horizon-track -- Track objectives across sessions with drift detection
  • research-synthesize -- Synthesize findings into structured reports
  • dossier-collect -- Recursive parallel investigation building a graph-structured dossier on a seed entity

Agents

  • goal-planner -- GOAP specialist with A* planning and trajectory learning
  • deep-researcher -- Multi-source research with evidence grading (linear, question-driven)
  • horizon-tracker -- Cross-session objective tracking with drift detection
  • dossier-investigator -- Recursive parallel multi-source investigator (seed-driven, graph output)

Selection guide

You haveUse
A questiondeep-researcher / deep-research
A seed entity to expand outwarddossier-investigator / dossier-collect
A multi-step objectivegoal-planner / goal-plan
A long-running objectivehorizon-tracker / horizon-track

Compatibility

  • CLI: pinned to @claude-flow/cli v3.6 major+minor.
  • Verification: bash plugins/ruflo-goals/scripts/smoke.sh is the contract.

Namespace coordination

This plugin uses six AgentDB namespaces. They predate the namespace convention from ruflo-agentdb ADR-0001. ADR-0001 documents the legacy-vs-canonical mapping and the forward path:

Legacy (current)Canonical (forward)Status
adradr-patterns (owned by ruflo-adr)Defer to canonical owner — don't write here from this plugin
dossierdossierDocumented base-name exception (cf. federation)
researchgoals-researchLegacy reads + new writes pending data-portability ADR
research-sourcesgoals-research-sourcesLegacy reads + new writes pending
horizonsgoals-horizonsLegacy reads + new writes pending
horizon-sessionsgoals-horizon-sessionsLegacy reads + new writes pending

New writes from this plugin SHOULD use the canonical kebab-case form. Reads check both. A future ADR will propose the rename + migration once existing-data-portability is designed.

Reserved namespaces (pattern, claude-memories, default) MUST NOT be shadowed.

Dossier-investigator (ADR-099)

The dossier-investigator agent + dossier-collect skill implement ADR-099 — recursive parallel multi-source investigation that fans out across web, memory, knowledge-graph, codebase, and ADR index, building a graph-structured dossier with budget caps, de-duplication, and provenance per claim.

Key invariants per ADR-099:

  • Seed-driven (entity, not question)
  • Graph output (not linear report)
  • Budget caps (hop-count, token, time)
  • Provenance per claim (every fact carries source attribution)

Verification

bash
bash plugins/ruflo-goals/scripts/smoke.sh
# Expected: "10 passed, 0 failed"

Architecture Decisions