Rewrite domain-discovery to v3.0: task-focused skills, new phase ordering#5
Merged
LadyBluenotes merged 2 commits intomainfrom Feb 25, 2026
Merged
Rewrite domain-discovery to v3.0: task-focused skills, new phase ordering#5LadyBluenotes merged 2 commits intomainfrom
LadyBluenotes merged 2 commits intomainfrom
Conversation
…ring Major changes based on Electric SQL test run feedback (discussion #2): Phase reordering: - Phase 1: Quick scan (~10 min orientation) instead of exhaustive read - Phase 2: High-level maintainer interview to extract task map FIRST - Phase 3: Deep read informed by maintainer's mental model - Phase 4: Detail interview (gap-targeted, AI-agent, composition) - Phase 5: Finalize artifacts Output unit shift: - Domains are now an intermediate conceptual grouping, not the output - Skills are the output: task-focused, each matching a developer moment - Skills emerge from intersection of domains × developer tasks - YAML schema restructured: skills are top-level with domain reference New skill types: - lifecycle skills (quickstart, go-live) suggested when docs support them - composition skills promoted from footnotes to full skills Other improvements: - Monorepo heuristic: identify 2-3 core packages, read deeply - GitHub issues fallback: FAQ.md, TROUBLESHOOTING.md when no web access - tree-generator updated to consume new schema shape Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
LadyBluenotes
approved these changes
Feb 25, 2026
LadyBluenotes
approved these changes
Feb 25, 2026
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
2 participants
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.
Summary
skills/domain-discovery/SKILL.mdfrom v2.1 → v3.0 based on Electric SQL test run feedback (discussion Feedback on using "skill-domain-discovery" #2)skills/tree-generator/SKILL.mdto consume the new schemaPhase reordering (the big change)
Old: Read everything → draft domain map → interview maintainer
New: Quick scan → high-level interview → deep read → detail interview
The maintainer's mental model of developer tasks IS the skill map. The agent's job is to fill it with sourced content, not to independently derive the structure.
Output unit shift
skillsis top-level withdomainreference,domainsis a lightweight groupingNew skill types
Also includes (from v2.1 review fixes)
package_map.yamlreferencesskill_spec.mdstructural templateTest plan
🤖 Generated with Claude Code