mirror of https://github.com/ruvnet/ruflo.git synced 2026-09-14 14:01:28 +08:00

Files

T

Reuven 714cd534c0 feat(ruflo-goals): adopt plugin contract — legacy-vs-canonical namespace mapping + ADR-099 anchor (ADR-0001)

Plugin already at v0.2.0 with 4 agents + 5 skills + 1 command. The
contract pieces were missing, plus a real namespace audit finding:
six namespaces predate ruflo-agentdb ADR-0001's <plugin-stem>-<intent>
convention and are not compliant. Renaming risks breaking existing
stored data.

ADR-0001 documents the legacy-vs-canonical mapping:
- adr → defer to canonical adr-patterns (owned by ruflo-adr)
- dossier → documented base-name exception (cf. federation)
- research → goals-research (legacy reads + new writes pending data
  portability ADR)
- research-sources → goals-research-sources (same)
- horizons → goals-horizons (same)
- horizon-sessions → goals-horizon-sessions (same)

New writes from this plugin SHOULD use the canonical kebab-case form;
reads check both for backward compatibility. A future ADR will propose
the rename + migration once the data-portability path is designed.

- ADR-0001 (Proposed) at docs/adrs/0001-goals-contract.md
- README adds Compatibility (pin v3.6), Namespace coordination with the
  legacy-vs-canonical mapping table, ADR-099 dossier-investigator block
  (seed-driven, graph output, budget caps, provenance per claim),
  Verification + Architecture Decisions sections
- plugin.json keywords add mcp, evidence-grading, legacy-namespaces
- scripts/smoke.sh — 10 structural checks: version + keywords, all 5
  skills + 4 agents + command present, 4 task patterns in selection
  guide, ADR-099 cross-link, v3.6 pin, namespace coordination, legacy
  mapping entries, ADR Proposed, ADR-099 invariants documented,
  no wildcard tools

Verification: bash plugins/ruflo-goals/scripts/smoke.sh → 10/10

Co-Authored-By: RuFlo <ruv@ruv.net>

2026-05-04 20:06:53 -04:00

4.0 KiB

Raw Permalink Blame History

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)

4.0 KiB Raw Permalink Blame History