eliciting-a-design
Turn an underspecified idea into an approved design doc through collaborative dialogue, informed by Domain-Driven Design elicitation and convergence techniques. Use when a feature, component, or behavior change has no agreed design yet and its shape is still genuinely open, including a brand-new gitapex skill (a drafting-a-skill candidate). When a broader, general-purpose ideation or brainstorming skill is also installed and both match one request, prefer this one -- the narrower, condition-specific trigger wins. Distinct from drafting-issues (authors the issue once a design exists), planning-a-branch-from-an-issue (starts from an issue that already exists), a bare-defect reproduction workflow (a bare defect report earns reproduction, not a design dialogue), and any downstream implementation-planning skill (authors the plan once an issue exists).
- Compatibility
- The text dialogue runs on any Agent Skills runtime; AskUserQuestion is used where the harness offers it, with a plain-text fallback where it does not. The optional visual companion has two paths -- where the Artifact tool is present in the session's own tool inventory, it publishes to the user's own account through the harness's own artifact hosting, no local port and no third-party network request; otherwise it falls back to a local Node.js server requiring Node.js on PATH, a browser, and a free local port -- that fallback path is entirely local, with no outbound network requests of its own.
Pinned to revision 2ec9d48ea412, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/eliciting-a-design/SKILL.md
- skills/eliciting-a-design/metadata/gitapex.yaml
- skills/eliciting-a-design/references/decomposition-and-tracking-issue.md
- skills/eliciting-a-design/references/procedure.md
- skills/eliciting-a-design/references/spec-document-reviewer-prompt.md
- skills/eliciting-a-design/references/tacit-knowledge-elicitation.md
- skills/eliciting-a-design/references/visual-companion-artifact.md
- skills/eliciting-a-design/references/visual-companion.md
- skills/eliciting-a-design/scripts/frame-template.html
- skills/eliciting-a-design/scripts/helper.js
- skills/eliciting-a-design/scripts/server.cjs
- skills/eliciting-a-design/scripts/start-server.sh
- skills/eliciting-a-design/scripts/stop-server.sh
Every link opens the file at its source, pinned to the revision this page describes.