feat: improve project-kickoff skill — research-first, suggested answers, opensrc#2
Merged
Merged
Conversation
- Add Phase 0: silent research & inference before any questions - Extracts facts from user's message - WebSearches the concept to understand the domain and infer stack - Assigns HIGH/MEDIUM/UNKNOWN confidence tier to every answer - Rewrite Phase 1: pre-filled confirmation block instead of blank form - Every item shows [Pre-filled], [Suggested: X — reason], or [Needed] - Uses AskUserQuestion tool for binary/choice questions - User confirms or corrects, not fills from scratch - Phase 2 reuses Phase 0 research — no duplicate WebSearch - Add Gotchas section: personal/pro mismatch, org repos, SSH vs HTTPS, Windows paths, WebSearch unavailable, minimal-context fallback Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Phase 0: extract npm packages, GitHub repos, and URLs from user's message into an explicit fetch queue. Phase 1: item 10 now shows pre-filled list of what will be fetched with opensrc, rather than asking the user to remember. Phase 5: complete rewrite — always runs (new and existing projects), uses `npx opensrc` for packages/repos, WebFetch for URLs, verifies opensrc/ in .gitignore before fetching, documents refs in CLAUDE.md. .gitignore: add comment linking to vercel-labs/opensrc. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove references/ from .gitignore — opensrc/ is the single home for all local context: npm packages, repos, and fetched docs/URLs. Update skill Phase 5 and CLAUDE.md templates accordingly. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…DE.md The CLAUDE.md template now tells the agent about opensrc so it can fetch additional context during regular work, not just at kickoff. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Tell the agent exactly when to use opensrc: before working with any package/repo, and for saving reference docs/specs. Both the skill's generated CLAUDE.md template and the project root CLAUDE.md now say the same thing. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
gurvinder-dhillon
added a commit
that referenced
this pull request
Apr 7, 2026
…stency, install syntax - Description rewritten to start with "Use when..." and drop workflow summary (CSO rule) - Duplicate Step 3 in Phase 0 renamed to Step 4 - Eval #2 expectation corrected from references/ to opensrc/<name>.md - Install commands corrected from path syntax to --skill flag Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
gurvinder-dhillon
added a commit
that referenced
this pull request
Apr 7, 2026
* docs: rename Maestro to Zenith across branding files Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(project-kickoff): fix CSO violation, step numbering, eval inconsistency, install syntax - Description rewritten to start with "Use when..." and drop workflow summary (CSO rule) - Duplicate Step 3 in Phase 0 renamed to Step 4 - Eval #2 expectation corrected from references/ to opensrc/<name>.md - Install commands corrected from path syntax to --skill flag Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <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.
Summary
[Pre-filled],[Suggested: X — reason], or[Needed]; usesAskUserQuestiontool for binary choicesnpx opensrcfor packages/repos, WebFetch saves toopensrc/, verifies gitignore before fetchingreferences/intoopensrc/(one gitignored dir), added Gotchas section, Phase 2 reuses Phase 0 researchTest plan
/project-kickoffwith a vague prompt — verify Claude researches before askingbash .github/scripts/validate.sh— must pass🤖 Generated with Claude Code