Skip to content

README.md

Latest commit

 

History

History
89 lines (62 loc) · 4 KB

README.md

File metadata and controls

89 lines (62 loc) · 4 KB
Raw

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 have Use
A question deep-researcher / deep-research
A seed entity to expand outward dossier-investigator / dossier-collect
A multi-step objective goal-planner / goal-plan
A long-running objective horizon-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
adr adr-patterns (owned by ruflo-adr) Defer to canonical owner — don't write here from this plugin
dossier dossier Documented base-name exception (cf. federation)
research goals-research Legacy reads + new writes pending data-portability ADR
research-sources goals-research-sources Legacy reads + new writes pending
horizons goals-horizons Legacy reads + new writes pending
horizon-sessions goals-horizon-sessions Legacy 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 plugins/ruflo-goals/scripts/smoke.sh
# Expected: "10 passed, 0 failed"

Architecture Decisions