diff --git a/contributors/emails/rafael.zendron22@gmail.com b/contributors/emails/rafael.zendron22@gmail.com new file mode 100644 index 0000000000..7ae9679149 --- /dev/null +++ b/contributors/emails/rafael.zendron22@gmail.com @@ -0,0 +1 @@ +rafaumeu diff --git a/website/docs/reference/skills-catalog.md b/website/docs/reference/skills-catalog.md index 419788352d..ea191b3630 100644 --- a/website/docs/reference/skills-catalog.md +++ b/website/docs/reference/skills-catalog.md @@ -146,6 +146,7 @@ If a skill is missing from this list but present in the repo, the catalog is reg | Skill | Description | Path | |-------|-------------|------| | [`dogfood`](/docs/user-guide/skills/bundled/software-development/software-development-dogfood) | Exploratory QA of web apps: find bugs, evidence, reports. | `software-development/dogfood` | +| [`grill-me`](/docs/user-guide/skills/bundled/software-development/software-development-grill-me) | Adversarial plan interview before implementation. | `software-development/grill-me` | | [`hermes-agent-skill-authoring`](/docs/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring) | Author in-repo SKILL.md files: frontmatter and structure. | `software-development/hermes-agent-skill-authoring` | | [`inspecting-hermes-desktop-dom`](/docs/user-guide/skills/bundled/software-development/software-development-inspecting-hermes-desktop-dom) | Read the live Hermes desktop DOM/CSS over CDP. | `software-development/inspecting-hermes-desktop-dom` | | [`node-inspect-debugger`](/docs/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger) | Debug Node.js via --inspect + Chrome DevTools Protocol CLI. | `software-development/node-inspect-debugger` | diff --git a/website/docs/user-guide/skills/bundled/software-development/software-development-grill-me.md b/website/docs/user-guide/skills/bundled/software-development/software-development-grill-me.md new file mode 100644 index 0000000000..b6d46acb33 --- /dev/null +++ b/website/docs/user-guide/skills/bundled/software-development/software-development-grill-me.md @@ -0,0 +1,121 @@ +--- +title: "Grill Me — Adversarial plan interview before implementation" +sidebar_label: "Grill Me" +description: "Adversarial plan interview before implementation" +--- + +{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} + +# Grill Me + +Adversarial plan interview before implementation. + +## Skill metadata + +| | | +|---|---| +| Source | Bundled (installed by default) | +| Path | `skills/software-development/grill-me` | +| Version | `1.0.0` | +| Author | Rafael Zendron (rafaumeu) | +| License | MIT | +| Platforms | linux, macos, windows | +| Tags | `planning`, `adversarial`, `interview`, `decision-tree`, `pre-implementation`, `review`, `alignment` | +| Related skills | [`plan`](/docs/user-guide/skills/bundled/software-development/software-development-plan), [`requesting-code-review`](/docs/user-guide/skills/bundled/software-development/software-development-requesting-code-review), [`subagent-driven-development`](/docs/user-guide/skills/optional/software-development/software-development-subagent-driven-development), [`test-driven-development`](/docs/user-guide/skills/bundled/software-development/software-development-test-driven-development) | + +## Reference: full SKILL.md + +:::info +The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. +::: + +# Grill-Me Skill + +Stress-tests a plan through structured adversarial questioning before any +code is written. One question per turn, each with a recommendation, resolving +the full decision tree until the plan is watertight. + +## When to Use + +- User says "grill me", "interview my plan", "stress test this idea" +- Before complex work: auth flows, schema changes, migrations, payments +- A plan has unresolved decisions or seems vague +- Before `subagent-driven-development` decomposition + +Do NOT use for existing code (use `requesting-code-review`) or simple one-off +tasks. + +## Prerequisites + +None. The skill works on any plan or raw idea. + +## How to Run + +The agent loads the skill and enters interview mode. No special setup needed. + +## Quick Reference + +| Rule | Detail | +|------|--------| +| One question per turn | Never fire a list | +| Recommendation included | State your recommendation before waiting | +| Explore codebase first | Use `search_files`, `read_file`, `terminal` | +| No code during grill | Alignment only — code after explicit green light | + +## Procedure + +### Phase 1 — Understanding (2-4 questions) + +Establish the real goal and boundaries. + +- What is the ACTUAL objective? +- What is explicitly IN and OUT of scope? +- What are the constraints? (time, tech, team, budget) +- Who are the users? + +### Phase 2 — Technical Decisions (4-8 questions) + +For each architectural decision: + +- "Why this approach and not X?" +- "What happens if Y fails?" +- "What's the worst case?" +- "How would you roll back?" + +Cross-reference with the existing codebase using `search_files` and +`read_file`. If the project already has a pattern, call it out. + +### Phase 3 — Edge Cases (2-4 questions) + +- "What happens if the user does Z?" +- "What if dependency X goes down?" +- "What if volume is 100x expected?" +- "What security implications does this have?" + +### Phase 4 — Synthesis + +When the decision tree is resolved: + +1. Summarize ALL decisions in bullet points +2. List anything left open +3. List what is explicitly OUT of scope +4. Ask: "Aligned? Should I start implementing, or adjust anything?" + +## Pitfalls + +1. **Asking all questions at once.** One question, one answer, always. +2. **Skipping the codebase.** Find the answer in code using Hermes tools instead of asking the user. +3. **Accepting "I don't know" as final.** Suggest options, explain trade-offs, make a recommendation. +4. **Writing code during the grill.** Alignment only — resist the urge. +5. **Being too agreeable.** Your job is to find problems. If everything looks fine, look harder. +6. **Not adapting to the user's language.** Interview in whatever language the user speaks. + +## Verification + +- [ ] Asked exactly one question per turn +- [ ] Provided a recommendation with each question +- [ ] Explored the codebase when relevant (used `search_files` / `read_file`) +- [ ] Covered all four phases before synthesizing +- [ ] Produced a clear summary of all decisions +- [ ] Confirmed user alignment before stopping +- [ ] Suggested next skill (`plan`, `subagent-driven-development`, or `requesting-code-review`) diff --git a/website/sidebars.ts b/website/sidebars.ts index fbbadcec1f..d4f01832e6 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -321,6 +321,7 @@ const sidebars: SidebarsConfig = { collapsed: true, items: [ 'user-guide/skills/bundled/software-development/software-development-dogfood', + 'user-guide/skills/bundled/software-development/software-development-grill-me', 'user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring', 'user-guide/skills/bundled/software-development/software-development-inspecting-hermes-desktop-dom', 'user-guide/skills/bundled/software-development/software-development-node-inspect-debugger',