skills/ruvnet__ruflo
1
0
Fork 0
mirror of https://github.com/ruvnet/ruflo.git synced 2026-09-14 14:01:28 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
ruvnet__ruflo/plugins/ruflo-goals/README.md
T

90 lines
4.0 KiB
Markdown
Raw Permalink Normal View History

feat: add ruflo-goals plugin — GOAP planning, deep research, horizon tracking 4 skills: deep-research, goal-plan, horizon-track, research-synthesize 3 agents: goal-planner, deep-researcher, horizon-tracker 1 command: /goals Wires memory, task, workflow, neural, agentdb, and intelligence MCP tools for long-horizon research and adaptive replanning. Co-Authored-By: claude-flow <ruv@ruv.net>
2026-04-27 23:52:25 -04:00
# 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
feat(ruflo-goals): dossier-investigator agent + dossier-collect skill (ADR-099) (#1726) * feat(plugins): ruflo-goals/dossier-investigator agent + dossier-collect skill New entry-point added during the autonomous loop session — dossier investigator agent and supporting skill that traverses RuVector memory for recursive parallel research. plugins/ruflo-goals/agents/dossier-investigator.md (new) plugins/ruflo-goals/skills/dossier-collect/ (new) plugins/ruflo-goals/README.md (registry update) plugins/ruflo-goals/.claude-plugin/plugin.json (version bump) Excluded per CLAUDE.md rules: - v3/goal_ui/.env.production (NEVER commit .env) - .claude/scheduled_tasks.lock (runtime artifact) * docs: include v3/docs/examples/ on dossier branch (carried from fix/issues-may-1-3) * docs(examples): add 3 dossier examples (ruvnet, ADR-088, ruflo-goals) Real outputs from running dossier-collect skill against three seed types: - ruvnet/: username seed, GitHub gh-api fan-out + WebSearch - adr-088/: adr-id seed, Read + Glob + Grep + git-log fan-out - ruflo-goals/: concept seed, plugin tree introspection Each example ships markdown + JSON. Validates ADR-099 end-to-end. Co-Authored-By: RuFlo <ruv@ruv.net> --------- Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
2026-05-03 23:15:22 -04:00
- **Dossier investigation**: Recursive parallel fan-out across all ruflo sources for seed-driven investigation (ADR-099)
feat: add ruflo-goals plugin — GOAP planning, deep research, horizon tracking 4 skills: deep-research, goal-plan, horizon-track, research-synthesize 3 agents: goal-planner, deep-researcher, horizon-tracker 1 command: /goals Wires memory, task, workflow, neural, agentdb, and intelligence MCP tools for long-horizon research and adaptive replanning. Co-Authored-By: claude-flow <ruv@ruv.net>
2026-04-27 23:52:25 -04:00
## 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
feat(ruflo-goals): dossier-investigator agent + dossier-collect skill (ADR-099) (#1726) * feat(plugins): ruflo-goals/dossier-investigator agent + dossier-collect skill New entry-point added during the autonomous loop session — dossier investigator agent and supporting skill that traverses RuVector memory for recursive parallel research. plugins/ruflo-goals/agents/dossier-investigator.md (new) plugins/ruflo-goals/skills/dossier-collect/ (new) plugins/ruflo-goals/README.md (registry update) plugins/ruflo-goals/.claude-plugin/plugin.json (version bump) Excluded per CLAUDE.md rules: - v3/goal_ui/.env.production (NEVER commit .env) - .claude/scheduled_tasks.lock (runtime artifact) * docs: include v3/docs/examples/ on dossier branch (carried from fix/issues-may-1-3) * docs(examples): add 3 dossier examples (ruvnet, ADR-088, ruflo-goals) Real outputs from running dossier-collect skill against three seed types: - ruvnet/: username seed, GitHub gh-api fan-out + WebSearch - adr-088/: adr-id seed, Read + Glob + Grep + git-log fan-out - ruflo-goals/: concept seed, plugin tree introspection Each example ships markdown + JSON. Validates ADR-099 end-to-end. Co-Authored-By: RuFlo <ruv@ruv.net> --------- Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
2026-05-03 23:15:22 -04:00
- `dossier-collect` -- Recursive parallel investigation building a graph-structured dossier on a seed entity
feat: add ruflo-goals plugin — GOAP planning, deep research, horizon tracking 4 skills: deep-research, goal-plan, horizon-track, research-synthesize 3 agents: goal-planner, deep-researcher, horizon-tracker 1 command: /goals Wires memory, task, workflow, neural, agentdb, and intelligence MCP tools for long-horizon research and adaptive replanning. Co-Authored-By: claude-flow <ruv@ruv.net>
2026-04-27 23:52:25 -04:00
## Agents
- `goal-planner` -- GOAP specialist with A* planning and trajectory learning
feat(ruflo-goals): dossier-investigator agent + dossier-collect skill (ADR-099) (#1726) * feat(plugins): ruflo-goals/dossier-investigator agent + dossier-collect skill New entry-point added during the autonomous loop session — dossier investigator agent and supporting skill that traverses RuVector memory for recursive parallel research. plugins/ruflo-goals/agents/dossier-investigator.md (new) plugins/ruflo-goals/skills/dossier-collect/ (new) plugins/ruflo-goals/README.md (registry update) plugins/ruflo-goals/.claude-plugin/plugin.json (version bump) Excluded per CLAUDE.md rules: - v3/goal_ui/.env.production (NEVER commit .env) - .claude/scheduled_tasks.lock (runtime artifact) * docs: include v3/docs/examples/ on dossier branch (carried from fix/issues-may-1-3) * docs(examples): add 3 dossier examples (ruvnet, ADR-088, ruflo-goals) Real outputs from running dossier-collect skill against three seed types: - ruvnet/: username seed, GitHub gh-api fan-out + WebSearch - adr-088/: adr-id seed, Read + Glob + Grep + git-log fan-out - ruflo-goals/: concept seed, plugin tree introspection Each example ships markdown + JSON. Validates ADR-099 end-to-end. Co-Authored-By: RuFlo <ruv@ruv.net> --------- Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
2026-05-03 23:15:22 -04:00
- `deep-researcher` -- Multi-source research with evidence grading (linear, question-driven)
feat: add ruflo-goals plugin — GOAP planning, deep research, horizon tracking 4 skills: deep-research, goal-plan, horizon-track, research-synthesize 3 agents: goal-planner, deep-researcher, horizon-tracker 1 command: /goals Wires memory, task, workflow, neural, agentdb, and intelligence MCP tools for long-horizon research and adaptive replanning. Co-Authored-By: claude-flow <ruv@ruv.net>
2026-04-27 23:52:25 -04:00
- `horizon-tracker` -- Cross-session objective tracking with drift detection
feat(ruflo-goals): dossier-investigator agent + dossier-collect skill (ADR-099) (#1726) * feat(plugins): ruflo-goals/dossier-investigator agent + dossier-collect skill New entry-point added during the autonomous loop session — dossier investigator agent and supporting skill that traverses RuVector memory for recursive parallel research. plugins/ruflo-goals/agents/dossier-investigator.md (new) plugins/ruflo-goals/skills/dossier-collect/ (new) plugins/ruflo-goals/README.md (registry update) plugins/ruflo-goals/.claude-plugin/plugin.json (version bump) Excluded per CLAUDE.md rules: - v3/goal_ui/.env.production (NEVER commit .env) - .claude/scheduled_tasks.lock (runtime artifact) * docs: include v3/docs/examples/ on dossier branch (carried from fix/issues-may-1-3) * docs(examples): add 3 dossier examples (ruvnet, ADR-088, ruflo-goals) Real outputs from running dossier-collect skill against three seed types: - ruvnet/: username seed, GitHub gh-api fan-out + WebSearch - adr-088/: adr-id seed, Read + Glob + Grep + git-log fan-out - ruflo-goals/: concept seed, plugin tree introspection Each example ships markdown + JSON. Validates ADR-099 end-to-end. Co-Authored-By: RuFlo <ruv@ruv.net> --------- Co-authored-by: Reuven <cohen@ruv-mac-mini.local>
2026-05-03 23:15:22 -04:00
- `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` |
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
## 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](../ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md). [ADR-0001](./docs/adrs/0001-goals-contract.md) 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](../../v3/docs/adr/ADR-099-dossier-investigator-recursive-parallel-research.md) — 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
- [`ADR-0001` — ruflo-goals plugin contract (legacy-vs-canonical namespaces, GOAP/dossier workflow contract)](./docs/adrs/0001-goals-contract.md)
Reference in New Issue Copy Permalink