cmp-standards 2.7.0 → 2.8.0-alpha

package/templates/workflows/business-improvement.md

@@ -1,264 +1,264 @@
----
-description: "/business-improvement - Self-improving research system that enhances business documents through web research"
----
-
-# /business-improvement - Self-Improving Research System
-
-> **Purpose**: Continuously improve business knowledge base through iterative web research
-> **Philosophy**: Research -> Learn -> Document -> Generate Follow-ups -> Repeat
-
----
-
-## Overview
-
-The `/business-improvement` command is a **self-improving research engine** that:
-
-1. **Researches** - Executes web searches on business/marketing topics
-2. **Learns** - Extracts key insights and facts from results
-3. **Documents** - Updates or creates files with new knowledge
-4. **Generates** - Produces derived queries for next research cycle
-5. **Tracks** - Logs every search, learning, and improvement for meta-analysis
-
----
-
-## Execution Protocol
-
-### Phase 1: Pre-Research Analysis
-
-1. **Review current knowledge state**
-   - Check existing business documentation
-   - Identify knowledge gaps and stale content
-
-2. **Identify improvement opportunities**
-   - Review documents for incomplete sections
-   - Check dates of last updates (stale content = improvement opportunity)
-   - Identify documents with completeness < 80%
-
-3. **Select focus area** based on priority:
-   | Priority | Topic Area | Documents |
-   |:---|:---|:---|
-   | HIGH | Strategic | Business Plan, SWOT, Value Proposition |
-   | MEDIUM | Market Intel | Competitor Analysis, Market Trends |
-   | LOW | Campaign | Content Pillars, Messaging Framework |
-
----
-
-### Phase 2: Research Execution
-
-4. **Initial Research Query**
-   - Start with a focused, specific query related to the focus area
-   - Example: `"[industry] management software trends [year]"`
-
-5. **Execute web search**
-   - Use WebSearch tool with focused query
-   - Capture top 5-7 results
-
-6. **Extract Knowledge**
-   For each search result, extract:
-   ```json
-   {
-     "query": "original search query",
-     "source": "URL of the source",
-     "learnings": [
-       "Key fact or insight 1",
-       "Key fact or insight 2"
-     ],
-     "confidence": 85,
-     "derivedQueries": [
-       "Follow-up query based on learning 1",
-       "Follow-up query based on learning 2"
-     ]
-   }
-   ```
-
-7. **Log to Research Tracker**
-   - Track: Query -> Results -> Learnings -> Follow-ups
-
----
-
-### Phase 3: Knowledge Integration
-
-8. **Update existing documents** (PREFERRED)
-   - If learning fits existing document section -> enhance it
-   - Add new data points, statistics, competitor info
-   - Update timestamps
-
-9. **Create new section** (if appropriate)
-   - Only if learning reveals entirely new topic area
-   - Must be extremely relevant to the business
-
-10. **Format documents beautifully**
-    - Use structured markdown for visual appeal
-    - Include tables for comparative data
-    - Use H1/H2/H3, lists, quotes
-    - Add emojis sparingly for scanability
-
----
-
-### Phase 4: Session Documentation
-
-11. **Create Research Session Report**
-    ```json
-    {
-      "sessionId": "ULID",
-      "date": "YYYY-MM-DD",
-      "topic": "Research Focus Area",
-      "queriesExecuted": 5,
-      "learningsAcquired": 12,
-      "documentsUpdated": ["value_proposition", "swot"],
-      "derivedQueriesPending": [
-        "Follow-up query 1",
-        "Follow-up query 2"
-      ],
-      "nextSessionPriority": "HIGH"
-    }
-    ```
-
-12. **Update task tracker**
-    - Mark improvements in task list
-    - Add new items for pending derived queries
-
----
-
-## Research Query Framework
-
-### Query Templates by Topic
-
-**Competitor Analysis:**
-- `"[Competitor] pricing [year]"`
-- `"[Competitor] features comparison"`
-- `"[Competitor] customer reviews [year]"`
-
-**Market Trends:**
-- `"[industry] market size [year]"`
-- `"[industry] software trends"`
-- `"B2B SaaS [industry]"`
-
-**Audience Research:**
-- `"[target audience] pain points"`
-- `"[industry] software needs"`
-- `"[user type] app features"`
-
-**Product Positioning:**
-- `"all-in-one [industry] management"`
-- `"[product type] software comparison"`
-- `"[industry] operations automation"`
-
----
-
-## Expert Review Integration
-
-After completing research, invoke `/experts` for validation:
-
-- **Security Expert**: No sensitive data exposed
-- **Architecture Expert**: Document structure valid
-- **UX Expert**: Content follows brand voice
-- **Memory Expert**: Patterns detected, auto-improvements triggered
-
----
-
-## Document Quality Standards
-
-### Visual Format Requirements
-
-Every document must have:
-- Clear H1 title
-- Executive summary (2-3 sentences)
-- Structured sections with H2/H3
-- Tables for comparative data
-- Bullet lists for quick scanning
-- Timestamps (created/updated)
-- Source citations where applicable
-
-### Content Quality Checks
-- No placeholder text ("lorem ipsum", "TBD")
-- No outdated data (> 6 months old)
-- No unsupported claims
-- Specific numbers and dates
-- Competitor names and products
-- Actionable insights
-
----
-
-## Example Session Output
-
-```
-## Business Improvement Session
-
-Date: YYYY-MM-DD
-Focus: Competitor Pricing Update
-
-### Queries Executed
-1. "[Competitor A] pricing model [year]" -> 3 learnings
-2. "[Competitor B] subscription tiers" -> 2 learnings
-3. "[Competitor A] vs [Competitor B]" -> 4 learnings
-
-### Knowledge Acquired
-- Competitor A uses flat monthly fee (no commission)
-- Competitor B: $99-499/month based on usage
-- Competitor C: Legacy pricing, higher cost
-- Market trend: Moving away from per-transaction %
-
-### Documents Updated
-- Value Proposition Canvas - Added competitive pricing section
-- SWOT Analysis - Updated threats with pricing pressure
-
-### Derived Queries (Next Session)
-- "[Competitor A] API capabilities"
-- "[Industry] software free trial comparison"
-- "[Market segment] market share [year]"
-
-### Session Score: 4/5
-Learnings: 9 | Documents: 2 | Next queries: 3
-```
-
----
-
-## Automation Hooks
-
-### Recommended Schedule
-- **Weekly**: Run basic improvement cycle (1 focus area)
-- **Monthly**: Deep dive on all priority areas
-- **Quarterly**: Full competitive landscape refresh
-
-### Integration with CLI
-```bash
-# Future enhancement
-cmp-memory improve --topic "competitors"
-cmp-memory improve --pending  # Process derived queries
-cmp-memory improve --status   # Show improvement metrics
-```
-
----
-
-## Success Metrics
-
-The system is working correctly if:
-
-- **Query coverage** - All topic areas researched quarterly
-- **Learning rate** - 5+ new insights per session
-- **Document freshness** - No content older than 3 months
-- **Derived query backlog** - Always have next topics ready
-- **Pattern detection** - Memory Expert finds recurring themes
-
----
-
-## When to Use /business-improvement
-
-### Use When:
-- Need to update market intelligence
-- Competitor released new features/pricing
-- Preparing for investor/client presentations
-- Monthly knowledge refresh cycle
-- After major product launch by competitor
-
-### Don't Use For:
-- Quick fact-checking (use direct web search)
-- Creating new documents from scratch (use `/experts implement`)
-- Trivial content updates (edit directly)
-
----
-
-The `/business-improvement` command transforms your business knowledge base into a **living, self-improving system**. Each research session makes the next one more targeted through derived queries.
-
-**Pro tip**: Run `/business-improvement` weekly on rotating topics to maintain fresh, competitive intelligence.
+---
+description: "/business-improvement - Self-improving research system that enhances business documents through web research"
+---
+
+# /business-improvement - Self-Improving Research System
+
+> **Purpose**: Continuously improve business knowledge base through iterative web research
+> **Philosophy**: Research -> Learn -> Document -> Generate Follow-ups -> Repeat
+
+---
+
+## Overview
+
+The `/business-improvement` command is a **self-improving research engine** that:
+
+1. **Researches** - Executes web searches on business/marketing topics
+2. **Learns** - Extracts key insights and facts from results
+3. **Documents** - Updates or creates files with new knowledge
+4. **Generates** - Produces derived queries for next research cycle
+5. **Tracks** - Logs every search, learning, and improvement for meta-analysis
+
+---
+
+## Execution Protocol
+
+### Phase 1: Pre-Research Analysis
+
+1. **Review current knowledge state**
+   - Check existing business documentation
+   - Identify knowledge gaps and stale content
+
+2. **Identify improvement opportunities**
+   - Review documents for incomplete sections
+   - Check dates of last updates (stale content = improvement opportunity)
+   - Identify documents with completeness < 80%
+
+3. **Select focus area** based on priority:
+   | Priority | Topic Area | Documents |
+   |:---|:---|:---|
+   | HIGH | Strategic | Business Plan, SWOT, Value Proposition |
+   | MEDIUM | Market Intel | Competitor Analysis, Market Trends |
+   | LOW | Campaign | Content Pillars, Messaging Framework |
+
+---
+
+### Phase 2: Research Execution
+
+4. **Initial Research Query**
+   - Start with a focused, specific query related to the focus area
+   - Example: `"[industry] management software trends [year]"`
+
+5. **Execute web search**
+   - Use WebSearch tool with focused query
+   - Capture top 5-7 results
+
+6. **Extract Knowledge**
+   For each search result, extract:
+   ```json
+   {
+     "query": "original search query",
+     "source": "URL of the source",
+     "learnings": [
+       "Key fact or insight 1",
+       "Key fact or insight 2"
+     ],
+     "confidence": 85,
+     "derivedQueries": [
+       "Follow-up query based on learning 1",
+       "Follow-up query based on learning 2"
+     ]
+   }
+   ```
+
+7. **Log to Research Tracker**
+   - Track: Query -> Results -> Learnings -> Follow-ups
+
+---
+
+### Phase 3: Knowledge Integration
+
+8. **Update existing documents** (PREFERRED)
+   - If learning fits existing document section -> enhance it
+   - Add new data points, statistics, competitor info
+   - Update timestamps
+
+9. **Create new section** (if appropriate)
+   - Only if learning reveals entirely new topic area
+   - Must be extremely relevant to the business
+
+10. **Format documents beautifully**
+    - Use structured markdown for visual appeal
+    - Include tables for comparative data
+    - Use H1/H2/H3, lists, quotes
+    - Add emojis sparingly for scanability
+
+---
+
+### Phase 4: Session Documentation
+
+11. **Create Research Session Report**
+    ```json
+    {
+      "sessionId": "ULID",
+      "date": "YYYY-MM-DD",
+      "topic": "Research Focus Area",
+      "queriesExecuted": 5,
+      "learningsAcquired": 12,
+      "documentsUpdated": ["value_proposition", "swot"],
+      "derivedQueriesPending": [
+        "Follow-up query 1",
+        "Follow-up query 2"
+      ],
+      "nextSessionPriority": "HIGH"
+    }
+    ```
+
+12. **Update task tracker**
+    - Mark improvements in task list
+    - Add new items for pending derived queries
+
+---
+
+## Research Query Framework
+
+### Query Templates by Topic
+
+**Competitor Analysis:**
+- `"[Competitor] pricing [year]"`
+- `"[Competitor] features comparison"`
+- `"[Competitor] customer reviews [year]"`
+
+**Market Trends:**
+- `"[industry] market size [year]"`
+- `"[industry] software trends"`
+- `"B2B SaaS [industry]"`
+
+**Audience Research:**
+- `"[target audience] pain points"`
+- `"[industry] software needs"`
+- `"[user type] app features"`
+
+**Product Positioning:**
+- `"all-in-one [industry] management"`
+- `"[product type] software comparison"`
+- `"[industry] operations automation"`
+
+---
+
+## Expert Review Integration
+
+After completing research, invoke `/experts` for validation:
+
+- **Security Expert**: No sensitive data exposed
+- **Architecture Expert**: Document structure valid
+- **UX Expert**: Content follows brand voice
+- **Memory Expert**: Patterns detected, auto-improvements triggered
+
+---
+
+## Document Quality Standards
+
+### Visual Format Requirements
+
+Every document must have:
+- Clear H1 title
+- Executive summary (2-3 sentences)
+- Structured sections with H2/H3
+- Tables for comparative data
+- Bullet lists for quick scanning
+- Timestamps (created/updated)
+- Source citations where applicable
+
+### Content Quality Checks
+- No placeholder text ("lorem ipsum", "TBD")
+- No outdated data (> 6 months old)
+- No unsupported claims
+- Specific numbers and dates
+- Competitor names and products
+- Actionable insights
+
+---
+
+## Example Session Output
+
+```
+## Business Improvement Session
+
+Date: YYYY-MM-DD
+Focus: Competitor Pricing Update
+
+### Queries Executed
+1. "[Competitor A] pricing model [year]" -> 3 learnings
+2. "[Competitor B] subscription tiers" -> 2 learnings
+3. "[Competitor A] vs [Competitor B]" -> 4 learnings
+
+### Knowledge Acquired
+- Competitor A uses flat monthly fee (no commission)
+- Competitor B: $99-499/month based on usage
+- Competitor C: Legacy pricing, higher cost
+- Market trend: Moving away from per-transaction %
+
+### Documents Updated
+- Value Proposition Canvas - Added competitive pricing section
+- SWOT Analysis - Updated threats with pricing pressure
+
+### Derived Queries (Next Session)
+- "[Competitor A] API capabilities"
+- "[Industry] software free trial comparison"
+- "[Market segment] market share [year]"
+
+### Session Score: 4/5
+Learnings: 9 | Documents: 2 | Next queries: 3
+```
+
+---
+
+## Automation Hooks
+
+### Recommended Schedule
+- **Weekly**: Run basic improvement cycle (1 focus area)
+- **Monthly**: Deep dive on all priority areas
+- **Quarterly**: Full competitive landscape refresh
+
+### Integration with CLI
+```bash
+# Future enhancement
+cmp-memory improve --topic "competitors"
+cmp-memory improve --pending  # Process derived queries
+cmp-memory improve --status   # Show improvement metrics
+```
+
+---
+
+## Success Metrics
+
+The system is working correctly if:
+
+- **Query coverage** - All topic areas researched quarterly
+- **Learning rate** - 5+ new insights per session
+- **Document freshness** - No content older than 3 months
+- **Derived query backlog** - Always have next topics ready
+- **Pattern detection** - Memory Expert finds recurring themes
+
+---
+
+## When to Use /business-improvement
+
+### Use When:
+- Need to update market intelligence
+- Competitor released new features/pricing
+- Preparing for investor/client presentations
+- Monthly knowledge refresh cycle
+- After major product launch by competitor
+
+### Don't Use For:
+- Quick fact-checking (use direct web search)
+- Creating new documents from scratch (use `/experts implement`)
+- Trivial content updates (edit directly)
+
+---
+
+The `/business-improvement` command transforms your business knowledge base into a **living, self-improving system**. Each research session makes the next one more targeted through derived queries.
+
+**Pro tip**: Run `/business-improvement` weekly on rotating topics to maintain fresh, competitive intelligence.