aayushus-skills 1.0.1 → 1.2.0

package/cli.js

@@ -18,7 +18,11 @@ const styles = {
 };
 
 const options = [
-  { name: 'AI Agent Configurations (CLAUDE.md, .windsurfrules, etc.)', value: 'agent-config', checked: true },
+  { name: 'Antigravity Rules (.antigravityrules)', value: 'antigravity', checked: true },
+  { name: 'Devin Rules (.devin/rules/rules.md & AGENTS.md)', value: 'devin', checked: true },
+  { name: 'Cursor Rules (.cursorrules)', value: 'cursor', checked: true },
+  { name: 'Claude Rules (CLAUDE.md)', value: 'claude', checked: true },
+  { name: 'Codex/Copilot Rules (.github/copilot-instructions.md)', value: 'codex', checked: true },
   { name: 'Prism Design System (tokens, components CSS/TSX)', value: 'design', checked: true },
   { name: 'Development Guidelines (Architecture, Quality, Security)', value: 'guidelines', checked: true },
   { name: 'Solo Developer AI SOP (Standard Operating Procedure)', value: 'sop', checked: true }
@@ -26,15 +30,22 @@ const options = [
 
 let cursorIndex = 0;
 
+const args = process.argv.slice(2);
+const isDryRun = args.includes('--dry-run') || args.includes('-d');
+
 function printMenu() {
-  // Clear screen or reposition cursor
   readline.cursorTo(process.stdout, 0, 0);
   readline.clearScreenDown(process.stdout);
 
   console.log(`\n${styles.cyan}${styles.bold}=========================================${styles.reset}`);
   console.log(`${styles.cyan}${styles.bold}      aayushus-skills CLI Installer      ${styles.reset}`);
+  if (isDryRun) {
+    console.log(`${styles.yellow}${styles.bold}             [ DRY RUN MODE ]            ${styles.reset}`);
+  }
   console.log(`${styles.cyan}${styles.bold}=========================================${styles.reset}\n`);
-  console.log(`${styles.dim}Use ${styles.bold}↑/↓${styles.reset}${styles.dim} to navigate, ${styles.bold}space${styles.reset}${styles.dim} to select/deselect, and ${styles.bold}enter${styles.reset}${styles.dim} to confirm.\n${styles.reset}`);
+
+  console.log(`${styles.dim}Select components and tools to install/configure:${styles.reset}`);
+  console.log(`${styles.dim}Use ${styles.bold}↑/↓${styles.reset}${styles.dim} to navigate, ${styles.bold}space${styles.reset}${styles.dim} to toggle, and ${styles.bold}enter${styles.reset}${styles.dim} to install.\n${styles.reset}`);
 
   options.forEach((opt, idx) => {
     const isCursor = idx === cursorIndex;
@@ -48,6 +59,10 @@ function printMenu() {
 }
 
 function copyFileSync(src, dest) {
+  if (isDryRun) {
+    console.log(`${styles.yellow}[Dry Run] Would copy: ${path.basename(src)} -> ${path.relative(process.cwd(), dest)}${styles.reset}`);
+    return;
+  }
   const destDir = path.dirname(dest);
   if (!fs.existsSync(destDir)) {
     fs.mkdirSync(destDir, { recursive: true });
@@ -56,6 +71,10 @@ function copyFileSync(src, dest) {
 }
 
 function copyFolderSync(src, dest) {
+  if (isDryRun) {
+    console.log(`${styles.yellow}[Dry Run] Would copy folder: ${path.basename(src)}/ -> ${path.relative(process.cwd(), dest)}/${styles.reset}`);
+    return;
+  }
   if (!fs.existsSync(dest)) {
     fs.mkdirSync(dest, { recursive: true });
   }
@@ -74,7 +93,8 @@ function copyFolderSync(src, dest) {
 }
 
 function runInstallation() {
-  console.log(`\n${styles.yellow}Starting installation...${styles.reset}\n`);
+  const modeText = isDryRun ? 'Dry run simulation' : 'Installation';
+  console.log(`\n${styles.yellow}Starting ${modeText}...${styles.reset}\n`);
 
   const packageRoot = __dirname;
   const targetRoot = process.cwd();
@@ -86,27 +106,50 @@ function runInstallation() {
     process.exit(0);
   }
 
-  // 1. Agent Configs
-  if (selected.includes('agent-config')) {
-    console.log(`${styles.blue} Installing AI Agent Configurations...${styles.reset}`);
-    const srcAgentDir = path.join(packageRoot, 'agent-config');
-
-    if (fs.existsSync(srcAgentDir)) {
-      copyFileSync(path.join(srcAgentDir, 'windsurfrules.md'), path.join(targetRoot, '.windsurfrules'));
-      copyFileSync(path.join(srcAgentDir, 'windsurfrules-global.md'), path.join(targetRoot, '.windsurfrules-global'));
-      copyFileSync(path.join(srcAgentDir, 'CLAUDE.md'), path.join(targetRoot, 'CLAUDE.md'));
-      copyFileSync(path.join(srcAgentDir, 'copilot-instructions.md'), path.join(targetRoot, '.github', 'copilot-instructions.md'));
-      console.log(`${styles.green}  ✓ Copied .windsurfrules, .windsurfrules-global, CLAUDE.md, and .github/copilot-instructions.md${styles.reset}`);
-    } else {
-      console.log(`${styles.red}  ✗ Source agent-config directory not found.${styles.reset}`);
+  const srcAgentDir = path.join(packageRoot, 'agent-config');
+  const hasAgentConfigs = fs.existsSync(srcAgentDir);
+
+  if (hasAgentConfigs) {
+    const genericRulesFile = path.join(srcAgentDir, 'rules.md');
+    const claudeFile = path.join(srcAgentDir, 'CLAUDE.md');
+    const copilotFile = path.join(srcAgentDir, 'copilot-instructions.md');
+
+    // 1. Antigravity
+    if (selected.includes('antigravity')) {
+      console.log(`${styles.blue} Configuring Antigravity rules...${styles.reset}`);
+      copyFileSync(genericRulesFile, path.join(targetRoot, '.antigravityrules'));
+    }
+
+    // 2. Devin
+    if (selected.includes('devin')) {
+      console.log(`${styles.blue} Configuring Devin rules...${styles.reset}`);
+      copyFileSync(genericRulesFile, path.join(targetRoot, '.devin', 'rules', 'rules.md'));
+      copyFileSync(genericRulesFile, path.join(targetRoot, 'AGENTS.md'));
+    }
+
+    // 3. Cursor
+    if (selected.includes('cursor')) {
+      console.log(`${styles.blue} Configuring Cursor rules...${styles.reset}`);
+      copyFileSync(genericRulesFile, path.join(targetRoot, '.cursorrules'));
+    }
+
+    // 4. Claude
+    if (selected.includes('claude')) {
+      console.log(`${styles.blue} Configuring Claude CLAUDE.md...${styles.reset}`);
+      copyFileSync(claudeFile, path.join(targetRoot, 'CLAUDE.md'));
+    }
+
+    // 5. Codex/Copilot
+    if (selected.includes('codex')) {
+      console.log(`${styles.blue} Configuring Codex/Copilot rules...${styles.reset}`);
+      copyFileSync(copilotFile, path.join(targetRoot, '.github', 'copilot-instructions.md'));
     }
   }
 
-  // 2. Design System
+  // 6. Design System
   if (selected.includes('design')) {
     console.log(`${styles.blue} Installing Prism Design System...${styles.reset}`);
     const srcDesignDir = path.join(packageRoot, 'design');
-    // Defaulting to root design folder or src/design if src exists
     const destDesignDir = fs.existsSync(path.join(targetRoot, 'src')) 
       ? path.join(targetRoot, 'src', 'design') 
       : path.join(targetRoot, 'design');
@@ -119,7 +162,7 @@ function runInstallation() {
     }
   }
 
-  // 3. Development Guidelines
+  // 7. Development Guidelines
   if (selected.includes('guidelines')) {
     console.log(`${styles.blue} Installing Development Guidelines...${styles.reset}`);
     const srcGuidelinesDir = path.join(packageRoot, 'guidelines');
@@ -133,7 +176,7 @@ function runInstallation() {
     }
   }
 
-  // 4. SOP
+  // 8. SOP
   if (selected.includes('sop')) {
     console.log(`${styles.blue} Installing Solo Developer AI SOP...${styles.reset}`);
     const srcSopFile = path.join(packageRoot, 'Solo Developer AI SOP.md');
@@ -146,13 +189,14 @@ function runInstallation() {
     }
   }
 
-  console.log(`\n${styles.green}${styles.bold}✓ Installation completed successfully!${styles.reset}\n`);
+  const completeMsg = isDryRun 
+    ? '✓ Dry run completed successfully! No files were modified.'
+    : '✓ Installation completed successfully!';
+  console.log(`\n${styles.green}${styles.bold}${completeMsg}${styles.reset}\n`);
   process.exit(0);
 }
 
-const args = process.argv.slice(2);
-
-// Check if help is requested
+// Help documentation
 if (args.includes('--help') || args.includes('-h') || args.includes('help')) {
   console.log(`
 aayushus-skills CLI Installer
@@ -161,31 +205,42 @@ Usage:
   npx aayushus-skills               Interactive installation menu (default)
   npx aayushus-skills all           Install everything directly
   npx aayushus-skills design        Install Prism Design System only
-  npx aayushus-skills agent-config  Install AI Agent Configurations only
   npx aayushus-skills guidelines    Install Development Guidelines only
   npx aayushus-skills sop           Install Solo Developer AI SOP only
+  npx aayushus-skills cursor        Install Cursor rules only
+  npx aayushus-skills antigravity   Install Antigravity rules only
+  npx aayushus-skills devin         Install Devin rules only
+  npx aayushus-skills claude        Install Claude rules only
+  npx aayushus-skills codex         Install Codex/Copilot rules only
+
+Flags:
+  -d, --dry-run                     Preview installation without making actual changes
   `);
   process.exit(0);
 }
 
-// Map command-line args to options values
+// Check for direct subcommands
 const argMap = {
+  'antigravity': 'antigravity',
+  'devin': 'devin',
+  'cursor': 'cursor',
+  'claude': 'claude',
+  'codex': 'codex',
+  'copilot': 'codex',
   'design': 'design',
-  'agent-config': 'agent-config',
-  'agent': 'agent-config',
   'guidelines': 'guidelines',
   'sop': 'sop'
 };
 
-const hasDirectCommand = args.some(arg => argMap[arg] || arg === 'all');
+const directArgs = args.filter(arg => arg !== '--dry-run' && arg !== '-d');
+const hasDirectCommand = directArgs.some(arg => argMap[arg] || arg === 'all');
 
 if (hasDirectCommand) {
-  if (args.includes('all')) {
+  if (directArgs.includes('all')) {
     options.forEach(opt => opt.checked = true);
   } else {
-    // Select only options matching the command line arguments
     options.forEach(opt => {
-      opt.checked = args.some(arg => argMap[arg] === opt.value);
+      opt.checked = directArgs.some(arg => argMap[arg] === opt.value);
     });
   }
   runInstallation();
@@ -193,7 +248,6 @@ if (hasDirectCommand) {
 
 // Start interactive CLI
 if (!process.stdin.isTTY) {
-  // If not TTY, default to installing everything
   console.log('Non-interactive environment detected. Installing all components...');
   options.forEach(opt => opt.checked = true);
   runInstallation();
@@ -227,7 +281,6 @@ process.stdin.on('keypress', (str, key) => {
       break;
     case 'return':
     case 'enter':
-      // Clean up raw mode
       if (process.stdin.isTTY) {
         process.stdin.setRawMode(false);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aayushus-skills",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Interactive CLI tool to install developer agent configurations, design system tokens, guidelines, and SOPs.",
   "main": "cli.js",
   "bin": {

package/agent-config/windsurfrules-global.md

@@ -1,128 +0,0 @@
-# Universal coding rules — applies to all projects
-
-These rules are tool-agnostic, stack-agnostic hard constraints.
-Project-specific stack decisions live in .windsurfrules at the project root.
-
----
-
-## SECURITY — never negotiate these
-
-- Validate every input at every system boundary — HTTP, queue, file upload, CLI args
-- All strings have a max length — no unbounded input
-- Passwords: Argon2id only — never bcrypt, MD5, SHA-1, or SHA-256 for passwords
-- Secrets in a secrets manager (Doppler, AWS Secrets Manager, Vault) — never in code, env files, or logs
-- One place reads environment variables — a config module with schema validation
-- Never reveal whether a user/email/resource exists to an unauthenticated caller
-- Unauthorised reads return 404, not 403 — prevents existence leak
-- Never log secrets, tokens, PII, or raw passwords — redact at the transport layer
-- Session tokens rotate on: login, logout, privilege change
-- File uploads: validate by magic number (not extension), scan for malware, strip metadata
-- SSRF: DNS-resolve before fetching, reject private/loopback IPs
-- Every outbound network call has a hard timeout
-- Retries only on 5xx and network errors — never on 4xx
-- Rate-limit authentication endpoints (login, password reset, MFA)
-- CORS: explicit allowlist — never wildcard `*` in production
-- Security headers on every response: HSTS, X-Frame-Options, CSP
-- TLS 1.2+ everywhere
-
----
-
-## CODE QUALITY — language-agnostic rules
-
-- Use the strictest type-checking mode available for your language
-- Never use the "any" escape hatch (TypeScript `any`, Python `Any` without bounds, Go `interface{}` without assertion)
-- Functions ≤ 80 lines (aim ≤ 30); files ≤ 500 lines (aim ≤ 300)
-- No `console.log` / `print` in committed code — use a structured logger
-- No commented-out code — delete it; use git history
-- No TODO without author and date; CI should fail if TODOs accumulate
-- Boolean variables use `is/has/can/should` prefix
-- Error handling: throw/panic for programming errors (bugs); return typed errors/Result for expected failures (validation, not-found, rate-limit)
-- Async/await always — never raw promise chains or callbacks
-- Parallelise independent async work — don't await sequentially when parallel is safe
-- No N+1 queries — use eager loading, joins, or batching
-- No circular imports — signals wrong module boundaries
-- PR size ≤ 400 lines unless generated — split larger changes
-- Refactoring and feature work never in the same PR
-
----
-
-## PERFORMANCE — hard budgets
-
-| Interaction | Budget |
-|---|---|
-| UI response (click, hover, keypress) | ≤ 100ms |
-| Page / view transition | ≤ 200ms |
-| API read (cached) p95 | < 200ms |
-| API read (list) p95 | < 300ms |
-| API write p95 | < 300ms |
-| Anything > 1s | Show progress indicator; consider async |
-| Anything > 10s | Must be async with completion notification |
-| LCP | ≤ 2.5s (p75) |
-| INP | ≤ 200ms (p75) |
-| CLS | ≤ 0.1 (p75) |
-| JS bundle gzipped | ≤ 170KB |
-| CSS bundle gzipped | ≤ 30KB |
-| DB indexed point lookup | ≤ 10ms |
-| DB list query | ≤ 200ms |
-
-- Profile before optimising — never optimise by intuition
-- Every query must hit an index — no sequential scans on large tables
-- Cache keys must include tenant/user scope — never serve one user's cached data to another
-- TTL on every cache entry — no infinite caches
-
----
-
-## OBSERVABILITY — always
-
-- Structured JSON logs — required fields: `timestamp`, `level`, `service`, `correlationId`, `message`
-- Correlation ID on every log line, every async job, every cross-service call
-- Every HTTP route emits request count + duration metrics
-- Slow queries logged automatically — threshold: 50ms dev, 200ms staging, 500ms prod
-- Audit logs for any action that changes permissions, deletes data, or touches billing — append-only, never editable
-
----
-
-## PRISM DESIGN SYSTEM — applies to all UI work
-
-- Never hardcode colours, radii, or font names — use CSS tokens (`var(--token-name)`)
-- Never use pure `#000` or `#fff` as text — use `var(--text-default)` (warm off-black)
-- Three colour layers: neutrals (90% of pixels) · product accent (`--accent`) · AI gradient (`--ai-grad`) — never mix
-- Sparkle star is the only AI glyph — no robots, brains, lightbulbs, wands
-- Never import Tailwind, Radix defaults, or shadcn themes — use `components.tsx` from the design system
-- Touch targets: 44×44px minimum on mobile
-- Mobile inputs: `font-size ≥ 16px` — iOS Safari zooms on focus otherwise
-- Dark mode: `[data-theme="dark"]` selector overrides — never `@media (prefers-color-scheme: dark)` in component CSS
-- Spacing: multiples of 4px only — allowed: 4, 8, 12, 16, 20, 24, 28, 32, 36, 40, 48, 56, 64
-
----
-
-## DOCUMENTATION — always
-
-- ADR for every irreversible architectural decision — written before code merges
-- Every public API documented (OpenAPI 3.1 for HTTP, equivalent for others)
-- README passes the "5 minutes to running" test
-- Every migration is reversible or explicitly documented as one-way
-- Diagrams in code (Mermaid preferred) — never in external tools that drift
-
----
-
-## ASYNC WORK — any language, any queue
-
-- Any work > 1 second belongs in a background job — never block an HTTP handler
-- Every job is idempotent — safe to retry without double side effects
-- Idempotency keys on mutations with external side effects (email, payment, webhook)
-- Jobs have a retry limit with exponential backoff
-- Job failure is observable — dead-letter queue or failure log
-
----
-
-## WHEN TO CHECK FULL DOCS
-
-Full guidelines live in the Obsidian Skills vault:
-- Any UI work → load `prism-design` skill
-- Architecture, service boundaries, DB design → `guidelines/architecture-guidelines.md`
-- Auth, file upload, external APIs, AI features → `guidelines/security-guidelines.md`
-- Tests, refactoring, PR review → `guidelines/code-quality-guidelines.md`
-- Performance, caching, queries → `guidelines/performance-guidelines.md`
-- ADRs, READMEs, API docs → `guidelines/documentation-guidelines.md`
-- New component from scratch → `design/implementation-guide.md`