pandoscope/skills

grilling

Grill the user about a plan, decision, or idea via scored multiple-choice questions.

Voir la source
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

Grilling

Interview user until shared understanding. Walk every branch of decision tree, dependencies one by one. ONE question at a time — wait for answer before next. Facts findable in environment: look up, never ask. Decisions are user's — put each to user, wait. Do not act until user confirms.

Naming: question S«s»Q«q», answer S«s»Q«q»A«n».

Steps

  1. resolve-store.sh path — locates store harness already cloned. Resolve, never clone. Exits non-zero naming its own fix when store is unnamed, unresolved or absent; unnamed → say so out loud and record nothing (silent skip is indistinguishable from successful record). Store URL lives in environment only — never hardcoded, never echoed into artifacts.
  2. resolve-store.sh unmerged — any records → refuse to open session until principal merges previous one, per recording.md.
  3. resolve-store.sh preferences — emits active set as JSON array for session's preferences: copied, never retyped. Inject that set ONLY, never decision history.
  4. Author every decision point as session JSON — whole session so far, answers included. Contract: render/decision-context.ts beside this file; semantics: format.md. NEVER hand-format a question; renderer appends free-text slot itself.
  5. Render both user-facing forms — validation failure names offending field; fix JSON, re-run:
bash
   node --experimental-strip-types <skill-dir>/render/render.ts <session.json> --out <dir>
  1. Publish session.html as artifact, redeploying same URL as session grows; unavailable → print session.md into chat verbatim — never as file attachment, never as timed dialog (dialogs close while user still typing).
  2. Answers arrive as page's copied JSON pasted into chat, or as chat replies: answer id ("S1Q2A1" or "1"), correction via "N, but actually because …" — shorthand "N, BAB …". No live page-to-agent channel yet (pandoscope/skills#139). What answers mean: reading.md. Follow-ups: append new questions plus answers received, re-render; user may revisit earlier answers.
  3. Session end: record every ruling to store, embed rejection reasons in session's target artifact, per recording.md.
  4. check.sh <session.json> — re-validates session, verifies citations are verbatim store lines, fails while records stay unmerged, prints residue to verify by hand.

Question rules

  • Slot 1 carries prediction: preference-driven when active rules match (named in matches), else cold pick. Diverging recommendation sits at slot 2, if-clause arguing when it beats slot 1.
  • Wildcard ONLY when genuinely plausible unexplored branch exists.
  • If-clause = when option beats recommendation. Add "why not recommended" only when it differs from negated if-clause.
  • Near-ties MUST be marked; never fabricate weaknesses for close calls, and never score them as misses.
  • Correction ("N, but actually because …", shorthand "N, BAB …") accepts option, overrides its stated reason — highest-signal event; flag in record.
  • Drill down with ONE follow-up (2-3 ranked guesses + free text) only when free-text answer leaves rejection reasons unstated. Guesses count as predictions.

Non-goals

No automatic preference-rule acceptance — human in loop always. No embedding/RAG tooling. No upstream sync.

du même dépôt

Autres Skills

Tous les Skills
pandoscope
Communauté

caveman

Terse communication that stays easy to parse. Drops filler, pleasantries and hedging while keeping full technical accuracy. Chat keeps natural language, because humans read it; files, docs, comments and commit messages save tokens through cut fluff and flat sentence structure, never through nested clauses. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

installations
6
GitHub Stars
1
Mis à jour
23 sept.
pandoscope
Communauté

documenting-decisions

Routes human attention to decisions that matter in agent-generated code. Active during planning, implementing, fixing. Defines when and how to place DECISION markers in code comments. Also applies when reviewing a diff/PR on request.

installations
6
GitHub Stars
1
Mis à jour
23 sept.
pandoscope
Communauté

domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

installations
6
GitHub Stars
1
Mis à jour
23 sept.
pandoscope
Communauté

tdd

Test-driven development via red-green-refactor with an auditable commit protocol. Use when implementing any feature, bugfix, refactor, or behavior change before writing implementation code, or when the user mentions TDD, red-green-refactor, or test-first development.

installations
5
GitHub Stars
1
Mis à jour
23 sept.