@rfxlamia/skillkit 1.1.0 → 1.2.0

package/skills/skills/coolhunter/knowledge/elicitation-methods.md

@@ -0,0 +1,312 @@
+# Advanced Elicitation Methods
+
+50 analysis methods for deep trend and news analysis. Select based on context.
+
+---
+
+## COLLABORATION METHODS (Multi-Perspective Analysis)
+
+### 1. Stakeholder Round Table
+**Use:** Requirements gathering, finding balanced solutions across competing interests
+**Pattern:** perspectives → synthesis → alignment
+**Best for:** News affecting multiple groups, policy changes, platform updates
+
+### 2. Expert Panel Review  
+**Use:** Deep specialized analysis, peer review quality needed
+**Pattern:** expert views → consensus → recommendations
+**Best for:** Technical announcements, scientific breakthroughs, industry reports
+
+### 3. Debate Club Showdown
+**Use:** Exploring controversial decisions, finding middle ground
+**Pattern:** thesis → antithesis → synthesis
+**Best for:** Polarizing topics, regulatory debates, ethical dilemmas
+
+### 4. User Persona Focus Group
+**Use:** Validating features, discovering unmet needs
+**Pattern:** reactions → concerns → priorities
+**Best for:** Product launches, service changes, consumer-facing news
+
+### 5. Time Traveler Council
+**Use:** Gaining perspective on long-term consequences vs short-term pressures
+**Pattern:** past wisdom → present choice → future impact
+**Best for:** Strategic decisions, technology adoption, cultural shifts
+
+### 6. Cross-Functional War Room
+**Use:** Reveals trade-offs between feasibility, desirability, and viability
+**Pattern:** constraints → trade-offs → balanced solution
+**Best for:** Product strategy, startup news, enterprise decisions
+
+### 7. Mentor and Apprentice
+**Use:** Surfaces hidden assumptions through teaching
+**Pattern:** explanation → questions → deeper understanding
+**Best for:** Complex technical topics, explaining to broader audience
+
+### 8. Good Cop Bad Cop
+**Use:** Finding both strengths to build on and weaknesses to address
+**Pattern:** encouragement → criticism → balanced view
+**Best for:** Evaluating new products, company strategies, market moves
+
+### 9. Improv Yes-And
+**Use:** Generates unexpected creative directions
+**Pattern:** idea → build → build → surprising result
+**Best for:** Brainstorming implications, creative applications
+
+### 10. Customer Support Theater
+**Use:** Reveals real user frustrations and service gaps
+**Pattern:** complaint → investigation → resolution → prevention
+**Best for:** Service disruptions, product failures, consumer complaints
+
+---
+
+## ADVANCED REASONING METHODS
+
+### 11. Tree of Thoughts
+**Use:** Complex problems with multiple valid approaches
+**Pattern:** paths → evaluation → selection
+**Best for:** Strategic decisions, multi-factor analysis
+
+### 12. Graph of Thoughts
+**Use:** Systems thinking, discovering emergent patterns
+**Pattern:** nodes → connections → patterns
+**Best for:** Interconnected trends, ecosystem analysis
+
+### 13. Thread of Thought
+**Use:** Maintaining coherent reasoning across long contexts
+**Pattern:** context → thread → synthesis
+**Best for:** Long-form analysis, connecting multiple sources
+
+### 14. Self-Consistency Validation
+**Use:** High-stakes decisions where verification matters
+**Pattern:** approaches → comparison → consensus
+**Best for:** Fact-checking, verifying claims, critical analysis
+
+### 15. Meta-Prompting Analysis
+**Use:** Optimizing approach and methodology
+**Pattern:** current → analysis → optimization
+**Best for:** Improving analysis quality, methodology review
+
+### 16. Reasoning via Planning
+**Use:** Strategic planning, sequential decision-making
+**Pattern:** model → planning → strategy
+**Best for:** Future predictions, roadmap analysis
+
+---
+
+## COMPETITIVE ANALYSIS METHODS
+
+### 17. Red Team vs Blue Team
+**Use:** Finding vulnerabilities, building robust solutions
+**Pattern:** defense → attack → hardening
+**Best for:** Security news, risk assessment, competitive threats
+
+### 18. Shark Tank Pitch
+**Use:** Stress-testing business viability, clarifying value proposition
+**Pattern:** pitch → challenges → refinement
+**Best for:** Startup news, funding announcements, business models
+
+### 19. Code Review Gauntlet
+**Use:** Finding consensus on best practices
+**Pattern:** reviews → debates → standards
+**Best for:** Technical standards, methodology debates
+
+---
+
+## TECHNICAL ANALYSIS METHODS
+
+### 20. Architecture Decision Records
+**Use:** Ensures decisions are well-reasoned and documented
+**Pattern:** options → trade-offs → decision → rationale
+**Best for:** Technical decisions, platform choices, infrastructure
+
+### 21. Rubber Duck Debugging Evolved
+**Use:** Forces clarity at multiple abstraction levels
+**Pattern:** simple → detailed → technical → aha
+**Best for:** Understanding complex systems, debugging claims
+
+### 22. Algorithm Olympics
+**Use:** Finding optimal solution through direct comparison
+**Pattern:** implementations → benchmarks → winner
+**Best for:** Technology comparisons, performance claims
+
+### 23. Security Audit Personas
+**Use:** Comprehensive security review from multiple angles
+**Pattern:** vulnerabilities → defenses → compliance
+**Best for:** Security incidents, data breaches, privacy news
+
+### 24. Performance Profiler Panel
+**Use:** Finding bottlenecks across the full stack
+**Pattern:** symptoms → analysis → optimizations
+**Best for:** Performance issues, scaling challenges
+
+---
+
+## CREATIVE METHODS
+
+### 25. SCAMPER Method
+**Use:** Systematic ideation for product innovation
+**Pattern:** Substitute → Combine → Adapt → Modify → Put → Eliminate → Reverse
+**Best for:** Innovation opportunities, product evolution
+
+### 26. Reverse Engineering
+**Use:** Understanding endpoints, goal achievement
+**Pattern:** end state → steps backward → path forward
+**Best for:** Understanding strategy, competitive analysis
+
+### 27. What If Scenarios
+**Use:** Contingency planning, exploring possibilities
+**Pattern:** scenarios → implications → insights
+**Best for:** Future projections, risk scenarios
+
+### 28. Random Input Stimulus
+**Use:** Breaking creative blocks through lateral thinking
+**Pattern:** random word → associations → novel ideas
+**Best for:** Finding unexpected angles, creative analysis
+
+### 29. Exquisite Corpse Brainstorm
+**Use:** Generates surprising combinations
+**Pattern:** contribution → handoff → contribution → surprise
+**Best for:** Creative synthesis, unexpected connections
+
+### 30. Genre Mashup
+**Use:** Innovation through cross-pollination
+**Pattern:** domain A + domain B → hybrid insights
+**Best for:** Cross-industry analysis, convergence trends
+
+---
+
+## RESEARCH METHODS
+
+### 31. Literature Review Personas
+**Use:** Balanced assessment of evidence quality
+**Pattern:** sources → critiques → synthesis
+**Best for:** Research news, scientific claims, study analysis
+
+### 32. Thesis Defense Simulation
+**Use:** Stress-testing methodology and conclusions
+**Pattern:** thesis → challenges → defense → refinements
+**Best for:** Validating claims, challenging assumptions
+
+### 33. Comparative Analysis Matrix
+**Use:** Structured decision-making with explicit scoring
+**Pattern:** options → criteria → scores → recommendation
+**Best for:** Product comparisons, market analysis
+
+---
+
+## RISK ANALYSIS METHODS
+
+### 34. Pre-mortem Analysis
+**Use:** Risk mitigation before major launches
+**Pattern:** failure scenario → causes → prevention
+**Best for:** Launch risks, project failures, market entry
+
+### 35. Failure Mode Analysis
+**Use:** Reliability engineering, safety-critical systems
+**Pattern:** components → failures → prevention
+**Best for:** Technical failures, system risks
+
+### 36. Challenge from Critical Perspective
+**Use:** Overcoming groupthink, stress-testing ideas
+**Pattern:** assumptions → challenges → strengthening
+**Best for:** Challenging narratives, finding weaknesses
+
+### 37. Identify Potential Risks
+**Use:** Project planning, deployment preparation
+**Pattern:** categories → risks → mitigations
+**Best for:** Risk assessment, due diligence
+
+### 38. Chaos Monkey Scenarios
+**Use:** Testing resilience and recovery
+**Pattern:** break → observe → harden
+**Best for:** System reliability, disaster planning
+
+---
+
+## CORE ANALYTICAL METHODS
+
+### 39. First Principles Analysis
+**Use:** Breakthrough technique for innovation, solving impossible problems
+**Pattern:** assumptions → truths → new approach
+**Best for:** Paradigm shifts, fundamental changes
+
+### 40. 5 Whys Deep Dive
+**Use:** Understanding failures, drilling to root causes
+**Pattern:** why chain → root cause → solution
+**Best for:** Incident analysis, understanding causes
+
+### 41. Socratic Questioning
+**Use:** Revealing hidden assumptions, guiding discovery
+**Pattern:** questions → revelations → understanding
+**Best for:** Deep analysis, challenging claims
+
+### 42. Critique and Refine
+**Use:** Quality check for drafts and analysis
+**Pattern:** strengths/weaknesses → improvements → refined
+**Best for:** Iterating on analysis, improving quality
+
+### 43. Explain Reasoning
+**Use:** Transparency, showing how conclusions reached
+**Pattern:** steps → logic → conclusion
+**Best for:** Building trust, clear communication
+
+### 44. Expand or Contract for Audience
+**Use:** Matching content to reader capabilities
+**Pattern:** audience → adjustments → refined content
+**Best for:** Adapting analysis depth, targeting audience
+
+---
+
+## LEARNING METHODS
+
+### 45. Feynman Technique
+**Use:** Testing true understanding
+**Pattern:** complex → simple → gaps → mastery
+**Best for:** Explaining complex topics simply
+
+### 46. Active Recall Testing
+**Use:** Identifying knowledge gaps
+**Pattern:** test → gaps → reinforcement
+**Best for:** Verifying understanding, fact-checking
+
+---
+
+## PHILOSOPHICAL METHODS
+
+### 47. Occam's Razor Application
+**Use:** Finding simplest sufficient explanation
+**Pattern:** options → simplification → selection
+**Best for:** Cutting through complexity, debugging narratives
+
+### 48. Trolley Problem Variations
+**Use:** Understanding values through moral dilemmas
+**Pattern:** dilemma → analysis → decision
+**Best for:** Ethical analysis, value trade-offs
+
+---
+
+## RETROSPECTIVE METHODS
+
+### 49. Hindsight Reflection
+**Use:** Gaining perspective from imagined future
+**Pattern:** future view → insights → application
+**Best for:** Strategic analysis, project reviews
+
+### 50. Lessons Learned Extraction
+**Use:** Continuous improvement, actionable takeaways
+**Pattern:** experience → lessons → actions
+**Best for:** Post-incident analysis, learning from events
+
+---
+
+## Method Selection Quick Guide
+
+| Analysis Need | Top 3 Methods |
+|---------------|---------------|
+| Understanding root cause | 5 Whys, First Principles, Socratic |
+| Predicting future impact | Time Traveler, What If, Pre-mortem |
+| Finding risks/weaknesses | Red Team, Failure Mode, Devil's Advocate |
+| Multiple stakeholder views | Stakeholder Round Table, Debate Club, Expert Panel |
+| Innovation opportunities | SCAMPER, Genre Mashup, Reverse Engineering |
+| Validating claims | Self-Consistency, Thesis Defense, Literature Review |
+| Complex system analysis | Graph of Thoughts, Tree of Thoughts, Cross-Functional |
+| Consumer behavior | User Persona, Customer Support, Good Cop Bad Cop |

package/skills/skills/coolhunter/references/workflow-execution.md

@@ -0,0 +1,238 @@
+# Coolhunter Workflow Execution Reference
+
+## Table of Contents
+- [Complete Execution Flow](#complete-execution-flow)
+  - [STEP 1: Receive Request](#step-1-receive-request)
+  - [STEP 2: Web Research Execution](#step-2-web-research-execution)
+  - [STEP 3: Elicitation Method Selection](#step-3-elicitation-method-selection)
+  - [STEP 4: Report Generation](#step-4-report-generation)
+  - [STEP 5: File Output Execution](#step-5-file-output-execution)
+- [Quality Assurance Checklist](#quality-assurance-checklist)
+- [Error Handling](#error-handling)
+
+---
+
+## Complete Execution Flow
+
+### STEP 1: Receive Request
+
+**Input Processing:**
+```
+USER: "Coolhunt [topic]" / "What's trending in [topic]"
+
+COOLHUNTER responds:
+"🔍 Coolhunting: [topic]
+Scanning latest developments in the last 48 hours..."
+```
+
+**Topic Normalization:**
+- Extract core topic keywords
+- Identify subtopics for deeper search
+- Note any specific angle requested
+
+---
+
+### STEP 2: Web Research Execution
+
+**Search Sequence:**
+```bash
+# Primary search (most recent)
+web_search: "[topic] news today"
+
+# Context search
+web_search: "[topic] latest developments 2025"
+
+# Trend search  
+web_search: "[topic] emerging trend"
+
+# Optional: subtopic deep dive
+web_search: "[topic] [specific aspect] news"
+```
+
+**Source Evaluation Checklist:**
+- [ ] Is source reputable? (major publication, verified outlet)
+- [ ] Is content within 48 hours? (prefer <24h)
+- [ ] Is it original reporting or aggregation?
+- [ ] Are claims attributed to named sources?
+
+**Signal Extraction Template:**
+```markdown
+### Source: [Publication Name]
+**URL:** [link]
+**Published:** [date/time]
+
+**Primary Signal:**
+[What's the core change/event?]
+
+**Key Players:**
+[Who is involved/affected?]
+
+**Timeline:**
+[When did this emerge? Speed of development?]
+
+**Quote/Evidence:**
+[Key supporting quote or data point]
+```
+
+---
+
+### STEP 3: Elicitation Method Selection
+
+**Context Scoring:**
+```
+Rate 1-5 for each dimension:
+
+Complexity:     [1=simple, 5=multi-faceted]
+Stakeholders:   [1=single group, 5=many groups]
+Risk Level:     [1=low impact, 5=high stakes]
+Novelty:        [1=incremental, 5=paradigm shift]
+Controversy:    [1=consensus, 5=polarizing]
+```
+
+**Method Selection Matrix:**
+
+| Score Profile | Recommended Methods |
+|---------------|---------------------|
+| High complexity + high stakeholders | Stakeholder Round Table, Graph of Thoughts |
+| High risk + any novelty | Pre-mortem, Red Team vs Blue Team |
+| High novelty + low controversy | First Principles, SCAMPER, What If |
+| High controversy + any | Debate Club Showdown, Self-Consistency |
+| Low complexity + consumer focus | User Persona Focus Group, 5 Whys |
+
+**Method Application Template:**
+```markdown
+## Analysis: [Method Name]
+
+### Why This Method
+[1-2 sentences on why selected for this news]
+
+### Application
+
+[Execute the method's pattern on the news content]
+
+### Insights Derived
+1. [Key insight]
+2. [Key insight]  
+3. [Key insight]
+
+### Behavioral Implications
+- **Consumer:** [How behavior may shift]
+- **Cultural:** [Broader meaning]
+- **Tech:** [Adoption implications]
+```
+
+---
+
+### STEP 4: Report Generation
+
+**Headline Creation Guidelines:**
+- NOT a copy of source headline
+- Coolhunter's interpretation of the signal
+- Focus on implication, not event
+- Format: [Action] + [Subject] + [Implication]
+
+**Examples:**
+- Source: "Apple announces new AI features"
+- Coolhunter: "Apple's AI Pivot Signals End of Privacy-First Era"
+
+- Source: "Bitcoin hits $100k"
+- Coolhunter: "Six-Figure Bitcoin Normalizes Crypto as Asset Class"
+
+**Fact-Check Protocol:**
+```markdown
+| Claim | Status | Verification |
+|-------|--------|--------------|
+| [Specific claim from news] | ✅/⚠️/❌ | [How verified + source] |
+```
+
+**Status Guide:**
+- ✅ Verified: Multiple reputable sources confirm
+- ⚠️ Partial: Some evidence, needs caveats
+- ❌ Unverified: Cannot confirm, single source only
+
+**Confidence Levels:**
+- **High:** 3+ independent sources, official confirmation
+- **Medium:** 2 sources, plausible but limited confirmation
+- **Low:** Single source, speculation, unnamed sources
+
+---
+
+### STEP 5: File Output Execution
+
+**Directory Creation:**
+```bash
+DATETIME=$(date +%Y-%m-%d-%H%M)
+mkdir -p coolhunter-output/report-$DATETIME
+```
+
+**Slug Generation Rules:**
+1. Take Coolhunter headline
+2. Lowercase all characters
+3. Replace spaces with hyphens
+4. Remove punctuation except hyphens
+5. Truncate to 50 characters max
+6. Remove trailing hyphens
+
+**Example:**
+```
+Headline: "Apple's AI Pivot Signals End of Privacy-First Era"
+Slug: "apples-ai-pivot-signals-end-of-privacy-first-era"
+```
+
+**Final Save:**
+```bash
+cat > "coolhunter-output/report-$DATETIME/$SLUG.md" << 'EOF'
+[Full report content]
+EOF
+```
+
+---
+
+## Quality Assurance Checklist
+
+Before presenting output:
+
+### Content Quality
+- [ ] Headline is original interpretation, not copy
+- [ ] Summary explains what + why + who
+- [ ] At least 2 sources cited with URLs
+- [ ] Fact-check table has verified claims
+- [ ] Behavioral analysis covers consumer + cultural + tech
+
+### Analysis Quality  
+- [ ] Selected method matches news context
+- [ ] Method properly applied (followed pattern)
+- [ ] Insights are actionable, not generic
+- [ ] Pre-mainstream indicators identified
+
+### Output Quality
+- [ ] File saved to correct path
+- [ ] Slug follows naming convention
+- [ ] Markdown renders correctly
+- [ ] All links are valid
+
+---
+
+## Error Handling
+
+**No recent news found:**
+```
+"🔍 Limited recent coverage for [topic].
+Expanding search to past 7 days...
+[Continue with broader search]"
+```
+
+**Conflicting sources:**
+```
+"⚠️ Sources report conflicting information:
+- [Source A] says: [claim]
+- [Source B] says: [claim]
+Analysis will note this uncertainty."
+```
+
+**Single source only:**
+```
+"⚠️ Only one source found. 
+Confidence level: Low
+Recommend monitoring for confirmation."
+```