chore(skills/grill-me): contributor mapping + docs catalog/sidebar regen

2026-08-06 18:53:09 -07:00
parent a0590001b1
commit 260adeb075
4 changed files with 124 additions and 0 deletions
@@ -0,0 +1 @@
+rafaumeu
@@ -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` |
@@ -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`)
@@ -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',