ai-qakit 1.0.0

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

@@ -0,0 +1,281 @@
+# Deduplicate Knowledge Base
+
+Find and merge duplicate rules, features, and flows in the knowledge base.
+
+## Usage
+
+```
+/qakit:kb/dedupe
+/qakit:kb/dedupe --type=rules
+/qakit:kb/dedupe --threshold=80
+/qakit:kb/dedupe --auto-merge
+```
+
+## Instructions
+
+### Step 1: Scan Knowledge Base
+
+```bash
+# Collect all rules
+RULES=$(grep -h "^| BR-" docs/features/*.md docs/rules/*.md)
+
+# Collect all features
+FEATURES=$(ls docs/features/*.md)
+
+# Collect all flows
+FLOWS=$(ls docs/flows/*.md 2>/dev/null)
+```
+
+### Step 2: Calculate Similarity
+
+**For rules:**
+- Compare rule text using similarity algorithm
+- Consider: same entities, same actions, same conditions
+- Threshold: 85% similarity = potential duplicate
+
+**For features:**
+- Compare by Jira ticket ID
+- Compare by title similarity
+- Compare by tag overlap
+
+**For flows:**
+- Compare step sequences
+- Compare involved features
+
+### Step 3: Generate Duplicate Report
+
+```markdown
+# Deduplication Report
+
+Generated: {timestamp}
+Threshold: 85% similarity
+
+---
+
+## Duplicate Rules Found: {count}
+
+### Group 1: Panel Open Behavior (90% similar)
+
+| Rule | Text | Feature | Source |
+|------|------|---------|--------|
+| BR-001 | Resources panel opens on docket replay | maps-resource-toggle | LG-4018 |
+| BR-015 | Resource panel opens when replay starts | docket-management | LG-4020 |
+
+**Recommendation:** Merge into shared rule in `docs/rules/_shared-rules.md`
+
+**Suggested merged rule:**
+> Resources panel opens when docket replay starts
+
+**Actions:**
+1. [Merge] Create shared rule, update references
+2. [Keep separate] Mark as related but distinct
+3. [Skip] Ignore this group
+
+---
+
+### Group 2: Close Button Behavior (87% similar)
+
+| Rule | Text | Feature | Source |
+|------|------|---------|--------|
+| BR-003 | Panel closes when X clicked | maps-resource-toggle | LG-4018 |
+| BR-008 | Clicking close button hides panel | resource-panel | LG-4025 |
+
+**Recommendation:** Merge into shared rule
+
+---
+
+## Duplicate Features Found: {count}
+
+### Group 1: Resource Panel (Same Jira ticket)
+
+| Feature | Title | Source |
+|---------|-------|--------|
+| resource-panel.md | Resource Panel | LG-4025 |
+| resource-panel-v2.md | Resource Panel Component | LG-4025 |
+
+**Recommendation:** Merge into single feature doc
+
+---
+
+## Shared Flows Found: {count}
+
+### Flow: "Docket Replay" (appears in 3 features)
+
+| Feature | Section |
+|---------|---------|
+| maps-resource-toggle | User Flows |
+| docket-management | User Flows |
+| resource-panel | Related Flows |
+
+**Recommendation:** Extract to `docs/flows/docket-replay.md`
+
+---
+
+## Summary
+
+| Type | Duplicates | Groups | Recommended Actions |
+|------|------------|--------|---------------------|
+| Rules | 8 | 3 | 2 merge, 1 keep |
+| Features | 2 | 1 | 1 merge |
+| Flows | 3 | 1 | 1 extract |
+
+## Actions
+
+Run with `--interactive` to process each group:
+```
+/qakit:kb/dedupe --interactive
+```
+
+Or auto-merge all:
+```
+/qakit:kb/dedupe --auto-merge
+```
+```
+
+### Step 4: Interactive Resolution
+
+For each duplicate group:
+
+```markdown
+## Processing Group 1: Panel Open Behavior
+
+**Duplicates:**
+1. BR-001 (maps-resource-toggle): "Resources panel opens on docket replay"
+2. BR-015 (docket-management): "Resource panel opens when replay starts"
+
+**Options:**
+1. **Merge** - Create shared rule, update all references
+2. **Keep separate** - Mark as related but distinct
+3. **Skip** - Ignore this group
+4. **Custom** - Provide custom merged text
+
+Select (1-4): _
+```
+
+**If Merge selected:**
+```markdown
+Merged rule text (edit if needed):
+> Resources panel opens when docket replay starts
+
+New rule ID: BR-SHARED-001
+
+Updating references:
+- docs/features/maps-resource-toggle.md: BR-001 → [[rules/_shared-rules#BR-SHARED-001]]
+- docs/features/docket-management.md: BR-015 → [[rules/_shared-rules#BR-SHARED-001]]
+
+✅ Merged successfully
+```
+
+### Step 5: Extract Shared Flows
+
+```markdown
+## Extracting Flow: Docket Replay
+
+Creating: docs/flows/docket-replay.md
+
+```markdown
+---
+id: docket-replay
+title: Docket Replay Flow
+type: flow
+usedBy:
+  - [[maps-resource-toggle]]
+  - [[docket-management]]
+  - [[resource-panel]]
+---
+
+# Docket Replay Flow
+
+## Steps
+
+1. User clicks "Replay" button on docket
+2. System validates docket data
+3. System starts replay animation
+4. System opens Resources panel
+5. System filters resources by docket
+6. User views replay with resources
+7. User clicks "Stop" or replay completes
+8. System closes Resources panel (optional)
+
+## Variations
+
+### With Resources
+Steps 4-5 included
+
+### Without Resources
+Skip steps 4-5
+
+## Related
+- [[maps-resource-toggle]] - Resource panel behavior
+- [[docket-management]] - Docket operations
+```
+
+Updating feature docs to reference flow:
+- maps-resource-toggle.md: Added [[flows/docket-replay]]
+- docket-management.md: Added [[flows/docket-replay]]
+- resource-panel.md: Added [[flows/docket-replay]]
+
+✅ Flow extracted successfully
+```
+
+### Step 6: Update Index
+
+```markdown
+## docs/_index.md updated
+
+### Shared Rules
+- [[rules/_shared-rules]] - 3 shared rules
+
+### Flows
+- [[flows/docket-replay]] - Docket Replay Flow (used by 3 features)
+```
+
+### Step 7: Output Summary
+
+```markdown
+✅ Deduplication Complete
+
+## Actions Taken
+
+| Action | Count | Details |
+|--------|-------|---------|
+| Rules merged | 5 | Into 2 shared rules |
+| Features merged | 1 | resource-panel-v2 → resource-panel |
+| Flows extracted | 1 | docket-replay |
+| Skipped | 2 | User chose to keep separate |
+
+## Files Updated
+- docs/rules/_shared-rules.md (added 2 rules)
+- docs/flows/docket-replay.md (created)
+- docs/features/maps-resource-toggle.md (updated references)
+- docs/features/docket-management.md (updated references)
+- docs/features/resource-panel.md (merged, updated references)
+- docs/_index.md (updated)
+
+## Remaining Duplicates
+None - all processed
+
+## Next Steps
+
+1. Review shared rules:
+   cat docs/rules/_shared-rules.md
+
+2. Review extracted flow:
+   cat docs/flows/docket-replay.md
+
+3. Run again to check:
+   /qakit:kb/dedupe --check
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--type=TYPE` | Only check type (rules/features/flows) | all |
+| `--threshold=N` | Similarity threshold (0-100) | 85 |
+| `--interactive` | Process each group interactively | true |
+| `--auto-merge` | Auto-merge all duplicates | false |
+| `--check` | Only report, don't fix | false |
+| `--dry-run` | Preview changes | false |
+
+$ARGUMENTS

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

@@ -0,0 +1,234 @@
+# Initialize Knowledge Base
+
+Initialize the knowledge base structure for storing and organizing business documentation.
+
+## Usage
+
+```
+/qakit:kb/init
+/qakit:kb/init --path=documentation/
+```
+
+## What This Command Does
+
+Creates the knowledge base directory structure with initial files.
+
+## Instructions
+
+### Step 1: Check if KB Already Exists
+
+```bash
+if [ -d "docs" ] && [ -f "docs/_index.md" ]; then
+  echo "Knowledge base already exists at docs/"
+  echo "Use --force to reinitialize (will preserve existing content)"
+fi
+```
+
+### Step 2: Create Directory Structure
+
+Create the following structure:
+
+```
+docs/
+├── _index.md              # Master index
+├── _glossary.md           # Terms & definitions
+├── _sources.json          # Source registry
+├── features/              # Feature documentation
+│   └── .gitkeep
+├── flows/                 # Business/user flows
+│   └── .gitkeep
+├── rules/                 # Business rules
+│   ├── _shared-rules.md   # Cross-feature rules
+│   └── .gitkeep
+├── assets/                # Media files
+│   ├── screenshots/
+│   │   └── .gitkeep
+│   ├── designs/
+│   │   └── .gitkeep
+│   └── videos/
+│       └── .gitkeep
+└── sources/               # Raw source backups (optional)
+    └── .gitkeep
+```
+
+### Step 3: Create Initial Files
+
+**docs/_index.md:**
+```markdown
+# Knowledge Base
+
+Project business documentation and requirements.
+
+## Quick Links
+
+- [[_glossary]] - Terms & definitions
+- [[rules/_shared-rules]] - Shared business rules
+
+## Features
+
+<!-- Auto-updated when features are added -->
+_No features documented yet. Use `/qakit:kb/capture` to add._
+
+## Recent Updates
+
+| Date | Document | Change |
+|------|----------|--------|
+| {today} | _index.md | Knowledge base initialized |
+
+## Statistics
+
+- Features: 0
+- Business Rules: 0
+- Flows: 0
+- Sources: 0
+
+---
+_Last updated: {timestamp}_
+```
+
+**docs/_glossary.md:**
+```markdown
+# Glossary
+
+Project terminology and definitions.
+
+## How to Use
+
+Reference terms using: `[[_glossary#term-name]]`
+
+## Terms
+
+<!-- Add terms alphabetically -->
+
+### A
+
+_No terms yet._
+
+### B
+
+_No terms yet._
+
+...
+
+---
+
+## Adding Terms
+
+When capturing documentation, extract and add new terms here:
+
+```markdown
+### Term Name
+**Definition:** Clear, concise definition.
+**Context:** Where/how this term is used.
+**Related:** [[other-term]], [[feature-name]]
+**Source:** LG-1234, PRD-456
+```
+```
+
+**docs/_sources.json:**
+```json
+{
+  "version": "1.0",
+  "created": "{timestamp}",
+  "lastUpdated": "{timestamp}",
+  "sources": [],
+  "conflicts": [],
+  "statistics": {
+    "totalSources": 0,
+    "byType": {
+      "jira": 0,
+      "confluence": 0,
+      "design": 0,
+      "video": 0,
+      "manual": 0
+    }
+  }
+}
+```
+
+**docs/rules/_shared-rules.md:**
+```markdown
+# Shared Business Rules
+
+Business rules that apply across multiple features.
+
+## How to Use
+
+Reference rules using: `[[rules/_shared-rules#BR-XXX]]`
+
+## Rules
+
+| ID | Rule | Applies To | Sources | Status |
+|----|------|------------|---------|--------|
+| _No shared rules yet_ | | | | |
+
+## Adding Rules
+
+When a rule applies to multiple features:
+1. Add it here with unique ID (BR-XXX)
+2. Reference from feature docs
+3. Track all source references
+
+---
+_Last updated: {timestamp}_
+```
+
+### Step 4: Create .gitignore for KB
+
+**docs/.gitignore:**
+```
+# Ignore large media files (optional)
+# assets/videos/*.mp4
+# assets/videos/*.mov
+
+# Ignore source backups if too large
+# sources/
+
+# Keep structure
+!.gitkeep
+```
+
+### Step 5: Output Summary
+
+```markdown
+✅ Knowledge Base Initialized
+
+Created structure at: docs/
+
+📁 docs/
+├── _index.md         ✅ Master index
+├── _glossary.md      ✅ Glossary template
+├── _sources.json     ✅ Source registry
+├── features/         ✅ Feature docs
+├── flows/            ✅ Business flows
+├── rules/            ✅ Business rules
+│   └── _shared-rules.md
+└── assets/           ✅ Media storage
+    ├── screenshots/
+    ├── designs/
+    └── videos/
+
+## Next Steps
+
+1. Capture from Jira:
+   /qakit:kb/capture LG-1234 --feature=feature-name
+
+2. Capture from Confluence:
+   /qakit:kb/capture https://company.atlassian.net/wiki/...
+
+3. Add design:
+   /qakit:kb/add-design --feature=feature-name
+
+4. Search KB:
+   /qakit:kb/search "keyword"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--path=PATH` | Custom KB location | `docs/` |
+| `--force` | Reinitialize (preserve content) | false |
+| `--minimal` | Skip optional directories | false |
+
+$ARGUMENTS

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

@@ -0,0 +1,124 @@
+# Link Knowledge Base Documents
+
+Create relationships between features, rules, and flows in the knowledge base.
+
+## Usage
+
+```
+/qakit:kb/link maps-resource-toggle docket-management
+/qakit:kb/link maps-resource-toggle --flow=docket-replay
+/qakit:kb/link maps-resource-toggle --rule=BR-SHARED-001
+```
+
+## Instructions
+
+### Step 1: Validate Documents Exist
+
+```bash
+# Check source document
+if [ ! -f "docs/features/$SOURCE.md" ]; then
+  echo "Source not found: $SOURCE"
+  exit 1
+fi
+
+# Check target document
+if [ ! -f "docs/features/$TARGET.md" ] && \
+   [ ! -f "docs/flows/$TARGET.md" ] && \
+   [ ! -f "docs/rules/$TARGET.md" ]; then
+  echo "Target not found: $TARGET"
+  exit 1
+fi
+```
+
+### Step 2: Determine Link Type
+
+```
+Link types:
+- feature ↔ feature: "relates to"
+- feature → flow: "uses flow"
+- feature → rule: "implements rule"
+- flow → feature: "used by"
+```
+
+### Step 3: Add Link to Source Document
+
+**Update frontmatter:**
+```yaml
+related:
+  - "[[existing-link]]"
+  - "[[new-target]]"  # Added
+```
+
+**Update Related section:**
+```markdown
+## Related
+
+- [[existing-link]] - Existing description
+- [[new-target]] - {relationship description}
+```
+
+### Step 4: Add Reverse Link (bidirectional)
+
+For feature ↔ feature links, also update target:
+
+```markdown
+## Related
+
+- [[source-feature]] - Related feature
+```
+
+### Step 5: Output Summary
+
+```markdown
+✅ Link Created
+
+**Source:** docs/features/maps-resource-toggle.md
+**Target:** docs/features/docket-management.md
+**Type:** relates to
+
+## Updated Files
+- docs/features/maps-resource-toggle.md (added link)
+- docs/features/docket-management.md (added reverse link)
+
+## Current Links for maps-resource-toggle
+
+| Target | Type | Description |
+|--------|------|-------------|
+| [[docket-management]] | feature | Related feature |
+| [[resource-panel]] | feature | UI component |
+| [[flows/docket-replay]] | flow | Uses this flow |
+```
+
+## Bulk Linking
+
+```bash
+# Link feature to multiple targets
+/qakit:kb/link maps-resource-toggle docket-management resource-panel
+
+# Link from file with relationships
+/qakit:kb/link --from-file=links.yaml
+```
+
+**links.yaml format:**
+```yaml
+maps-resource-toggle:
+  features:
+    - docket-management
+    - resource-panel
+  flows:
+    - docket-replay
+  rules:
+    - BR-SHARED-001
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--flow=NAME` | Link to flow | - |
+| `--rule=ID` | Link to rule | - |
+| `--description=TEXT` | Link description | Auto |
+| `--one-way` | Don't create reverse link | false |
+| `--from-file=FILE` | Bulk link from YAML | - |
+
+$ARGUMENTS