autonomousguy 0.6.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Panagiotis Tsilivis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# autonomousguy
+
+[![npm version](https://img.shields.io/npm/v/autonomousguy.svg)](https://www.npmjs.com/package/autonomousguy)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Node.js >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+
+Open-source AI agent skills for embedded automotive engineers - AUTOSAR, MISRA C, ISO 26262 - that give Copilot and Claude the domain context they are missing.
+
+## Install
+
+```shell
+# Install all skills (global)
+npx skills add ptsilivis/autonomousguy -g
+
+# Browse what's inside before installing
+npx skills add ptsilivis/autonomousguy --list
+```
+
+That is all you need. Works with Claude Code, GitHub Copilot, Cursor, Codex, Gemini CLI, and any tool that supports Agent Skills.
+
+## What's inside
+
+10 mode-aware skills covering the ECU software lifecycle. Each skill routes from your input to the right sub-workflow, so one skill handles several related tasks. Start with `codebase-analysis` on a new project: it writes `.autonomousguy/CODEBASE_MAP.md`, which the other skills reference.
+
+The AUTOSAR column states which platform a skill assumes. Skills marked "Classic + Adaptive" default to Classic AUTOSAR (CP) and switch to Adaptive AUTOSAR (AP) when your input names AP concepts (ara::com, ara::exec, C++14, POSIX, service-oriented, manifest).
+
+| Skill | What it does | Platform |
+|---|---|---|
+| `codebase-analysis` | Scans the repo and maps SWCs, BSW usage, port interfaces, RTE API calls, signal flow, and ASIL zones into `CODEBASE_MAP.md`. | Classic + Adaptive |
+| `autosar-swc` | Component design, port interface definition, SWC code, plain-text diagrams, and integration review. | Classic + Adaptive |
+| `autosar-bsw` | BSW config (Com, NvM, Dem, Dcm, Os, MemIf), ARXML debugging, RTE generation troubleshooting, and CAN COM-stack debugging (CanIf -> PduR -> Com). | Classic + Adaptive |
+| `misra` | Audit C against MISRA C:2025 or write code that is compliant by construction. | Classic (MISRA C) |
+| `code-review` | Embedded C correctness review (ISR safety, integer overflow, races, stack) plus AUTOSAR naming-convention audit. | Classic + Adaptive |
+| `requirements` | Elicit, refine, and trace requirements in EARS notation with ASIL attributes. | Neutral |
+| `iso26262` | Run a HARA to assign ASIL, or derive Safety Goals and Functional Safety Requirements with FTTI. | Neutral |
+| `embedded-testing` | Generate MC/DC-covering unit tests and systematic boundary-value test points. | Classic + Adaptive |
+| `embedded-debugging` | Triage a field problem report or debug a specific fault (HardFault, watchdog, Dem event, stack overflow). | Classic + Adaptive |
+| `change-and-impact` | Analyze a change request before work begins, or trace direct and indirect ripple effects with a regression scope. | Classic + Adaptive |
+
+Domain coverage: AUTOSAR Classic (CP) and Adaptive (AP), BSW, MCAL, RTE, AUTOSAR OS, ara::com, ara::exec, SOA, MISRA C, ISO 26262, ASIL, functional safety, ECU, CAN.
+
+## Why it exists
+
+Embedded automotive work carries a lot of domain context - AUTOSAR layering, MISRA C rules, ISO 26262 ASIL logic - that general AI tools do not know. Without it you re-explain the same background on every prompt. These skills encode that context once so the AI gives consistent, expert-level answers without the re-explaining.
+
+## Usage
+
+The two commands above cover most needs. For finer control:
+
+```shell
+# Install one skill (use the name shown by --list)
+npx skills add ptsilivis/autonomousguy --skill autosar-bsw
+
+# Target a specific agent
+npx skills add ptsilivis/autonomousguy -a claude-code
+npx skills add ptsilivis/autonomousguy -a copilot
+
+# Non-interactive (CI)
+npx skills add ptsilivis/autonomousguy -y
+```
+
+After install, each skill lands in your agent's native location (e.g. `.claude/skills/<name>/SKILL.md`). Invoke it the way you invoke any Agent Skill.
+
+## Supported agents
+
+Claude Code, GitHub Copilot, Cursor, Codex, Gemini CLI, opencode, and any tool that supports the Agent Skills convention. Path resolution is handled by the `skills` CLI per agent. Pass `-a <agent>` to target one explicitly; without it the CLI detects installed agents.
+
+## Requirements
+
+- Node.js >=18 (for `npx`).
+- An AI tool that supports Agent Skills.
+
+## Contributing
+
+This is early. Feedback on gaps - missing skills, weak guidance, wrong domain detail - is wanted. Open an issue: https://github.com/ptsilivis/autonomousguy/issues
+
+To work on the repo:
+
+```shell
+git clone https://github.com/ptsilivis/autonomousguy.git
+cd autonomousguy
+node bin/validate.js   # validate skill structure
+```
+
+## Standards and licensing notice
+
+The skills reference two copyrighted standards:
+
+- MISRA C:2025 - (c) The MISRA Consortium Ltd. Sold per-seat; not redistributable.
+- ISO 26262:2018 (all parts) - (c) ISO. Sold per-part; not redistributable.
+
+This library cites rule and clause identifiers (e.g. "MISRA C:2025 Rule 11.3", "ISO 26262-3:2018 Table 4") and paraphrases their intent in its own words. It does not reproduce normative text, rationale, amplification, examples, or full lookup tables. To apply these skills on a real project you must hold a properly licensed copy of each standard. If you spot content that reproduces normative text rather than paraphrasing it, open an issue and it will be rewritten.
+
+## License
+
+MIT (c) [Panagiotis Tsilivis](https://github.com/ptsilivis)

package/bin/validate.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+const glob = require('fs').readdirSync;
+
+const REQUIRED_FM_KEYS = ['name', 'short', 'description', 'category', 'tags'];
+const REQUIRED_SECTIONS = [
+  '## Context',
+  '## Instructions',
+  '## Input expected',
+  '## Output format',
+  '## Example',
+];
+
+function validateFile(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const errors  = [];
+
+  // Check frontmatter
+  const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!fmMatch) {
+    errors.push('missing YAML frontmatter');
+  } else {
+    const fm = fmMatch[1];
+    for (const key of REQUIRED_FM_KEYS) {
+      if (!new RegExp(`^${key}\\s*:`, 'm').test(fm)) {
+        errors.push(`frontmatter missing key: ${key}`);
+      }
+    }
+    // Agent Skills spec: name is lowercase alnum + hyphens, <=64 chars, and
+    // matches the skill directory name; description is <=1024 chars.
+    const dirName = path.basename(path.dirname(filePath));
+    const nameMatch = fm.match(/^name\s*:\s*(.*)$/m);
+    if (nameMatch) {
+      const name = nameMatch[1].trim().replace(/^["']|["']$/g, '');
+      if (!/^[a-z0-9-]{1,64}$/.test(name)) {
+        errors.push(`frontmatter "name" must be lowercase [a-z0-9-], <=64 chars (got "${name}")`);
+      }
+      if (name !== dirName) {
+        errors.push(`frontmatter "name" ("${name}") must match skill directory name ("${dirName}")`);
+      }
+    }
+    const descMatch = fm.match(/^description\s*:\s*(.*)$/m);
+    if (descMatch) {
+      const desc = descMatch[1].trim().replace(/^["']|["']$/g, '');
+      if (desc.length > 1024) {
+        errors.push(`frontmatter "description" is ${desc.length} chars (spec max 1024)`);
+      }
+    }
+    // Catch unquoted ": " in scalar values — silently breaks YAML parsers used
+    // by the upstream `skills` CLI. Quote with double-quotes to fix.
+    for (const key of ['name', 'short', 'description']) {
+      const m = fm.match(new RegExp(`^${key}\\s*:\\s*(.*)$`, 'm'));
+      if (!m) continue;
+      const val = m[1].trim();
+      const quoted = (val.startsWith('"') && val.endsWith('"')) ||
+                     (val.startsWith("'") && val.endsWith("'"));
+      if (!quoted && /: /.test(val)) {
+        errors.push(`frontmatter "${key}" contains unquoted ": " — wrap value in double quotes`);
+      }
+    }
+  }
+
+  // Check sections in order
+  let searchFrom = 0;
+  for (const section of REQUIRED_SECTIONS) {
+    const idx = content.indexOf(section, searchFrom);
+    if (idx === -1) {
+      errors.push(`missing section: ${section}`);
+    } else {
+      searchFrom = idx + section.length;
+    }
+  }
+
+  // Every references/<file> cited in the body must exist next to the skill
+  const skillDir = path.dirname(filePath);
+  const cited = new Set(content.match(/references\/[\w.-]+\.\w+/g) || []);
+  for (const rel of cited) {
+    if (!fs.existsSync(path.join(skillDir, rel))) {
+      errors.push(`cited file does not exist: ${rel}`);
+    }
+  }
+
+  return errors;
+}
+
+function findSkillFiles(dir) {
+  const results = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) results.push(...findSkillFiles(full));
+    else if (entry.name === 'SKILL.md') results.push(full);
+  }
+  return results;
+}
+
+const skillsDir = path.join(__dirname, '..', 'skills');
+const files     = findSkillFiles(skillsDir);
+let   failed    = 0;
+
+for (const file of files) {
+  const errors = validateFile(file);
+  if (errors.length > 0) {
+    const rel = path.relative(process.cwd(), file);
+    for (const err of errors) {
+      console.error(`FAIL  ${rel}: ${err}`);
+    }
+    failed++;
+  }
+}
+
+if (failed > 0) {
+  console.error(`\n${failed} skill file(s) failed validation.`);
+  process.exit(1);
+} else {
+  console.log(`OK  ${files.length} skill files validated.`);
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "autonomousguy",
+  "version": "0.6.4",
+  "description": "AI skill prompts for embedded automotive engineers - Classic and Adaptive AUTOSAR, MISRA C, ISO 26262, ECU development. Install via `npx skills add ptsilivis/autonomousguy`.",
+  "files": [
+    "bin/validate.js",
+    "skills/"
+  ],
+  "homepage": "https://github.com/ptsilivis/autonomousguy#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ptsilivis/autonomousguy.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ptsilivis/autonomousguy/issues"
+  },
+  "keywords": [
+    "autonomousguy",
+    "autosar",
+    "classic-autosar",
+    "adaptive-autosar",
+    "misra",
+    "misra-c",
+    "mcal",
+    "bsw",
+    "ara-com",
+    "embedded",
+    "embedded-automotive",
+    "embedded-systems",
+    "automotive",
+    "ai",
+    "ai-skills",
+    "agent-skills",
+    "skills",
+    "llm-prompts",
+    "iso26262",
+    "safety",
+    "ecu",
+    "automotive-engineering",
+    "claude-code",
+    "github-copilot",
+    "cursor",
+    "gemini-cli",
+    "arxml",
+    "functional-safety"
+  ],
+  "scripts": {
+    "validate": "node bin/validate.js"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}