diff --git a/.agents/skills/interview/SKILL.md b/.agents/skills/interview/SKILL.md new file mode 100644 index 000000000..34f87588a --- /dev/null +++ b/.agents/skills/interview/SKILL.md @@ -0,0 +1,26 @@ +--- +name: interview +description: A interview to sharpen a plan or design. +disable-model-invocation: true +--- + +Interview me about every aspect of this until we reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. + +Before the first question, explore the environment, then calibrate the session in one brief message: + +- Open with one or two sentences restating the task, to show you understand it. +- Then a numbered list of calibration questions, each with your recommended answer, covering only the items my opening prompt leaves open: + 1. Ambiguities in the request + 2. The criteria for judging options. + 3. How deep to grill me. + 4. What the deliverable is when we're done. +- Keep each item concise and focused +- If my opening prompt settles all four, skip the list and follow the restatement with the first question. + +After calibration, ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering. + +A question stays open until I make a decision or tell you to move on. If I reply with anything else, such as a question of my own, answer it, then close by asking whether there is more to discuss or I'm ready to decide. + +If a _fact_ can be found by exploring the environment (filesystem, tools, etc.), look it up rather than asking me. The _decisions_, though, are mine — put each one to me and wait for my answer. + +Do not act on it until I confirm we have reached a shared understanding. diff --git a/.claude/skills/interview b/.claude/skills/interview new file mode 120000 index 000000000..53b689e5c --- /dev/null +++ b/.claude/skills/interview @@ -0,0 +1 @@ +../../.agents/skills/interview \ No newline at end of file diff --git a/skills-lock.json b/skills-lock.json index 215c5b07c..e86dcc9e3 100644 --- a/skills-lock.json +++ b/skills-lock.json @@ -91,6 +91,12 @@ "skillPath": "skills/engineering/improve-codebase-architecture/SKILL.md", "computedHash": "66e8a50c83c3c724fcfe0769701b665c56cec220cc4f49cc1aee8bdfc07de94a" }, + "interview": { + "source": "joshunrau/skills", + "sourceType": "github", + "skillPath": "skills/interview/SKILL.md", + "computedHash": "8c4282946c760be30b49f1fbf5645bb0aedac285e6cac5c8f9e8c8b68f35a422" + }, "loop-me": { "source": "mattpocock/skills", "sourceType": "github",