@olegkoval/agent-skills 1.6.0 → 1.7.0

package/packages/software-development/starter-rules/adapters/windsurf/rules/starter-rules.md

@@ -0,0 +1,61 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+description: "Load and enforce hard rules for every oleg-koval/* starter: 300-line files, E2E tests, pre-commit hooks, Vertical Slice architecture, no comments, KISS/DRY/SOLID."
+---
+
+
+# Starter Rules
+
+## Overview
+
+Load the canonical hard rules for every `oleg-koval/*` starter repo and verify the current repo complies with them. Produces a compliance report and a list of gaps to fix.
+
+## When to Use
+
+- Starting a new coding session in any `oleg-koval/*` template repo
+- Auditing an existing starter for rule compliance before a release or PR merge
+- Onboarding a new contributor (human or AI) to a starter
+- After a large refactor, to verify rules have not been silently violated
+
+Do not use for repos outside the `oleg-koval` namespace unless they explicitly reference `RULES.md`.
+
+## Workflow
+
+1. **Load the rules** — read `RULES.md` from the repo root. If absent, fetch it from `https://github.com/oleg-koval/starters/blob/main/RULES.md` and note that the starter is missing a local copy.
+
+2. **Apply §2 hard rules** — for the current task or PR diff, verify:
+   - No file exceeds 300 lines (`find . -name '*.ts' -o -name '*.py' -o -name '*.go' | xargs wc -l | awk '$1 > 300 && $2 != "total"'`)
+   - No functions produce side effects outside of boundary layers
+   - New code has no WHAT-comments; WHY-comments are one line max
+   - Tests are E2E-first; unit tests only for pure logic with non-trivial branching
+
+3. **Verify hooks and lint** — check that pre-commit hooks are installed and configured:
+   - TypeScript: `cat .eslintrc* | grep max-lines` and `cat package.json | grep -A5 '"lint-staged"\|"husky"\|"lefthook"'`
+   - Python: `cat .pre-commit-config.yaml` and check for `ruff` + format hooks
+   - Go: `cat .golangci.yml` or `.pre-commit-config.yaml` and check for `golangci-lint` + `gofmt`
+
+4. **Check architecture** — for app/SaaS starters: confirm feature code is organized as vertical slices (feature directory contains handler + DTO + service + tests together). For library starters: skip.
+
+5. **Report gaps** — list any violations found in steps 2–4. For each gap:
+   - Name the rule (e.g., "§2.2 file length")
+   - Name the file and line count or violation
+   - Propose the minimal fix
+
+6. **Fix on request** — if the user asks to fix the gaps, apply them one at a time, smallest change first. Do not refactor beyond what the rule requires.
+
+## Reference
+
+Full rule details: [`RULES.md`](./RULES.md)
+
+Architecture options and future starters: `RULES.md §3`
+
+Unix principles: `RULES.md §4`
+
+## Verification
+
+- [ ] `RULES.md` was read from the repo root (or fetched and absence noted)
+- [ ] File length check ran with zero violations, or violations were listed
+- [ ] Pre-commit hooks verified as installed and configured
+- [ ] Compliance report produced listing passed checks and gaps
+- [ ] Any fixes applied do not exceed the scope of the violated rule

package/scripts/build-adapters.sh

@@ -50,6 +50,8 @@ const cursorPlugins = catalog.packages.map((pkg) => ({
 fs.mkdirSync(path.join(root, '.claude-plugin'), { recursive: true })
 fs.mkdirSync(path.join(root, '.cursor-plugin'), { recursive: true })
 fs.mkdirSync(path.join(root, '.github', 'prompts'), { recursive: true })
+fs.mkdirSync(path.join(root, '.windsurf', 'rules'), { recursive: true })
+fs.mkdirSync(path.join(root, '.kiro', 'steering'), { recursive: true })
 
 fs.writeFileSync(
   path.join(root, '.claude-plugin', 'marketplace.json'),
@@ -139,6 +141,47 @@ for (const pkg of catalog.packages) {
   fs.writeFileSync(path.join(root, '.github', 'prompts', promptNameFor(pkg)), prompt)
 }
 
+for (const pkg of catalog.packages) {
+  if (!pkg.adapters.includes('windsurf')) {
+    continue
+  }
+
+  const skillBody = stripFrontmatter(fs.readFileSync(skillPathFor(pkg), 'utf8')).trimEnd()
+  const content = stripTrailingLineWhitespace([
+    generatedHeader,
+    '',
+    '---',
+    `description: ${JSON.stringify(pkg.description)}`,
+    '---',
+    '',
+    skillBody,
+    '',
+  ].join('\n'))
+
+  fs.writeFileSync(path.join(root, '.windsurf', 'rules', `${pkg.name}.md`), content)
+}
+
+for (const pkg of catalog.packages) {
+  if (!pkg.adapters.includes('kiro')) {
+    continue
+  }
+
+  const skillBody = stripFrontmatter(fs.readFileSync(skillPathFor(pkg), 'utf8')).trimEnd()
+  const content = stripTrailingLineWhitespace([
+    generatedHeader,
+    '',
+    '---',
+    'inclusion: manual',
+    `description: ${JSON.stringify(pkg.description)}`,
+    '---',
+    '',
+    skillBody,
+    '',
+  ].join('\n'))
+
+  fs.writeFileSync(path.join(root, '.kiro', 'steering', `${pkg.name}.md`), content)
+}
+
 for (const pkg of catalog.packages) {
   const canonical = fs.readFileSync(skillPathFor(pkg), 'utf8').trimEnd()
 
@@ -161,16 +204,62 @@ for (const pkg of catalog.packages) {
     copySkillResources(pkg, claudeDestDir)
   }
 
-  if (!pkg.adapters.includes('cursor')) {
-    continue
+  if (pkg.adapters.includes('cursor')) {
+    const cursorAdapterDir = path.join(root, pkg.path, 'adapters', 'cursor')
+    const destDir = path.join(cursorAdapterDir, 'skills', pkg.name)
+    fs.mkdirSync(destDir, { recursive: true })
+    fs.writeFileSync(
+      path.join(cursorAdapterDir, 'plugin.json'),
+      JSON.stringify(
+        {
+          name: lookupNameFor(pkg),
+          version: '0.1.0',
+          description: pkg.description,
+          skills: 'skills/',
+        },
+        null,
+        2,
+      ) + '\n',
+    )
+    fs.writeFileSync(path.join(destDir, 'SKILL.md'), [generatedHeader, '', canonical, ''].join('\n'))
+    copySkillResources(pkg, destDir)
   }
 
-  const destDir = path.join(root, pkg.path, 'adapters', 'cursor', 'skills', pkg.name)
-  const destPath = path.join(destDir, 'SKILL.md')
-  fs.mkdirSync(destDir, { recursive: true })
-  fs.writeFileSync(destPath, [generatedHeader, '', canonical, ''].join('\n'))
-  copySkillResources(pkg, destDir)
+  if (pkg.adapters.includes('windsurf')) {
+    const skillBody = stripFrontmatter(canonical).trimEnd()
+    const content = stripTrailingLineWhitespace([
+      generatedHeader,
+      '',
+      '---',
+      `description: ${JSON.stringify(pkg.description)}`,
+      '---',
+      '',
+      skillBody,
+      '',
+    ].join('\n'))
+    const destDir = path.join(root, pkg.path, 'adapters', 'windsurf', 'rules')
+    fs.mkdirSync(destDir, { recursive: true })
+    fs.writeFileSync(path.join(destDir, `${pkg.name}.md`), content)
+  }
+
+  if (pkg.adapters.includes('kiro')) {
+    const skillBody = stripFrontmatter(canonical).trimEnd()
+    const content = stripTrailingLineWhitespace([
+      generatedHeader,
+      '',
+      '---',
+      'inclusion: manual',
+      `description: ${JSON.stringify(pkg.description)}`,
+      '---',
+      '',
+      skillBody,
+      '',
+    ].join('\n'))
+    const destDir = path.join(root, pkg.path, 'adapters', 'kiro', 'steering')
+    fs.mkdirSync(destDir, { recursive: true })
+    fs.writeFileSync(path.join(destDir, `${pkg.name}.md`), content)
+  }
 }
 
-console.log('generated marketplace manifests, Copilot prompts, and Cursor adapter SKILL.md files')
+console.log('generated marketplace manifests, Copilot prompts, Cursor, Windsurf, and Kiro adapter files')
 EOF

package/scripts/validate-catalog.sh

@@ -12,6 +12,8 @@ test -f .claude-plugin/marketplace.json
 test -f .claude-plugin/plugin.json
 test -f .cursor-plugin/index.json
 test -f .github/copilot-instructions.md
+test -d .windsurf/rules
+test -d .kiro/steering
 
 node <<'EOF'
 const fs = require('fs')
@@ -23,6 +25,8 @@ const adapterFiles = {
   codex: (pkg) => path.join(pkg.path, 'adapters', 'codex', 'README.md'),
   cursor: (pkg) => path.join(pkg.path, 'adapters', 'cursor', 'plugin.json'),
   copilot: (pkg) => path.join('.github', 'prompts', `${pkg.name}.prompt.md`),
+  windsurf: (pkg) => path.join(pkg.path, 'adapters', 'windsurf', 'rules', `${pkg.name}.md`),
+  kiro: (pkg) => path.join(pkg.path, 'adapters', 'kiro', 'steering', `${pkg.name}.md`),
 }
 
 const catalog = JSON.parse(fs.readFileSync('catalog/skills.json', 'utf8'))