@codihaus/claude-skills 1.6.22 → 1.6.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codihaus/claude-skills",
-  "version": "1.6.22",
+  "version": "1.6.23",
   "description": "Claude Code skills for software development workflow",
   "main": "src/index.js",
   "bin": {

package/skills/debrief/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: debrief
 description: Customer requirements → market-validated BRD with tiered features
-version: 4.0.0
+version: 4.1.0
 ---
 
 # /debrief - Business Requirements Document
@@ -24,10 +24,11 @@ version: 4.0.0
 ## Usage
 
 ```bash
-/debrief "Customer wants..."           # New project
-/debrief "Add {feature}"               # Add feature
-/debrief --answers questionnaire.xlsx  # Process answers
-/debrief --questionnaire-only          # Questions only
+/debrief "Customer wants..."                # New project
+/debrief "Add {feature}"                    # Add feature
+/debrief --answers questionnaire.xlsx       # Process answers
+/debrief --generate-brd questionnaire.xlsx  # Generate BRD from existing research
+/debrief --questionnaire-only               # Questions only
 ```
 
 ---
@@ -106,6 +107,7 @@ Keep use cases ~30 lines max. Business stakeholders scan in 30 seconds.
 - No `plans/brd/` → New Project
 - `plans/brd/` exists → Add Feature
 - `--answers {file}` → Process Answers
+- `--generate-brd {file}` → Generate BRD from research
 - `--questionnaire-only` → Questions Only
 
 ---

package/skills/debrief/references/workflow.md

@@ -14,6 +14,7 @@
 
 **Detection**:
 - `--answers {file}` → Process Answers mode
+- `--generate-brd {file}` → Generate BRD mode
 - `--questionnaire-only` → Questionnaire Only mode
 - No `plans/brd/` → New Project mode
 - `plans/brd/` exists → Add Feature mode
@@ -31,12 +32,13 @@
 
 ### Context Gathering
 
-**Ask 5 questions** (AskUserQuestion):
+**Ask 6 questions** (AskUserQuestion):
 1. Project type (new/existing codebase)
 2. Industry (SaaS/E-commerce/Marketplace/etc.)
 3. Target users (B2B/B2C/Internal)
 4. Constraints (timeline/budget/compliance/integrations)
 5. Scope tier (Core/Standard/Full)
+6. Research depth (Quick 5min / Deep 15-20min)
 
 **If existing codebase**: Scan for docs + features (Glob, Read)
 
@@ -48,15 +50,19 @@
 
 **Methodology**: See `research.md` for full process.
 
-**Comparison-first**:
+**Quick** (5 min):
 - Find 2-3 comparison/alternative pages
 - Extract feature matrix
 - Initial tier hypothesis
 
-**Deep validation**:
-- Per feature: cross-validate with ecosystem + user signals
-- Classify tier (MVP/Standard/Advanced)
-- Collect evidence
+**Deep** (15-20 min):
+- Comparison pages (initial)
+- Cross-validate with ecosystem + user signals
+- Full tier classification with evidence
+
+**After research, ask output preference**:
+- Summary + Questionnaire (review first)
+- Full BRD (write all files now)
 
 **Output**: Features with tier classification and evidence
 
@@ -121,13 +127,12 @@
 
 **Principle**: Always generate. Validate assumptions + fill gaps.
 
-**Include**:
-- **Validation questions**: "We found 9/10 competitors offer SSO. Confirm?"
-- **Open questions**: "What's max team size per account?"
-
-**Categories**: Validation, Business, Requirements, Constraints, Integration
+**3 sheets**:
+- **Summary**: Feature count, tier distribution, research stats
+- **Questions**: Validation + open questions
+- **References**: URLs by feature (comparison pages, reviews, ecosystems)
 
-**Output**: `features/{feature}/questionnaire-{date}.xlsx`
+**Output**: `features/{feature}/questionnaire-{date}.xlsx` (permanent reference)
 
 ---
 
@@ -156,9 +161,10 @@
 
 ### Context Gathering
 
-**Ask 2 questions**:
+**Ask 3 questions**:
 1. Feature name
 2. Scope tier (Core/Standard/Full)
+3. Research depth (Quick / Deep)
 
 **Duplicate check**: Read `docs-graph.json` if exists, warn if similar feature found
 
@@ -233,6 +239,24 @@
 
 ---
 
+## Generate BRD Mode
+
+**Goal**: Generate full BRD from existing questionnaire research.
+
+**Mindset**: Resumption mode. User reviewed Summary + Questionnaire, ready for full BRD.
+
+### Process
+
+**Read questionnaire**:
+- Summary sheet (features, tiers, research stats)
+- References sheet (source URLs)
+
+**Generate**: Full BRD structure from existing research (no re-research)
+
+**Output**: BRD files + feature folders
+
+---
+
 ## Questionnaire Only Mode
 
 **Goal**: Generate questions without creating BRD.
@@ -303,6 +327,7 @@
 **Workflow adapts to mode**:
 - New Project: Full discovery and research
 - Add Feature: Focused research, duplicate check
+- Generate BRD: Reads existing questionnaire research
 - Process Answers: Integration and validation
 - Change Request: Impact tracking
 - Questionnaire Only: Quick question generation

package/skills/debrief/scripts/generate_questionnaire.py

@@ -10,6 +10,18 @@ questions.json format:
 {
     "project_name": "Project Name",
     "date": "2024-01-20",
+    "research": {
+        "depth": "Deep",
+        "features_count": 12,
+        "tiers": {"MVP": 5, "Standard": 4, "Advanced": 3},
+        "sources_count": 23
+    },
+    "references": {
+        "Authentication": [
+            {"type": "Comparison", "url": "https://..."},
+            {"type": "G2 Reviews", "url": "https://..."}
+        ]
+    },
     "questions": [
         {
             "category": "Requirements",
@@ -119,14 +131,24 @@ def create_questionnaire(output_path: str, questions_data: dict):
 
     # Summary sheet
     ws_summary = wb.create_sheet("Summary", 0)
+    research = questions_data.get('research', {})
+    tiers = research.get('tiers', {})
+
     summary_data = [
         ("Project Questionnaire", ""),
         ("", ""),
         ("Project:", questions_data.get('project_name', '')),
         ("Generated:", questions_data.get('date', '')),
-        ("Total Questions:", len(questions)),
         ("", ""),
-        ("Priority Breakdown:", ""),
+        ("Research Summary:", ""),
+        ("Depth:", research.get('depth', 'N/A')),
+        ("Features:", research.get('features_count', 0)),
+        ("  MVP:", tiers.get('MVP', 0)),
+        ("  Standard:", tiers.get('Standard', 0)),
+        ("  Advanced:", tiers.get('Advanced', 0)),
+        ("Sources:", research.get('sources_count', 0)),
+        ("", ""),
+        ("Questions:", len(questions)),
     ]
 
     # Count priorities
@@ -134,28 +156,8 @@ def create_questionnaire(output_path: str, questions_data: dict):
     optional_count = len(questions) - required_count
 
     summary_data.extend([
-        ("Required:", required_count),
-        ("Optional:", optional_count),
-        ("", ""),
-        ("Categories:", ""),
-    ])
-
-    # Count categories
-    categories = {}
-    for q in questions:
-        cat = q.get('category', 'General')
-        categories[cat] = categories.get(cat, 0) + 1
-
-    for cat, count in sorted(categories.items()):
-        summary_data.append((f"  {cat}:", count))
-
-    summary_data.extend([
-        ("", ""),
-        ("Instructions:", ""),
-        ("1.", "Fill in the 'Answer' column for each question"),
-        ("2.", "Required questions must be answered before proceeding"),
-        ("3.", "Context/Source shows where this question originated"),
-        ("4.", "Save and return this file when complete"),
+        ("  Required:", required_count),
+        ("  Optional:", optional_count),
     ])
 
     for row, (col1, col2) in enumerate(summary_data, 1):
@@ -169,6 +171,29 @@ def create_questionnaire(output_path: str, questions_data: dict):
     ws_summary.column_dimensions['A'].width = 25
     ws_summary.column_dimensions['B'].width = 40
 
+    # References sheet
+    references = questions_data.get('references', {})
+    if references:
+        ws_refs = wb.create_sheet("References")
+        ws_refs.cell(1, 1, "Feature").font = header_font
+        ws_refs.cell(1, 2, "Source Type").font = header_font
+        ws_refs.cell(1, 3, "URL").font = header_font
+        ws_refs.cell(1, 1).fill = header_fill
+        ws_refs.cell(1, 2).fill = header_fill
+        ws_refs.cell(1, 3).fill = header_fill
+
+        row = 2
+        for feature, sources in references.items():
+            for source in sources:
+                ws_refs.cell(row, 1, feature)
+                ws_refs.cell(row, 2, source.get('type', ''))
+                ws_refs.cell(row, 3, source.get('url', ''))
+                row += 1
+
+        ws_refs.column_dimensions['A'].width = 20
+        ws_refs.column_dimensions['B'].width = 20
+        ws_refs.column_dimensions['C'].width = 60
+
     # Save
     wb.save(output_path)
     print(f"Created: {output_path}")