ai-developer-skill-os 6.0.2 → 7.0.0

package/templates/DESIGN.md

@@ -0,0 +1,38 @@
+# DESIGN.md - The Brand Contract
+
+> **CRITICAL RULE:** This file is the Single Source of Truth for all UI/UX in this project. 
+> Any AI agent performing frontend work MUST adhere strictly to the rules, tokens, and components defined here. 
+> DO NOT invent generic Tailwind colors or default layouts. DO NOT use "slop" AI aesthetics.
+
+## 1. Typography
+- **Primary Font:** [Specify Font Family, e.g., Inter, Roboto]
+- **Heading Font:** [Specify Font Family if different]
+- **Base Size:** [e.g., 16px]
+- **Scale:** [e.g., Major Third (1.25) or Perfect Fourth (1.333)]
+
+## 2. Color Palette (Strict Constraints)
+- **Primary:** HSL(xxx, xx%, xx%)
+- **Secondary:** HSL(xxx, xx%, xx%)
+- **Background (Light):** HSL(xxx, xx%, xx%)
+- **Background (Dark):** HSL(xxx, xx%, xx%)
+- **Text (Light/Dark):** HSL(xxx, xx%, xx%)
+- **Forbidden Colors:** [e.g., Default Tailwind `blue-500`, `red-500`. NEVER use default primary colors].
+
+## 3. Spacing & Grid System
+- **Base Unit:** [e.g., 4px / 0.25rem]
+- **Grid Layout:** [e.g., 12-column grid, max-width: 1280px]
+- **Whitespace Rule:** Always favor generous whitespace (whitespace is cheap, clutter is expensive).
+
+## 4. UI Components & Micro-interactions
+- **Border Radius:** [e.g., 8px for cards, 4px for buttons, 9999px for pills]
+- **Shadows/Elevation:** [Define soft, organic shadows; avoid harsh, generic drop shadows]
+- **Animations:** [e.g., 200ms ease-out for hover states, use micro-animations for button presses].
+
+## 5. Anti-Slop Guidelines (Hallmark Rules)
+- **NO Default Borders:** Avoid adding a 1px solid border to everything. Use background color shifts or soft shadows instead.
+- **NO Cluttered Forms:** Forms must have clear visual hierarchy, grouped inputs, and explicit focus states.
+- **NO Floating Elements:** Elements must be anchored visually to a grid.
+- **MUST Check Contrast:** All text must meet WCAG AA contrast ratios.
+
+---
+*Note to AI Agent: If you are about to emit code that violates these rules, STOP. Redesign it, run an [AUDIT], and apply the correct constraints.*

package/tests/behavior-conformance.test.js

@@ -22,12 +22,14 @@ function parseBSF(skillPath) {
   const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
   if (!fmMatch) return null;
   const frontmatter = YAML.load(fmMatch[1]);
-  if (frontmatter.version !== '6.0.0') return { type: 'v5', frontmatter };
-
-  const bsf = { type: 'v6', frontmatter };
+  let type = 'legacy';
+  if (frontmatter.version && frontmatter.version.startsWith('7.')) type = 'v7';
+  else if (frontmatter.version && frontmatter.version.startsWith('6.')) type = 'v6';
+  
+  const bsf = { type, frontmatter };
   
   // Parse YAML blocks
-  const yamlBlocks = [...content.matchAll(/```yaml\n([\s\S]*?)\n```/g)];
+  const yamlBlocks = [...content.matchAll(/```yaml\r?\n([\s\S]*?)\r?\n```/g)];
   
   try {
     let parsedBlocks = {};
@@ -61,24 +63,24 @@ function parseBSF(skillPath) {
 describe('Behavior Validation Framework', () => {
 
   describe('Level 1: Specification Valid', () => {
-    it('Every v6 skill must have valid Schema (Metadata, Scope, Constraints)', () => {
+    it('Every v6/v7 skill must have valid Schema (Metadata, Scope, Constraints)', () => {
       const dirs = getActiveSkillDirs();
-      const v6Skills = [];
+      const modernSkills = [];
 
       dirs.forEach(dir => {
         const skillPath = path.join(dir, 'SKILL.md');
         if (!fs.existsSync(skillPath)) return;
         const bsf = parseBSF(skillPath);
         
-        if (bsf && bsf.type === 'v6') {
-          v6Skills.push(dir);
+        if (bsf && bsf.type === 'v7') {
+          modernSkills.push(dir);
           expect(bsf.error, `Parser error in ${path.basename(dir)}: ${bsf.error}`).toBeUndefined();
           expect(bsf.frontmatter.category, `Missing category metadata in ${path.basename(dir)}`).toBeDefined();
           expect(bsf.constraints, `Missing Constraints in ${path.basename(dir)}`).toBeDefined();
         }
       });
 
-      expect(v6Skills.length).toBeGreaterThan(0);
+      expect(modernSkills.length).toBeGreaterThan(0);
     });
   });
 
@@ -91,12 +93,13 @@ describe('Behavior Validation Framework', () => {
         if (!fs.existsSync(skillPath)) return;
         const bsf = parseBSF(skillPath);
         
-        if (bsf && bsf.type === 'v6' && !bsf.error) {
+        if (bsf && bsf.type === 'v7' && !bsf.error) {
           const must = bsf.constraints.must || [];
           const must_not = bsf.constraints.must_not || [];
           
           must.forEach(rule => {
-            const conflict = must_not.some(c => c.toLowerCase() === rule.toLowerCase());
+            if (typeof rule !== 'string') return;
+            const conflict = must_not.some(c => typeof c === 'string' && c.toLowerCase() === rule.toLowerCase());
             expect(conflict, `Conflict detected in ${path.basename(dir)}: '${rule}' is in both must and must_not`).toBe(false);
           });
         }