ruvnet-kb-first 6.0.0 → 6.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/SKILL.md +44 -6
- package/package.json +1 -1
- package/src/mcp-server.js +1184 -460
package/SKILL.md
CHANGED
|
@@ -1,13 +1,51 @@
|
|
|
1
|
-
Updated: 2026-01-02 10:
|
|
1
|
+
Updated: 2026-01-02 10:35:00 EST | Version 6.2.0
|
|
2
2
|
Created: 2026-01-01 15:00:00 EST
|
|
3
3
|
|
|
4
|
-
# RuvNet KB-First Application Builder v6.
|
|
4
|
+
# RuvNet KB-First Application Builder v6.2
|
|
5
5
|
|
|
6
|
-
## Score-Driven Architecture: Scoring IS Enforcement
|
|
6
|
+
## Score-Driven Architecture: Scoring IS Enforcement + UX Excellence
|
|
7
7
|
|
|
8
|
-
**Version:** 6.
|
|
8
|
+
**Version:** 6.2.0
|
|
9
9
|
**NPM Package:** `ruvnet-kb-first`
|
|
10
|
-
**Philosophy:** Every operation requires baseline scoring. Every change shows delta. Negative delta BLOCKS progress. No shortcuts.
|
|
10
|
+
**Philosophy:** Every operation requires baseline scoring. Every change shows delta. Negative delta BLOCKS progress. No shortcuts. **NEW:** Applications must be excellent, not just functional.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## What's New in v6.2.0 - UX Excellence
|
|
15
|
+
|
|
16
|
+
| Feature | Description |
|
|
17
|
+
|---------|-------------|
|
|
18
|
+
| **UX Quality Dimension** | 7th KB dimension: Visual design, emotional appeal, user flow |
|
|
19
|
+
| **Phase 12: UX Quality Review** | Playwright-based end-user perspective audit |
|
|
20
|
+
| **`kb_first_ux_review` Tool** | Captures screenshots, checks versioning, critical review |
|
|
21
|
+
| **Version Display Check** | Verifies version in header/footer (major.minor.patch) |
|
|
22
|
+
| **Cache-Busting Check** | Ensures users see latest version, not cached content |
|
|
23
|
+
| **Critical Review Questions** | How good? How could it be better? Where falling down? What would excellent look like? |
|
|
24
|
+
| **Playwright Auto-Install** | Offers to install Playwright if not present |
|
|
25
|
+
|
|
26
|
+
### The 6 MCP Tools (v6.2)
|
|
27
|
+
|
|
28
|
+
| Tool | Purpose | When to Use |
|
|
29
|
+
|------|---------|-------------|
|
|
30
|
+
| `kb_first_assess` | Score ALL dimensions (7 KB + 13 Phases) | **FIRST** - before any work |
|
|
31
|
+
| `kb_first_plan` | Generate enhancement plan with predictions | After assess, shows gaps |
|
|
32
|
+
| `kb_first_confirm` | User confirms readiness to proceed | Before execution |
|
|
33
|
+
| `kb_first_execute` | Execute plan phase by phase | After confirmation |
|
|
34
|
+
| `kb_first_verify` | Compare predicted vs actual, recursive until 98+ | After execution |
|
|
35
|
+
| `kb_first_ux_review` | Playwright-based visual quality audit | **NEW** - for UX excellence |
|
|
36
|
+
|
|
37
|
+
### UX Quality Criteria (Scored in UX Review)
|
|
38
|
+
|
|
39
|
+
| Criterion | Weight | Checks |
|
|
40
|
+
|-----------|--------|--------|
|
|
41
|
+
| Version Display | 15% | Header/footer shows major.minor.patch |
|
|
42
|
+
| Cache Management | 10% | Version change detection, user notification |
|
|
43
|
+
| Visual Design Excellence | 20% | Typography, color, spacing, not generic AI look |
|
|
44
|
+
| Emotional Appeal | 15% | Creates confidence, celebrates success, softens errors |
|
|
45
|
+
| Loading States | 10% | Skeleton loaders, progress indicators, graceful |
|
|
46
|
+
| Error Handling UX | 10% | Clear messages, actionable, no technical jargon |
|
|
47
|
+
| User Flow | 10% | Intuitive navigation, clear CTAs, minimal friction |
|
|
48
|
+
| Accessibility | 10% | Keyboard nav, screen reader, contrast, focus |
|
|
11
49
|
|
|
12
50
|
---
|
|
13
51
|
|
|
@@ -22,7 +60,7 @@ Created: 2026-01-01 15:00:00 EST
|
|
|
22
60
|
| **Baseline Requirement** | Cannot start work without establishing baseline |
|
|
23
61
|
| **Automatic Refresh** | Baseline resets after each gate passage |
|
|
24
62
|
|
|
25
|
-
### The 4 MCP Tools
|
|
63
|
+
### The Original 4 MCP Tools (v6.0)
|
|
26
64
|
|
|
27
65
|
| Tool | Purpose | When to Use |
|
|
28
66
|
|------|---------|-------------|
|