From 88e33c375afd4e4cd08c2b77266704121ecb98be Mon Sep 17 00:00:00 2001
From: Zhongwei Li <lizhongwei.nkcs@gmail.com>
Date: Sun, 30 Nov 2025 08:30:34 +0800
Subject: [PATCH] Initial commit

---
 .claude-plugin/plugin.json | 12 +++++
 README.md                  |  3 ++
 commands/clarify_task.md   | 93 ++++++++++++++++++++++++++++++++++++++
 plugin.lock.json           | 45 ++++++++++++++++++
 4 files changed, 153 insertions(+)
 create mode 100644 .claude-plugin/plugin.json
 create mode 100644 README.md
 create mode 100644 commands/clarify_task.md
 create mode 100644 plugin.lock.json

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
new file mode 100644
index 0000000..839d9fb
--- /dev/null
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,12 @@
+{
+  "name": "clarification",
+  "description": "A lightweight plugin for clarifying tasks and requirements through structured questions",
+  "version": "1.0.0",
+  "author": {
+    "name": "Kasper Junge",
+    "url": "https://github.com/kasperjunge"
+  },
+  "commands": [
+    "./commands"
+  ]
+}
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..afbab23
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+# clarification
+
+A lightweight plugin for clarifying tasks and requirements through structured questions
diff --git a/commands/clarify_task.md b/commands/clarify_task.md
new file mode 100644
index 0000000..c586208
--- /dev/null
+++ b/commands/clarify_task.md
@@ -0,0 +1,93 @@
+# Clarify Task
+Helps clarify any task, feature, or requirement by asking focused questions to uncover details, edge cases, and success criteria.
+
+## Initial Setup
+Respond with:
+```
+I'm ready to help clarify your task.
+
+Please describe what you want to accomplish.
+```
+
+Wait for user input.
+
+## Workflow
+1. **Receive user's task description**
+2. **Ask clarifying questions** (3-5 at a time) about:
+   - Core objectives and desired outcomes
+   - Key scenarios and use cases
+   - Edge cases and error conditions
+   - Constraints and limitations
+   - Success criteria and acceptance criteria
+   - Scope boundaries (what's in/out)
+   - Priority and dependencies
+3. **Continue asking** until no more questions remain
+4. **Summarize clarified understanding** in a concise format
+
+## Guidelines
+- Each clarifying question should be numbered
+- Focus on understanding WHAT needs to be done and WHY
+- Ask about edge cases and error scenarios
+- Identify explicit scope boundaries
+- Uncover implicit assumptions
+- Be specific: ask for measurable criteria when possible
+- Avoid making assumptions - ask instead
+- Prioritize questions that have the biggest impact on the approach
+
+## Chat Output Format
+After completing clarification:
+```
+I now have a clear understanding of your task:
+
+**Objective**: [Clear statement of what needs to be accomplished]
+
+**Key Requirements**:
+- [Requirement 1]
+- [Requirement 2]
+- [Requirement 3]
+
+**Success Criteria**:
+- [How we'll know this is done correctly]
+- [Measurable outcome if applicable]
+
+**Out of Scope**:
+- [What we're explicitly NOT doing]
+
+**Edge Cases to Consider**:
+- [Edge case 1]
+- [Edge case 2]
+
+Ready to proceed?
+```
+
+## Example Questions to Ask
+
+### Understanding the Core Need
+- What problem are you trying to solve?
+- What's the desired outcome?
+- Who will benefit from this?
+- What happens if we don't do this?
+
+### Clarifying Scope
+- What are the must-have features vs. nice-to-have?
+- Are there any specific constraints (time, budget, technology)?
+- What's explicitly out of scope?
+- What's the minimum viable version?
+
+### Edge Cases and Error Handling
+- What should happen if [edge case scenario]?
+- How should errors be handled?
+- What are the failure modes?
+- Are there any security considerations?
+
+### Success Criteria
+- How will you know this is successful?
+- What does "done" look like?
+- Are there any performance requirements?
+- What should the user experience be?
+
+### Dependencies and Context
+- Does this depend on anything else?
+- Does anything else depend on this?
+- Is there existing code/infrastructure to consider?
+- Are there any similar implementations to reference?
diff --git a/plugin.lock.json b/plugin.lock.json
new file mode 100644
index 0000000..754bc9b
--- /dev/null
+++ b/plugin.lock.json
@@ -0,0 +1,45 @@
+{
+  "$schema": "internal://schemas/plugin.lock.v1.json",
+  "pluginId": "gh:kasperjunge/30-minute-vibe-coding-challenge:plugins/clarification",
+  "normalized": {
+    "repo": null,
+    "ref": "refs/tags/v20251128.0",
+    "commit": "dece7ebd6cfa94163417391f386c0114556ed0f8",
+    "treeHash": "6bb0174273b0ce9c74628c42e1f3910a459290f2a949a8d5eaa71ccca3b64a65",
+    "generatedAt": "2025-11-28T10:19:25.625916Z",
+    "toolVersion": "publish_plugins.py@0.2.0"
+  },
+  "origin": {
+    "remote": "git@github.com:zhongweili/42plugin-data.git",
+    "branch": "master",
+    "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
+    "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
+  },
+  "manifest": {
+    "name": "clarification",
+    "description": "A lightweight plugin for clarifying tasks and requirements through structured questions",
+    "version": "1.0.0"
+  },
+  "content": {
+    "files": [
+      {
+        "path": "README.md",
+        "sha256": "551e20c8aabb2e00bae08119482d823bb2c630fd5a506f802c3bc9a383e2b478"
+      },
+      {
+        "path": ".claude-plugin/plugin.json",
+        "sha256": "b0d5a877c6acda02d93bcba1813b5f18eb1d554b2664a4125648ddd7bf009ac6"
+      },
+      {
+        "path": "commands/clarify_task.md",
+        "sha256": "8dbecf69bfbd655724d2466632df59385e150810b9942c05f4e6bbc60df4790e"
+      }
+    ],
+    "dirSha256": "6bb0174273b0ce9c74628c42e1f3910a459290f2a949a8d5eaa71ccca3b64a65"
+  },
+  "security": {
+    "scannedAt": null,
+    "scannerVersion": null,
+    "flags": []
+  }
+}
\ No newline at end of file