Skip to content

Ship the kickoff interview with the skill - #16

Open
dbalders wants to merge 1 commit into
UCSD:mainfrom
dbalders:skill-kickoff-interview
Open

dbalders wants to merge 1 commit into
UCSD:mainfrom
dbalders:skill-kickoff-interview

Conversation

@dbalders

Copy link
Copy Markdown
Member

Part of #12.

Why

When a developer says "help me get started", the skill runs the kickoff interview. It sent the agent to the interview's text in the project's DECORATOR.md, which exists only once ucsd-decorator-kit init or add has run. The skill also ships on its own through the TritonAI Skills Library. There, the agent had no questions to ask.

The accessibility and security rules already solve the same problem by publishing themselves as skill reference pages (REFERENCE_EXPORTS). This PR does the same for the getting-started rule.

What changed

  • scripts/lib/rules.mjs: adds ["60-getting-started.md", "getting-started.md"] to REFERENCE_EXPORTS. Reference pages render the whole rule, so the on-demand part that CLAUDE.md leaves to DECORATOR.md is included: all six questions, the recommendation tables, the brief template, and the next steps.
  • skills/ucsd-decorator/SKILL.md: "Starting a new project" points to references/getting-started.md, and the References list includes it. Kit projects are unchanged: their rule files still send agents to DECORATOR.md, which holds the same text.
  • test/rules.test.mjs: a new test renders the reference pages and checks every exported rule is published whole: no pointer to DECORATOR.md, no leftover on-demand marker, and the interview's "Round 1" questions present. With the new export removed, the test fails.
  • Generated: adds skills/ucsd-decorator/references/getting-started.md and resyncs library/.
  • CHANGELOG.md: one entry under Unreleased → Added.

The rule files and CLAUDE.md are unchanged.

Not in this PR

#12 also mentions verify and the canvas-rules/ sync, which need the kit's CLI. The interview itself ends with "Then run verify." Saying what to do without the kit is a separate change.

Verification

The skill sent agents to the project's DECORATOR.md for the kickoff
interview, which exists only once the kit is installed. Publish
rules/60-getting-started.md as references/getting-started.md, like the
accessibility and security rules, and point the skill there.

A new test holds every exported reference page to the whole rule: no pointer
to DECORATOR.md, no leftover on-demand marker, and the interview's questions
present. Part of UCSD#12.
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.

1 participant