Skip to content

shalintripathi/organic-os / plugin/skills/hoo-reflector

hoo-reflector

Verified

Use to distill lessons from recent signals and outcomes - "run the reflector", weekly routine step 4, or "what did we learn". Proposes skillbook deltas; the curator merge is gated.

Reflector (weekly) - propose deltas, never write directly

  1. Read: all signals/ since the last reflection, outcomes/ records, current skillbook.md, the last reflections/ file.
  2. Propose deltas, each referencing an entry ID or NEW:
    • NEW lesson (with evidence tag + source: which signal/outcome proves it)
    • S-nnn helpful+1 / harmful+1 (an outcome confirmed/contradicted it)
    • S-nnn deprecate (contradicted repeatedly - cite the evidence)
    • S-nnn edit: <new text> (sharpen wording; meaning preserved) NEVER propose a full rewrite. NEVER propose deleting lines.
  3. Write reflections/YYYY-Www.md listing every delta + evidence.
  4. Stale review: list the entries whose last-confirmed date has aged past their evidence tier's threshold. PYTHONPATH="$CLAUDE_PLUGIN_ROOT/lib" python3 -c "..." snippet calling core.contracts.skillbook_stale(<brain>), which returns {id, evidence, last_confirmed, days_stale, threshold, text} per entry, most stale first. Thresholds by tier: anecdotal 90 days, moderate 180, strong 365 (canonical in core.contracts.STALE_DEFAULTS; a site can override any tier with skillbook: {stale_days: {...}} in site-profile.yaml). Deprecated entries never appear here. Present each one for re-validation next to the evidence from this week's signals and outcomes that would confirm or contradict it:
    • Re-confirmed (the lesson still holds): propose it as a delta applied through skillbook_update(root, "S-nnn"), which stamps last-confirmed to today. That refresh is the point of the review.
    • Cannot be re-confirmed: PROPOSE deprecation as a delta, citing what is missing. The reflector NEVER auto-deprecates and never writes the book on its own - a stale entry is a question for a human, not a verdict, exactly like every other delta in step 2. An entry nobody can speak to this week is left as it is and listed again next week. Age is a prompt to re-check, never a reason to delete.
  5. Curator merge: if the profile marks curator as gated (default), present the deltas for approval (in-session or channel); on approval apply each via skillbook_append / skillbook_update calls - one call per delta.
  6. Commit "reflection: YYYY-Www" if git.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall