refactor(aidd-context): rebuild 11-discovery as 11-explore#287
Merged
Conversation
Replace the eight near-duplicate find-* actions with a two-action, three-axis project survey. survey detects tools and maps Tooling, Context, and Codebase; drill digs into one axis and points to the best match for a goal. explore maps the project, onboard still owns the next step. Update every skill-id reference and capability list (plugin manifest, plugin README, top README, UPGRADE, docs catalog, onboard, context-generate, project memory map) from 11-discovery to 11-explore. Regenerate the plugin CATALOG. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Route by intent: detect the tools first, then run survey for a compact map when no scope is named, or drill straight into a named axis or all. survey proposes the axes or all instead of asking for one. drill becomes a self-re-entering recursive descent: it lists the current level in full, points to a goal's best match, and goes one level deeper per user confirmation (a skill into its actions, a memory file into its sections) until a leaf or a stop. drill detects the tools when entered cold without a prior survey. "all" lists each axis at one level, never auto-recurses every leaf. Map-never-prescribe holds at every depth. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…atch The rebuilt description dropped the find-the-right-item trigger the old discovery skill carried. drill still does goal-matching, so restore it as a trigger and trim the rest: survey what is installed, see what is available, or find which installed skill, agent, or rule fits a goal. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The description carried a mechanism detail (one axis). Drop it: at the description level explore is exploration, and the propose-or-accept contract is what matters, drill into an axis the user names or this skill proposes. The level-by-level recursion lives in the actions. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Even the propose-or-accept phrasing was mechanism. The description is exploration across the three axes and nothing more, the flow lives in the actions. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Rename and rebuild the
11-discoveryskill as11-explore: a verb-named, higher-level project survey.The old skill was eight near-duplicate
find-*actions (skill, agent, command, plugin, mcp, rule, hook, memory) all running the same enumerate to recommend flow. Replaced with two actions over three axes:01-survey: detect the tools, scan Tooling / Context / Codebase, present one grouped map, offer to dig in.02-drill: list one axis in full, match a goal to the single best item, point to its invocation path.exploremaps the project across the three axes and never prescribes a next step. That stays00-onboard's job.Reference updates
Every skill-id reference and capability list moved from
11-discoveryto11-explore:skills[]path, description, keyword)README.md,UPGRADE.md(v4 table + verify step),docs/CATALOG.md00-onboardSKILL/README cross-refs,03-context-generateSKILL/README cross-refsaidd_docs/README.md)plugins/aidd-context/CATALOG.mdGeneric word usages of "discovery" (CREATE_PLUGIN's discovery-by-description, onboard's runtime skill discovery, authoring references, CHANGELOG history) were left untouched.
Note
docs/CATALOG.mdis globally stale (every skill number predates the renumbering). Only the explore row + word were fixed here to avoid leaving dead refs to the deletedfind-*actions. The rest of that doc's drift is separate cleanup.🤖 Generated with Claude Code