agents-config 1.0.0 → 1.1.1

package/README.md

@@ -3,7 +3,11 @@
 A comprehensive knowledge base and skill library for building production-grade React applications with AI-powered tools and best practices.
 
 [![npm version](https://img.shields.io/npm/v/agents-config.svg)](https://www.npmjs.com/package/agents-config)
+[![npm downloads](https://img.shields.io/npm/dm/agents-config.svg)](https://www.npmjs.com/package/agents-config)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![GitHub stars](https://img.shields.io/github/stars/ericthayer/agents-config.svg)](https://github.com/ericthayer/agents-config/stargazers)
+[![Node.js](https://img.shields.io/node/v/agents-config.svg)](https://nodejs.org/)
+[![CI](https://github.com/ericthayer/agents-config/actions/workflows/ci.yml/badge.svg)](https://github.com/ericthayer/agents-config/actions/workflows/ci.yml)
 
 ## Overview
 
@@ -96,7 +100,7 @@ Detailed operational guidelines for specific development tasks:
 - **`github-issue.instructions.md`** - Process for creating and managing GitHub issues
 - **`github-release-notes.instructions.md`** - Guidelines for writing release notes
 - **`mui.instructions.md`** - Material-UI (MUI v7+) specific patterns, theming, and dark mode implementation
-- **`storybook.instructions.md`** - Setting up and maintaining Storybook documentation
+- **`storybook.instructions.md`** - Setting up and maintaining Storybook v10.2 documentation
 - **`web-interface-guidelines.instructions.md`** - Accessibility and UX standards for web interfaces
 
 ### 📂 `rules/`
@@ -144,7 +148,7 @@ Implement Google Gemini API integration with:
 - Loading and streaming UI states
 - Attribution and safety requirements
 
-#### **`vercel-react-best-practices/`**
+#### **`vercel-react-best-practices/`** (Optional via `npx add-skill vercel-labs/agent-skills`)
 Performance optimization guidelines from Vercel Engineering. Covers 45+ rules across 8 categories:
 - Eliminating waterfalls (async patterns)
 - Bundle size optimization
@@ -155,6 +159,11 @@ Performance optimization guidelines from Vercel Engineering. Covers 45+ rules ac
 - Event handling and refs
 - JavaScript optimization
 
+**Installation:**
+```bash
+npx add-skill vercel-labs/agent-skills
+```
+
 Includes subdirectories:
 - **`rules/`** - Individual rule documents (45+ files organized by category)
 - **`workflows/`** - Task-specific workflows:
@@ -177,7 +186,7 @@ Reference the appropriate skill or rule based on the development task:
 - Use `accessibility-audit` before marking features complete
 - Use `scaffold-component` when creating new components
 - Use `integrate-gemini` for AI feature implementation
-- Reference `vercel-react-best-practices` for performance optimization
+- Install and reference `vercel-react-best-practices` for performance optimization (optional: `npx add-skill vercel-labs/agent-skills`)
 
 ### For Developers
 - Start with [AGENTS.md](AGENTS.md) for core principles

package/bin/agents-init.js

@@ -96,13 +96,13 @@ const DATABASES = {
 };
 
 // Core rules always included
-const CORE_RULES = ['accessibility', 'component-architecture', 'spec-driven-development'];
+const CORE_RULES = ['accessibility', 'component-architecture', 'spec-driven-development', 'web-performance'];
 
 // Core skills always included
 const CORE_SKILLS = ['accessibility-audit', 'scaffold-component'];
 
 // Core instructions always included
-const CORE_INSTRUCTIONS = ['development-standards'];
+const CORE_INSTRUCTIONS = ['development-standards', 'web-interface-guidelines'];
 
 // Parse command line arguments
 const args = process.argv.slice(2);
@@ -291,8 +291,7 @@ function determineSkills(config) {
   
   if (config.gemini) skills.push('integrate-gemini');
   
-  // Always include vercel-react-best-practices (just the SKILL.md, not full rules subfolder)
-  skills.push('vercel-react-best-practices');
+  // Additional skills can be installed via: npx add-skill vercel-labs/agent-skills
   
   return skills;
 }
@@ -403,37 +402,13 @@ function copyAgentsFolder(projectDir, config, filesToCreate) {
     const destDir = path.join(agentsDir, 'skills', skill);
     
     if (fs.existsSync(srcDir)) {
-      // For vercel-react-best-practices, only copy SKILL.md and AGENTS.md (not the huge rules subfolder)
-      if (skill === 'vercel-react-best-practices') {
-        const skillMdSrc = path.join(srcDir, 'SKILL.md');
-        const skillMdDest = path.join(destDir, 'SKILL.md');
-        if (fs.existsSync(skillMdSrc)) {
-          filesToCreate.push({
-            src: skillMdSrc,
-            dest: skillMdDest,
-            relativePath: `.agents/skills/${skill}/SKILL.md`,
-            type: 'file',
-          });
-        }
-        const agentsMdSrc2 = path.join(srcDir, 'AGENTS.md');
-        const agentsMdDest2 = path.join(destDir, 'AGENTS.md');
-        if (fs.existsSync(agentsMdSrc2)) {
-          filesToCreate.push({
-            src: agentsMdSrc2,
-            dest: agentsMdDest2,
-            relativePath: `.agents/skills/${skill}/AGENTS.md`,
-            type: 'file',
-          });
-        }
-      } else {
-        // Copy entire skill folder
-        filesToCreate.push({
-          src: srcDir,
-          dest: destDir,
-          relativePath: `.agents/skills/${skill}/`,
-          type: 'folder',
-        });
-      }
+      // Copy entire skill folder
+      filesToCreate.push({
+        src: srcDir,
+        dest: destDir,
+        relativePath: `.agents/skills/${skill}/`,
+        type: 'folder',
+      });
     }
   }
   
@@ -679,6 +654,11 @@ ${colors.cyan}Next steps:${colors.reset}
 2. Commit the .agents/ folder and adapter files to git
 3. Your AI agents will now follow consistent guidelines
 
+${colors.cyan}Optional skills:${colors.reset}
+
+  ${colors.bright}npx add-skill vercel-labs/agent-skills${colors.reset}
+    Install Vercel's React best practices (45+ performance rules)
+
 ${colors.cyan}Useful commands:${colors.reset}
 
   ${colors.bright}npx agents-init --force${colors.reset}    Regenerate all config files

package/instructions/development-standards.instructions.md

@@ -3,7 +3,7 @@ applyTo: '**'
 ---
 # Development Standards and Best Practices
 
-This document outlines the standards and best practices for DevLog Application Development which uses React, TypeScript, Material UI, and follows the [Airbnb style guide](https://airbnb.io/javascript/) page.
+This document outlines the standards and best practices for Application Development which uses React, TypeScript, Material UI, and follows the [Airbnb style guide](https://airbnb.io/javascript/) page.
 
 ## Web Interface Guidelines - Development Standards and Guidelines
 ALWAYS refer to the `.github/instructions/web-interface-guidelines.instructions.md` file for detailed explicit guidelines to follow when building _any_ web interface.

package/instructions/github-issue.instructions.md

@@ -4,7 +4,7 @@ applyTo: '**/*.md, **/*.mdx'
 
 # GitHub Issue Creation Instructions
 
-Use these instructions to create well-structured, comprehensive GitHub issues for the DevLog application.
+Use these instructions to create well-structured, comprehensive GitHub issues for the Application Development.
 
 ## Issue Structure Template
 

package/instructions/github-release-notes.instructions.md

@@ -4,7 +4,7 @@ applyTo: '**/*.md, **/*.mdx'
 
 # GitHub Release Notes Instructions
 
-This document provides comprehensive instructions for creating professional, well-structured GitHub release notes for the DevLog application. Release notes are published in two formats: a **detailed version** and a **summary version**.
+This document provides comprehensive instructions for creating professional, well-structured GitHub release notes for the Application Development. Release notes are published in two formats: a **detailed version** and a **summary version**.
 
 ## File Naming and Location
 

package/instructions/storybook.instructions.md

@@ -5,7 +5,7 @@ Provide project context and coding guidelines that AI should follow when generat
 
 # /build.storybook - Scaffold Storybook Story
 
-Generate a Storybook story file following the DevLog application patterns.
+Generate a Storybook story file following the Application Development patterns.
 
 ## Usage
 - `/build.storybook ComponentName` - Creates basic story with Primary/Secondary variants

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-config",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "A comprehensive knowledge base and skill library for building production-grade React applications with AI-powered tools and best practices.",
   "author": "Eric Thayer",
   "license": "MIT",

package/prompts/create-pr.prompt.md

@@ -12,7 +12,7 @@ Analyze the last git commit and create a comprehensive PR description.
 1. **Get the latest commit details:**
    - Use `mcp_github_get_commit` with:
      - owner: `ericthayer`
-     - repo: `devlog`
+     - repo: `agents-config`
      - sha: Get from `git log -1 --pretty=format:"%H"`
      - include_diff: `true`
 
@@ -66,7 +66,7 @@ gh pr create \
 See `.github/GITHUB_AUTH_SETUP.md` for authentication setup.
 
 ## Context
-- Repository: github.com/ericthayer/devlog
+- Repository: github.com/ericthayer/agents-config
 - Default base branch: `main`
 - See `.github/pr-template-commits.md` for reusable PR description template
 - See `.github/GITHUB_AUTH_SETUP.md` for GitHub authentication guide