Home / llopresto87 / cypress · skills/brainstorm-socratic/SKILL.md · GitHub

brainstorm-socratic skillA

brainstorm-socratic is agent-read markdown (skill) from llopresto87/cypress: The Socratic questioning technique that converges a vague goal — question selection, one-to-three-per-turn pacing, the reflect-every-two-answers cadence, the nine-question hard cap, and the eight-point convergence checklist that defines "converged". This is the USER-FACING of the brainstorm protocol's two modes — use it when the decision is the owner's to make; when it is the session's own, the mode is skill.brainstorm-internal and there is nobody to question. The protocol owns entry/exit condit.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# brainstorm-socratic

**This is the mode with a person in it.** It applies when the answer is the
owner's to give — what to build, for whom, what counts as done, which tradeoff
they have to live with. When the decision is the session's own, there is nobody
to question and the technique below does not apply: use
`docs/graph/skills/brainstorm-internal.md`. `brainstorm.mode-selection` in
`docs/graph/protocols/brainstorm.md` owns the test.

A goal that arrives as "build me a thing" is not yet ready to specify
or plan. This skill is the questioning technique that takes it from
vague to precise — without designing the UI, picking a framework, or
pre-committing to architecture. It is applied inside
`docs/graph/protocols/brainstorm.md`, which owns entry conditions, the grill.md
output map, and the explicit-confirmation exit; this file owns the
method.

## How to brainstorm

### Ask the smallest set of questions that change the design the most

Bad: "What colour?", "What should the homepage look like?", "What
framework?"

Good: "Who is this for and what do they do today instead?", "What
counts as success one month in?", "What is explicitly out of scope?"
…

Read the whole file at its exact version.

How to install

Latest version
mdr add llopresto87/cypress/brainstorm-socratic@git:20260921.0e86c1a
Exact content
mdr add llopresto87/cypress/brainstorm-socratic@sha256:bde1b56006250111

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7mwlrmhjncje66id.svg)](https://markdownregistry.com/a/art_7mwlrmhjncje66id)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260921.0e86c1a latest2026-09-21 0e86c1a 6,000 BA view · diff
git:20260915.df305672026-09-15 df30567 5,997 BA view · diff
git:20260831.6dde4342026-08-31 6dde434 4,269 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6000 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

llopresto87/cypress · 43 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7mwlrmhjncje66id
GET https://markdownregistry.com/api/v1/resolve?ref=llopresto87/cypress/brainstorm-socratic
GET https://markdownregistry.com/api/v1/blob/bde1b560062501117c5fc3fd37fdaa55b0b9f2d3469ca3c105bf3ca3357fe93a

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from llopresto87/cypress

CLAUDE.md claude
llopresto87/cypress · CLAUDE.md
git:20260924.fae0414 · audit A · 43 stars
AGENTS.md@core agents
llopresto87/cypress · core/AGENTS.md
git:20260915.df30567 · audit A · 43 stars
adopt-existing skill
llopresto87/cypress · skills/adopt-existing/SKILL.md · Source-first growth of an existing single- or multi-repository project into CYPRESS's unified docs/graph knowledge…
git:20260915.df30567 · audit A · 43 stars
adr-writer skill
llopresto87/cypress · skills/adr-writer/SKILL.md · Author an Architecture Decision Record that captures a non-obvious technical choice — its context, the decision, the…
git:20260915.df30567 · audit A · 43 stars
brainstorm-internal skill
llopresto87/cypress · skills/brainstorm-internal/SKILL.md · The divergence technique CYPRESS applies to itself, with no user in the loop — generating genuinely distinct options…
git:20260921.0e86c1a · audit A · 43 stars
context-router skill
llopresto87/cypress · skills/context-router/SKILL.md · Resolve the minimum set of knowledge-graph nodes needed for a task before reading any source file. Use at the START of…
git:20260923.837b1a5 · audit A · 43 stars
grill-planner skill
llopresto87/cypress · skills/grill-planner/SKILL.md · The authoring discipline for the project's plan-of-record at docs/graph/plans/grill.md — what a worker filling any…
git:20260922.d73629d · audit A · 43 stars
holistic-editing skill
llopresto87/cypress · skills/holistic-editing/SKILL.md · The discipline for any change, fix, refactor, or review whose unit of work is larger than a trivial one-liner. Use…
git:20260915.df30567 · audit A · 43 stars
humanizer skill
llopresto87/cypress · skills/humanizer/SKILL.md · Draft or revise prose a person will read (documentation, README text, ADR and spec bodies, runbooks, pull-request…
git:20260915.df30567 · audit A · 43 stars
knowledge-graph skill
llopresto87/cypress · skills/knowledge-graph/SKILL.md · Build and maintain the project's knowledge graph — a tiered set of nodes under docs/graph/ that lets an agent load only…
git:20260917.c81f94c · audit A · 43 stars
library-wiki skill
llopresto87/cypress · skills/library-wiki/SKILL.md · Maintain a project-local, version-pinned wiki of every external dependency. Use whenever a new library is being added…
git:20260922.d73629d · audit A · 43 stars
research-and-ingest skill
llopresto87/cypress · skills/research-and-ingest/SKILL.md · Find authoritative sources on the web (or via documentation MCP servers like Context7/DeepWiki), download or snapshot…
git:20260915.df30567 · audit A · 43 stars

Every file in llopresto87/cypress

Browse by kind, by grade A, or by owner.