ai-qakit 1.0.0

package/templates/.claude/commands/qakit/kb/list.md

@@ -0,0 +1,185 @@
+# List Knowledge Base Contents
+
+List all documents, rules, and sources in the knowledge base.
+
+## Usage
+
+```
+/qakit:kb/list
+/qakit:kb/list --type=features
+/qakit:kb/list --type=rules
+/qakit:kb/list --recent
+```
+
+## Instructions
+
+### Step 1: Check KB Exists
+
+```bash
+if [ ! -d "docs" ] || [ ! -f "docs/_index.md" ]; then
+  echo "Knowledge base not found. Run /qakit:kb/init first."
+  exit 1
+fi
+```
+
+### Step 2: Gather Statistics
+
+```bash
+# Count features
+FEATURES=$(ls docs/features/*.md 2>/dev/null | wc -l)
+
+# Count rules
+RULES=$(grep -h "^| BR-" docs/features/*.md docs/rules/*.md 2>/dev/null | wc -l)
+
+# Count flows
+FLOWS=$(ls docs/flows/*.md 2>/dev/null | wc -l)
+
+# Count sources
+SOURCES=$(jq '.sources | length' docs/_sources.json)
+
+# Count conflicts
+CONFLICTS=$(jq '.conflicts | map(select(.status == "pending")) | length' docs/_sources.json)
+
+# Count designs
+DESIGNS=$(ls docs/assets/screenshots/*.png docs/assets/designs/* 2>/dev/null | wc -l)
+```
+
+### Step 3: Output Listing
+
+```markdown
+# Knowledge Base Overview
+
+**Location:** docs/
+**Last Updated:** {timestamp from _index.md}
+
+---
+
+## Statistics
+
+| Type | Count | Status |
+|------|-------|--------|
+| Features | {n} | ✅ |
+| Business Rules | {n} | ✅ |
+| Flows | {n} | ✅ |
+| Sources | {n} | ✅ |
+| Designs | {n} | ✅ |
+| Conflicts | {n} | {⚠️ if > 0} |
+
+---
+
+## Features ({count})
+
+| Feature | Title | Sources | Rules | Status |
+|---------|-------|---------|-------|--------|
+| [[maps-resource-toggle]] | Maps Resource Toggle | LG-4018 | 5 | Active |
+| [[docket-management]] | Docket Management | LG-4020, PRD-100 | 8 | Active |
+| [[resource-panel]] | Resource Panel | LG-4025 | 3 | Active |
+
+---
+
+## Business Rules ({count})
+
+### Shared Rules
+| ID | Rule | Used By | Sources |
+|----|------|---------|---------|
+| BR-SHARED-001 | Panel opens on replay | 3 features | LG-4018, LG-4020 |
+| BR-SHARED-002 | Close button behavior | 2 features | LG-4018, LG-4025 |
+
+### Feature-Specific Rules
+| ID | Rule | Feature | Source |
+|----|------|---------|--------|
+| BR-001 | Filter by docket type | maps-resource-toggle | LG-4018 |
+| BR-002 | Show loading state | maps-resource-toggle | LG-4018 |
+
+---
+
+## Flows ({count})
+
+| Flow | Title | Used By |
+|------|-------|---------|
+| [[docket-replay]] | Docket Replay Flow | 3 features |
+| [[user-login]] | User Login Flow | 2 features |
+
+---
+
+## Sources ({count})
+
+| ID | Type | Title | Linked Docs | Captured |
+|----|------|-------|-------------|----------|
+| LG-4018 | Jira | Maps Resource Toggle | 1 | 2024-12-24 |
+| LG-4020 | Jira | Docket Management | 1 | 2024-12-24 |
+| PRD-100 | Confluence | Product Requirements | 2 | 2024-12-23 |
+| design-001 | Design | Panel mockup | 1 | 2024-12-24 |
+
+---
+
+## Pending Actions
+
+### Conflicts ({count})
+| ID | Rule | Features | Status |
+|----|------|----------|--------|
+| CONF-001 | BR-002 | maps-resource-toggle | ⚠️ Pending |
+
+→ Run `/qakit:kb/resolve` to resolve
+
+### Missing
+- 2 features have no designs
+- 1 feature has no flows documented
+
+---
+
+## Quick Commands
+
+```bash
+# View feature
+cat docs/features/maps-resource-toggle.md
+
+# Search
+/qakit:kb/search "resource panel"
+
+# Add new
+/qakit:kb/capture LG-NEW
+
+# Resolve conflicts
+/qakit:kb/resolve
+
+# Check duplicates
+/qakit:kb/dedupe --check
+```
+```
+
+## Filter Options
+
+### By Type
+```bash
+/qakit:kb/list --type=features   # Only features
+/qakit:kb/list --type=rules      # Only rules
+/qakit:kb/list --type=flows      # Only flows
+/qakit:kb/list --type=sources    # Only sources
+/qakit:kb/list --type=designs    # Only designs
+```
+
+### By Status
+```bash
+/qakit:kb/list --status=active      # Active docs
+/qakit:kb/list --status=conflict    # Docs with conflicts
+/qakit:kb/list --status=draft       # Draft docs
+```
+
+### Recent
+```bash
+/qakit:kb/list --recent          # Last 10 updated
+/qakit:kb/list --recent=20       # Last 20 updated
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--type=TYPE` | Filter by type | all |
+| `--status=STATUS` | Filter by status | all |
+| `--recent[=N]` | Show recent updates | 10 |
+| `--json` | Output as JSON | false |
+| `--verbose` | Show full details | false |
+
+$ARGUMENTS

package/templates/.claude/commands/qakit/kb/resolve.md

@@ -0,0 +1,234 @@
+# Resolve Knowledge Base Conflicts
+
+Resolve conflicts between business rules from different sources.
+
+## Usage
+
+```
+/qakit:kb/resolve
+/qakit:kb/resolve maps-resource-toggle
+/qakit:kb/resolve --conflict=CONF-001
+```
+
+## Instructions
+
+### Step 1: Find Conflicts
+
+**List all conflicts:**
+```bash
+# From sources registry
+jq -r '.conflicts[] | select(.status == "pending")' docs/_sources.json
+
+# From feature docs (marked with ⚠️)
+grep -r "⚠️ Conflict" docs/features/*.md
+```
+
+### Step 2: Display Conflict Details
+
+For each conflict:
+
+```markdown
+## ⚠️ Conflict: CONF-001
+
+**Rule:** BR-002 - Panel close behavior
+**Feature:** [[maps-resource-toggle]]
+**Status:** Pending resolution
+
+---
+
+### Source 1: LG-4018 (Jira)
+**Captured:** 2024-12-20
+**Says:**
+> Panel auto-closes after 30 seconds of inactivity
+
+**Context:**
+From acceptance criteria AC-003:
+"WHEN user is inactive for 30 seconds THEN panel should auto-close"
+
+---
+
+### Source 2: PRD-123 (Confluence)
+**Captured:** 2024-12-15
+**Says:**
+> Panel stays open until user explicitly closes it
+
+**Context:**
+From requirements section:
+"The resource panel shall remain open until the user clicks the close button or navigates away"
+
+---
+
+### Analysis
+
+| Aspect | Source 1 (Jira) | Source 2 (Confluence) |
+|--------|-----------------|----------------------|
+| Behavior | Auto-close | Manual close |
+| Trigger | 30s inactivity | User action |
+| Date | 2024-12-20 (newer) | 2024-12-15 (older) |
+| Type | Implementation ticket | PRD |
+
+**Potential reasons for conflict:**
+1. PRD is older, Jira may have updated requirement
+2. Different contexts (mobile vs desktop?)
+3. Miscommunication between PM and dev
+
+---
+
+### Resolution Options
+
+1. **Use Source 1 (Jira - newer)**
+   - Auto-close after 30 seconds
+   - Reason: More recent, implementation-level detail
+
+2. **Use Source 2 (Confluence - PRD)**
+   - Manual close only
+   - Reason: PRD is source of truth
+
+3. **Merge both**
+   - Auto-close after 30s OR manual close
+   - Reason: Both behaviors valid
+
+4. **Custom resolution**
+   - Specify your own rule
+
+5. **Needs clarification**
+   - Mark for PM/stakeholder review
+
+---
+
+**Select option (1-5):** _
+```
+
+### Step 3: Process Resolution
+
+**Option 1 or 2 - Use single source:**
+```markdown
+Resolution recorded:
+- **Decision:** Use Source 1 (LG-4018)
+- **Rule:** Panel auto-closes after 30 seconds
+- **Reason:** [User input or default: "Newer source, implementation detail"]
+- **Resolved by:** {current_user}
+- **Date:** {timestamp}
+```
+
+**Option 3 - Merge:**
+```markdown
+Resolution recorded:
+- **Decision:** Merged from both sources
+- **Rule:** Panel auto-closes after 30s of inactivity, or when user clicks close
+- **Reason:** Both behaviors are valid use cases
+- **Resolved by:** {current_user}
+- **Date:** {timestamp}
+```
+
+**Option 4 - Custom:**
+```markdown
+Enter custom rule:
+> [User input]
+
+Enter reason:
+> [User input]
+
+Resolution recorded:
+- **Decision:** Custom resolution
+- **Rule:** {user_input}
+- **Reason:** {user_reason}
+- **Resolved by:** {current_user}
+- **Date:** {timestamp}
+```
+
+**Option 5 - Needs clarification:**
+```markdown
+Resolution recorded:
+- **Decision:** Needs clarification
+- **Assigned to:** [PM/Stakeholder name]
+- **Question:** Which behavior is correct for panel close?
+- **Due:** {date + 3 days}
+- **Status:** Pending review
+```
+
+### Step 4: Update Documents
+
+**Update feature doc:**
+```markdown
+## Business Rules
+
+| ID | Rule | Sources | Status | Confidence |
+|----|------|---------|--------|------------|
+| BR-002 | Panel auto-closes after 30s or manual close | LG-4018, PRD-123 | ✅ Resolved | High |
+
+### Resolution History
+
+| Rule | Conflict | Resolution | Date | By |
+|------|----------|------------|------|-----|
+| BR-002 | LG-4018 vs PRD-123 | Merged: auto-close + manual | 2024-12-24 | hung.nguyen |
+```
+
+**Update _sources.json:**
+```json
+{
+  "conflicts": [
+    {
+      "id": "CONF-001",
+      "rules": ["BR-002"],
+      "sources": ["LG-4018", "PRD-123"],
+      "status": "resolved",
+      "resolution": {
+        "decision": "merged",
+        "rule": "Panel auto-closes after 30s or manual close",
+        "reason": "Both behaviors valid",
+        "resolvedBy": "hung.nguyen",
+        "resolvedAt": "2024-12-24T10:00:00Z"
+      }
+    }
+  ]
+}
+```
+
+### Step 5: Output Summary
+
+```markdown
+✅ Conflict Resolved
+
+## CONF-001: BR-002 - Panel close behavior
+
+**Decision:** Merged from both sources
+**New Rule:** Panel auto-closes after 30s of inactivity, or when user clicks close
+
+**Updated:**
+- docs/features/maps-resource-toggle.md
+- docs/_sources.json
+
+## Remaining Conflicts
+
+| ID | Rule | Feature | Status |
+|----|------|---------|--------|
+| CONF-002 | BR-005 | docket-management | Pending |
+
+Run `/qakit:kb/resolve` to resolve remaining conflicts.
+```
+
+## Batch Resolution
+
+```bash
+# Resolve all conflicts in a feature
+/qakit:kb/resolve maps-resource-toggle --all
+
+# Auto-resolve using newest source
+/qakit:kb/resolve --auto=newest
+
+# Auto-resolve using PRD as source of truth
+/qakit:kb/resolve --auto=prd
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--conflict=ID` | Resolve specific conflict | - |
+| `--all` | Resolve all conflicts in feature | false |
+| `--auto=STRATEGY` | Auto-resolve (newest/oldest/prd/jira) | - |
+| `--assign=USER` | Assign for review | - |
+| `--dry-run` | Preview without saving | false |
+
+$ARGUMENTS

package/templates/.claude/commands/qakit/kb/search.md

@@ -0,0 +1,202 @@
+# Search Knowledge Base
+
+Search the knowledge base for features, rules, flows, and documentation.
+
+## Usage
+
+```
+/qakit:kb/search "resource panel"
+/qakit:kb/search "resource panel" --type=rule
+/qakit:kb/search --tag=authentication
+/qakit:kb/search --source=LG-4018
+```
+
+## Instructions
+
+### Step 1: Parse Search Query
+
+```
+Query types:
+- Text search: "resource panel"
+- Tag search: --tag=authentication
+- Source search: --source=LG-4018
+- Type filter: --type=feature|rule|flow|design
+- Status filter: --status=active|conflict|deprecated
+```
+
+### Step 2: Search Documents
+
+**Text search across all docs:**
+```bash
+# Search in features
+grep -r -l -i "$QUERY" docs/features/*.md
+
+# Search in rules
+grep -r -l -i "$QUERY" docs/rules/*.md
+
+# Search in flows
+grep -r -l -i "$QUERY" docs/flows/*.md
+
+# Search in glossary
+grep -i "$QUERY" docs/_glossary.md
+```
+
+**Search by tag (from frontmatter):**
+```bash
+# Find docs with specific tag
+grep -l "tags:.*$TAG" docs/**/*.md
+```
+
+**Search by source:**
+```bash
+# Find docs linked to source
+jq -r ".sources[] | select(.id == \"$SOURCE_ID\") | .linkedDocs[]" docs/_sources.json
+```
+
+### Step 3: Rank Results
+
+**Ranking factors:**
+1. Title match (highest)
+2. Rule ID match
+3. Tag match
+4. Body text match
+5. Source reference match
+
+### Step 4: Extract Context
+
+For each match, extract:
+- Document title
+- Matching section/line
+- Surrounding context (2-3 lines)
+- Related documents
+
+### Step 5: Output Results
+
+```markdown
+# Search Results: "{query}"
+
+Found **{count}** matches in {time}ms
+
+---
+
+## Features ({count})
+
+### 1. [[maps-resource-toggle]] - Maps Resource Toggle
+**Match:** "Resources panel opens when docket replay starts"
+**Tags:** maps, resources, docket
+**Source:** LG-4018
+
+> ...the **resource panel** should automatically open when...
+
+---
+
+### 2. [[resource-panel]] - Resource Panel Component
+**Match:** "Resource panel behavior and states"
+**Tags:** ui, panel, resources
+
+> The **resource panel** displays linked resources for the current...
+
+---
+
+## Business Rules ({count})
+
+### BR-001 (maps-resource-toggle)
+**Rule:** Resources panel opens on docket replay
+**Status:** ✅ Active
+**Sources:** LG-4018, PRD-123
+
+### BR-015 (resource-panel)
+**Rule:** Panel closes when clicking outside
+**Status:** ✅ Active
+**Sources:** LG-4020
+
+---
+
+## Flows ({count})
+
+### [[flows/docket-replay]]
+**Match:** Step 3 - "Open resource panel"
+
+> 1. User clicks Replay
+> 2. System starts replay
+> 3. System opens **resource panel**
+> 4. ...
+
+---
+
+## Glossary ({count})
+
+### Resource Panel
+**Definition:** UI component that displays resources linked to current context.
+**Related:** [[maps-resource-toggle]], [[resource-management]]
+
+---
+
+## Quick Actions
+
+- View feature: `cat docs/features/maps-resource-toggle.md`
+- Edit feature: Open docs/features/maps-resource-toggle.md
+- Add to feature: `/qakit:kb/capture LG-NEW --link-to=maps-resource-toggle`
+- Generate tests: `/qakit:jira/create-tests LG-4018 --use-kb`
+```
+
+### No Results Output
+
+```markdown
+# Search Results: "{query}"
+
+No matches found.
+
+## Suggestions
+
+1. Try broader search terms
+2. Check spelling
+3. Search by tag: `/qakit:kb/search --tag=...`
+4. List all features: `/qakit:kb/list`
+
+## Available Tags
+{list of tags from all docs}
+
+## Recent Documents
+{list of recently updated docs}
+```
+
+## Advanced Search
+
+### Combine Filters
+
+```bash
+# Rules about authentication that have conflicts
+/qakit:kb/search "auth" --type=rule --status=conflict
+
+# Features from specific Jira epic
+/qakit:kb/search --source=LG-4000 --type=feature
+
+# All designs for a feature
+/qakit:kb/search --type=design --feature=maps-resource-toggle
+```
+
+### Search Operators
+
+```
+"exact phrase"     - Exact match
+word1 AND word2    - Both terms
+word1 OR word2     - Either term
+-word              - Exclude term
+tag:value          - Tag search
+source:ID          - Source search
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--type=TYPE` | Filter by type (feature/rule/flow/design) | all |
+| `--tag=TAG` | Filter by tag | - |
+| `--source=ID` | Filter by source ID | - |
+| `--status=STATUS` | Filter by status | all |
+| `--feature=NAME` | Search within feature | - |
+| `--limit=N` | Max results | 20 |
+| `--json` | Output as JSON | false |
+
+$ARGUMENTS