ruvnet--ruflo/plugins/ruflo-goals/README.md

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

• ADR-0001 — ruflo-goals plugin contract (legacy-vs-canonical namespaces, GOAP/dossier workflow contract)