Skip to content

Add reef as external plugin source#527

Open
eunji-jessi-jung wants to merge 1 commit intojeremylongshore:mainfrom
eunji-jessi-jung:add-reef-external
Open

Add reef as external plugin source#527
eunji-jessi-jung wants to merge 1 commit intojeremylongshore:mainfrom
eunji-jessi-jung:add-reef-external

Conversation

@eunji-jessi-jung
Copy link
Copy Markdown

Summary

  • Adds reef to sources.yaml as an external plugin
  • Category: productivity
  • Structured knowledge wiki generator for codebases — 12 skills, 1 agent, progressive depth (snorkel → source → scuba → deep → update), Obsidian-native, local-first
  • Apache-2.0 license

Plugin details

  • Skills: init, snorkel, source, scuba, deep, artifact, update, lint, health, feed, test, help
  • Agents: reef-navigator (read-only artifact queries)
  • Dependencies: Python + PyYAML
  • Demo: supabase-reef — 5 repos, 28-run benchmark

Sync config

  • source_path: . (full repo)
  • Excludes project/ (internal planning docs)
  • Includes skills, agents, references, scripts, docs

Structured knowledge wiki generator for codebases — 12 skills,
1 agent, progressive depth (snorkel → source → scuba → deep → update),
Obsidian-native output. Apache-2.0.

Repo: https://github.com/eunji-jessi-jung/reef
Demo: https://github.com/eunji-jessi-jung/supabase-reef

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📋 Review Summary

The pull request adds a new external plugin source, reef, to sources.yaml. The changes are well-structured and the new entry is comprehensive.

🔍 General Feedback

  • The new plugin configuration is clear and follows the existing format.
  • One minor suggestion was made to improve the consistency of the plugin's description.

Comment thread sources.yaml
- name: reef
description: Structured knowledge wiki generator for codebases with progressive depth and guided Q&A
repo: eunji-jessi-jung/reef
source_path: .
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 For consistency with the PR description and the file's comments, consider adding 'Obsidian-native, local-first' to the description.

Suggested change
source_path: .
description: Structured knowledge wiki generator for codebases with progressive depth and guided Q&A — Obsidian-native, local-first

@jeremylongshore
Copy link
Copy Markdown
Owner

Thanks @eunji-jessi-jung — ran the validators locally:

  • YAML: ✓ valid
  • Trailing whitespace: ✓ none
  • Include/exclude patterns: ✓ comprehensive (skills, agents, references, docs, scripts all covered)
  • Apache-2.0 license: ✓

One optional note: your personal email (`eunji.jessi.jung@gmail.com`) is in the `author.email` field, which will be permanently visible in the public `sources.yaml` once merged. That's fine if intentional — contributors often prefer to include it for attribution / contact — but if you'd rather keep it private, you can remove that line (the `github:` handle is enough for the sync to work). No blocker either way.

Otherwise clean. Over to @jeremylongshore for final sign-off.

Jeremy made me do it
-claude

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants