Back to Ruflo

Dossier: `ruflo-goals` plugin

v3/docs/examples/dossiers/ruflo-goals/ruflo-goals.md

3.10.04.9 KB
Original Source

Dossier: ruflo-goals plugin

Generated by dossier-collect skill (ruflo-goals plugin, ADR-099) Seed: ruflo-goals · Seed type: concept (resolves to plugin path) · Depth: 2 · Truncated: false Generated: 2026-05-03

Executive summary

ruflo-goals v0.2.0 is a Claude Code plugin providing GOAP-based planning, multi-source research, long-horizon tracking, and (new in 0.2.0) recursive parallel investigation. It ships 4 agents + 5 skills + 1 slash command in 654 lines across 12 files. The plugin is structured as siblings — goal-planner (planning), deep-researcher (questions), horizon-tracker (long objectives), and dossier-investigator (seeds) — with a documented selection guide. ADR-099 (this dossier's instigator) added the dossier-investigator capability inspired by maigret's recursive-parallel pattern, reusing only ruflo-native tools (no external dependencies).

Entity table

EntityTypeKey attrsSources
ruflo-goalspluginv0.2.0, MITRead:plugin.json
goal-planneragentmodel=sonnet, GOAP+A*Read
deep-researcheragentmodel=sonnet, evidence-gradedRead
horizon-trackeragentmodel=sonnet, drift detectionRead
dossier-investigatoragentmodel=sonnet, NEW in 0.2.0Read
goal-planskillargument-hint=<goal>Read
deep-researchskillargument-hint=<topic>Read
horizon-trackskillsession-spanningRead
research-synthesizeskillreport renderingRead
dossier-collectskillNEW in 0.2.0Read
/goalscommandstatus overviewRead
ADR-099adrintroduces dossier-investigatorRead
goap-plansnamespacememory store for plansRead
researchnamespacememory store for findingsRead
horizonsnamespacememory store for objectivesRead
dossiernamespacememory store for dossiers (NEW)Read

Graph

mermaid
graph TD
  plugin[ruflo-goals v0.2.0] --> goal-planner
  plugin --> deep-researcher
  plugin --> horizon-tracker
  plugin --> dossier-investigator
  plugin --> goal-plan
  plugin --> deep-research
  plugin --> horizon-track
  plugin --> research-synthesize
  plugin --> dossier-collect
  plugin --> goals[/goals command/]
  goal-planner -.drives.-> goal-plan
  deep-researcher -.drives.-> deep-research
  horizon-tracker -.drives.-> horizon-track
  dossier-investigator -.drives.-> dossier-collect
  goal-plan -.persists.-> goap-plans
  deep-research -.persists.-> research
  horizon-track -.persists.-> horizons
  dossier-collect -.persists.-> dossier
  ADR099[ADR-099] -.introduces.-> dossier-investigator
  ADR099 -.introduces.-> dossier-collect

Selection rules (extracted from README)

You haveUse agentUse skill
A questiondeep-researcherdeep-research
A seed entity to expand outwarddossier-investigatordossier-collect
A multi-step objectivegoal-plannergoal-plan
A long-running objectivehorizon-trackerhorizon-track

File inventory (Glob output)

plugins/ruflo-goals/
├── README.md                                  46 lines
├── .claude-plugin/plugin.json                 23 lines
├── commands/goals.md                          12 lines
├── agents/
│   ├── goal-planner.md                        82 lines
│   ├── deep-researcher.md                     61 lines
│   ├── horizon-tracker.md                     67 lines
│   └── dossier-investigator.md                68 lines  ← NEW
└── skills/
    ├── goal-plan/SKILL.md                     59 lines
    ├── deep-research/SKILL.md                 43 lines
    ├── horizon-track/SKILL.md                 61 lines
    ├── research-synthesize/SKILL.md           62 lines
    └── dossier-collect/SKILL.md               70 lines  ← NEW
                                              ────────
                                              654 lines total

Source provenance

RoundTools (parallel batch)Entities surfaced
0Glob plugins/ruflo-goals/**, Read plugin.json, Read README.mdplugin, all 4 agents, all 5 skills, /goals
1Read agents/*.md (4×), Read skills/*/SKILL.md (5×), Read v3/docs/adr/ADR-099*namespaces (goap-plans, research, horizons, dossier), ADR-099

Stats

  • Nodes: 16
  • Edges: 14
  • Tokens: ~2.4k
  • Wall: 1 batch read of 12 files in parallel

Risks / open questions

  • goal-planner.md is 82 lines — exceeds the 80-line guideline from ADR-098. Could be tightened.
  • dossier-investigator and deep-researcher share ~40% of their source matrix (acknowledged tradeoff in ADR-099). Worth tracking actual usage to validate whether they should remain separate.
  • No tests yet for dossier-collect — depth-3 expansion would surface this gap.