@codihaus/claude-skills 1.6.24 → 1.6.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codihaus/claude-skills",
-  "version": "1.6.24",
+  "version": "1.6.25",
   "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.2.0
+version: 5.0.0
 ---
 
 # /debrief - Business Requirements Document
@@ -78,22 +78,26 @@ version: 4.2.0
 
 **If you mention files, code, APIs, or tech → YOU ARE DOING IT WRONG.**
 
-### 3. Comparison-First Research
+### 3. Deep Research (Always)
 
-Use comparison pages first (5-10 competitors in one page):
-- `"{category} comparison"`
-- `"best {category} alternatives"`
+**Always thorough**:
+- Comparison pages (feature matrix)
+- Ecosystems (Chrome, WordPress, GitHub)
+- User signals (Reddit, reviews, forums)
+- Full evidence per feature
 
-Then validate per feature (Quick or Deep).
+No quick mode. Always deep.
 
-### 4. Questionnaire = Research Output
+### 4. Questionnaire = Decision Tool
 
-**3 sheets**:
-- Summary (stats, tiers)
+**3 sheets with evidence**:
+- Summary (features count, tier breakdown, research stats)
 - Questions (validation + open)
-- References (URLs)
+- References (URLs, evidence per feature)
 
-Customer reviews, answers, returns file. Then create BRD via `--answers`.
+**Purpose**: User reviews evidence, makes decisions, validates with customer.
+
+Then create BRD via `--answers` or `--generate-brd`.
 
 ---
 
@@ -110,11 +114,11 @@ Customer reviews, answers, returns file. Then create BRD via `--answers`.
 
 ---
 
-## Market Research
+## Market Research (Always Deep)
 
-**See** `references/market-research-methodology.md`.
+**See** `references/research.md`.
 
-**Sources**: Competitors, ecosystems (Chrome, WordPress, GitHub, etc.), user signals (Reddit, reviews).
+**Always deep**: Comparison + ecosystems + user signals + full evidence.
 
 **Tiers**:
 - **MVP**: 80%+ competitors, free tier, high demand

package/skills/debrief/references/workflow.md

@@ -2,9 +2,9 @@
 
 **Mindset**: Business analyst. Focus on WHAT and WHY, defer HOW to /dev-specs.
 
-**Methodology**: Mode detection → Context gathering → Research → Document → Questionnaire
+**Methodology**: Mode detection → Context gathering → Research (deep) → Questionnaire
 
-**Expected Outcome**: Market-validated BRD with tiered features, lean use cases, customer questionnaire.
+**Expected Outcome**: Questionnaire with deep research evidence (Summary + Questions + References).
 
 ---
 
@@ -37,13 +37,12 @@
   - Reuse → Switch to Generate BRD mode
   - Fresh → Continue with new research
 
-**Ask 6 questions** (AskUserQuestion):
+**Ask 5 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)
 
@@ -51,79 +50,20 @@
 
 ---
 
-### Market Research
+### Market Research (Always Deep)
 
 **Methodology**: See `research.md` for full process.
 
-**Quick** (5 min):
-- Find 2-3 comparison/alternative pages
-- Extract feature matrix
-- Initial tier hypothesis
-
-**Deep** (15-20 min):
-- Comparison pages (initial)
-- Cross-validate with ecosystem + user signals
-- Full tier classification with evidence
+**Deep research** (always):
+1. Comparison pages (feature matrix extraction)
+2. Ecosystems (Chrome, WordPress, GitHub, etc.)
+3. User signals (Reddit, reviews, forums)
+4. Full tier classification with evidence
 
 **Output**: Features with tier classification and evidence
 
 ---
 
-### Feature Sequencing
-
-**Principle**: Order by dependencies within each tier.
-
-**Common patterns**:
-- Create before operate (signup before login)
-- Auth before features (login before projects)
-- Basic before advanced (CRUD before bulk operations)
-- Data before analytics (tracking before dashboards)
-- Core before extensions (email before templates)
-
-**Validation**: No forward dependencies (UC-001 doesn't depend on UC-002)
-
-**Output**: Sequenced feature list (UC-001, UC-002, UC-003...)
-
----
-
-### Use Case Generation
-
-**Principle**: Lean 80/20 format (~30 lines).
-
-**Include (20%)**:
-- Story (1 line)
-- Critical acceptance criteria (3-5 bullets)
-- Key business rules (constraints, limits)
-- Open questions (blockers)
-
-**Defer to /dev-specs (80%)**:
-- Detailed flows, integrations, edge cases, UI/UX
-
-**Template**: `templates/use-case.md`
-
-**Output**: Lean use cases in `brd/use-cases/{feature}/UC-{GROUP}-{NNN}-{slug}.md`
-
----
-
-### BRD Structure
-
-**Project-wide** (`brd/`):
-- README.md (all features index)
-- context.md (stakeholders, users, constraints)
-- references.md (industry, compliance, competitor overview)
-- changelog.md
-
-**Feature-specific** (`features/{feature}/`):
-- README.md (feature overview)
-- references.md (market research, tier evidence)
-- questionnaire-{date}.xlsx
-
-**Templates**: `templates/brd-references.md`, `templates/feature-references.md`
-
-**Output**: Organized BRD structure with scope separation
-
----
-
 ### Generate Questionnaire (ALWAYS)
 
 **Principle**: Default output. No BRD files created yet.
@@ -163,10 +103,9 @@
 
 ### Context Gathering
 
-**Ask 3 questions**:
+**Ask 2 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
 
@@ -192,22 +131,70 @@
 
 **Mindset**: BRD creation mode. Customer validated research, now create structure.
 
-### Process
+### Read Questionnaire
 
 **Read questionnaire** (Excel file):
 - Summary sheet (features, tiers, research)
 - Questions sheet (customer answers)
 - References sheet (source URLs)
 
-**Create BRD structure**:
-- `brd/` files (README, context, references, changelog)
-- `features/{feature}/` folders
-- Use cases (lean format, sequenced)
+---
+
+### Feature Sequencing
+
+**Principle**: Order by dependencies within each tier.
 
-**Incorporate answers**:
-- Update use cases with customer answers
-- Remove questions that were answered
-- Keep unanswered questions in "Open Questions"
+**Common patterns**:
+- Create before operate (signup before login)
+- Auth before features (login before projects)
+- Basic before advanced (CRUD before bulk operations)
+- Data before analytics (tracking before dashboards)
+- Core before extensions (email before templates)
+
+**Validation**: No forward dependencies (UC-001 doesn't depend on UC-002)
+
+**Output**: Sequenced feature list (UC-001, UC-002, UC-003...)
+
+---
+
+### Use Case Generation
+
+**Principle**: Lean 80/20 format (~30 lines).
+
+**Include (20%)**:
+- Story (1 line)
+- Critical acceptance criteria (3-5 bullets)
+- Key business rules (constraints, limits)
+- Open questions (blockers)
+
+**Defer to /dev-specs (80%)**:
+- Detailed flows, integrations, edge cases, UI/UX
+
+**Template**: `templates/use-case.md`
+
+**Incorporate customer answers**:
+- Update use cases with answers from questionnaire
+- Remove answered questions from "Open Questions"
+- Keep unanswered questions
+
+**Output**: Lean use cases in `brd/use-cases/{feature}/UC-{GROUP}-{NNN}-{slug}.md`
+
+---
+
+### BRD Structure Creation
+
+**Create project-wide** (`brd/`):
+- README.md (all features index)
+- context.md (stakeholders, users, constraints)
+- references.md (industry, compliance, competitor overview)
+- changelog.md
+
+**Create feature-specific** (`features/{feature}/`):
+- README.md (feature overview)
+- references.md (market research, tier evidence from questionnaire)
+- Move questionnaire here if not already
+
+**Templates**: `templates/brd-references.md`, `templates/feature-references.md`
 
 **Check completeness**:
 - If gaps remain → note in use cases
@@ -252,9 +239,11 @@
   - Fresh (ignore questionnaire, do new research)
 
 **If reuse**:
-- Read Summary sheet (features, tiers, research stats)
-- Read References sheet (source URLs)
-- Generate BRD structure (no re-research)
+- Execute same process as Process Answers mode
+- Read questionnaire sheets
+- Sequence features
+- Generate use cases
+- Create BRD structure
 
 **If fresh**:
 - Ignore questionnaire