agentsys 5.0.0

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "agentsys",
+  "version": "5.0.0",
+  "description": "A modular runtime and orchestration system for AI agents - works with Claude Code, OpenCode, and Codex CLI",
+  "main": "lib/platform/detect-platform.js",
+  "type": "commonjs",
+  "bin": {
+    "agentsys": "./bin/cli.js",
+    "agentsys-dev": "./bin/dev-cli.js"
+  },
+  "scripts": {
+    "dev": "node bin/dev-cli.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "validate": "node bin/dev-cli.js validate",
+    "validate:plugins": "node bin/dev-cli.js validate plugins",
+    "validate:agent-skill-compliance": "node bin/dev-cli.js validate agent-skill-compliance",
+    "validate:cross-platform": "node bin/dev-cli.js validate cross-platform",
+    "validate:consistency": "node bin/dev-cli.js validate consistency",
+    "validate:paths": "node bin/dev-cli.js validate paths",
+    "validate:counts": "node bin/dev-cli.js validate counts",
+    "validate:platform-docs": "node bin/dev-cli.js validate platform-docs",
+    "preflight": "node bin/dev-cli.js preflight",
+    "preflight:all": "node bin/dev-cli.js preflight --all",
+    "preflight:release": "node bin/dev-cli.js preflight --release",
+    "gen-docs": "node bin/dev-cli.js gen-docs",
+    "gen-docs:check": "node bin/dev-cli.js gen-docs --check",
+    "expand-templates": "node bin/dev-cli.js expand-templates",
+    "expand-templates:check": "node bin/dev-cli.js expand-templates --check",
+    "gen-adapters": "node bin/dev-cli.js gen-adapters",
+    "gen-adapters:check": "node bin/dev-cli.js gen-adapters --check",
+    "new:plugin": "node bin/dev-cli.js new plugin",
+    "new:agent": "node bin/dev-cli.js new agent",
+    "new:skill": "node bin/dev-cli.js new skill",
+    "new:command": "node bin/dev-cli.js new command",
+    "bump": "node bin/dev-cli.js bump",
+    "detect": "node bin/dev-cli.js detect",
+    "verify": "node bin/dev-cli.js verify",
+    "version": "node scripts/stamp-version.js && git add -A",
+    "prepare": "node bin/dev-cli.js setup-hooks"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avifenesh/agentsys.git"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "agents",
+    "autonomous-agents",
+    "agentic",
+    "claude",
+    "claude-code",
+    "anthropic",
+    "openai",
+    "codex",
+    "opencode",
+    "automation",
+    "workflow",
+    "devtools",
+    "code-review",
+    "multi-agent",
+    "cli",
+    "pr-automation",
+    "productivity",
+    "repo-map",
+    "ast-grep",
+    "drift-detect"
+  ],
+  "author": {
+    "name": "Avi Fenesh",
+    "url": "https://github.com/avifenesh"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/avifenesh/agentsys/issues"
+  },
+  "homepage": "https://github.com/avifenesh/agentsys#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.1"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0"
+  },
+  "workspaces": [
+    "lib"
+  ]
+}

package/plugins/agnix/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "agnix",
+  "version": "5.0.0",
+  "description": "Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins.",
+  "author": {
+    "name": "Avi Fenesh",
+    "email": "[email protected]",
+    "url": "https://github.com/avifenesh"
+  },
+  "homepage": "https://github.com/avifenesh/agnix",
+  "repository": "https://github.com/avifenesh/agentsys",
+  "license": "MIT",
+  "keywords": [
+    "linting",
+    "validation",
+    "agents",
+    "skills",
+    "mcp",
+    "hooks",
+    "claude-code"
+  ]
+}

package/plugins/agnix/agents/agnix-agent.md

@@ -0,0 +1,56 @@
+---
+name: agnix-agent
+description: Lint agent configurations using agnix CLI. Invoke agnix skill and return validation results.
+tools:
+  - Bash(agnix:*)
+  - Bash(cargo:*)
+  - Skill
+  - Read
+  - Glob
+  - Grep
+model: sonnet
+---
+
+# Agnix Agent
+
+Validate agent configuration files using the agnix skill.
+
+## Workflow
+
+### 1. Parse Arguments
+
+Extract from prompt:
+- **path**: Target path (default: `.`)
+- **fix**: Whether to auto-fix
+- **strict**: Whether to treat warnings as errors
+- **target**: Tool-specific rules (claude-code, cursor, codex)
+
+### 2. Invoke Agnix Skill
+
+```
+Skill: agnix
+Args: [path] [--fix] [--strict] [--target=[target]]
+```
+
+The skill contains full CLI documentation and execution steps.
+
+### 3. Return Structured Results
+
+```
+=== AGNIX_RESULT ===
+{
+  "path": ".",
+  "errors": N,
+  "warnings": N,
+  "fixable": N,
+  "fixed": N,
+  "success": true|false
+}
+=== END_RESULT ===
+```
+
+## Constraints
+
+- Do NOT modify files unless `--fix` is passed
+- Return structured data for orchestrator
+- If agnix not installed, return install instructions

package/plugins/agnix/commands/agnix.md

@@ -0,0 +1,139 @@
+---
+description: Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP', or mentions 'agent config issues', 'skill validation'.
+codex-description: 'Use when user asks to "lint agent configs", "validate skills", "check CLAUDE.md", "validate hooks", "lint MCP". Validates agent configuration files against 155 rules across 10+ AI tools.'
+argument-hint: "[path] [--fix] [--strict] [--target [target]]"
+allowed-tools: Task, Read
+---
+
+# /agnix - Agent Config Linter
+
+Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins across Claude Code, Cursor, GitHub Copilot, and Codex CLI.
+
+## Arguments
+
+Parse from $ARGUMENTS or use defaults:
+
+- **Path**: Target path (default: `.`)
+- **--fix**: Auto-fix issues
+- **--strict**: Treat warnings as errors
+- **--target**: `claude-code`, `cursor`, `codex`, or `generic` (default)
+
+## Execution
+
+### Phase 1: Spawn Agnix Agent
+
+```javascript
+const args = '$ARGUMENTS'.split(' ').filter(Boolean);
+const fix = args.includes('--fix');
+const strict = args.includes('--strict');
+
+// Parse --target (supports both --target=value and --target value forms)
+const allowedTargets = ['claude-code', 'cursor', 'codex', 'generic'];
+let rawTarget = 'generic';
+const targetEqIdx = args.findIndex(a => a.startsWith('--target='));
+const targetSpaceIdx = args.findIndex(a => a === '--target');
+if (targetEqIdx !== -1) {
+  rawTarget = args[targetEqIdx].split('=')[1] || 'generic';
+} else if (targetSpaceIdx !== -1 && args[targetSpaceIdx + 1] && !args[targetSpaceIdx + 1].startsWith('-')) {
+  rawTarget = args[targetSpaceIdx + 1];
+}
+const target = allowedTargets.includes(rawTarget) ? rawTarget : 'generic';
+
+// Parse path - exclude flags and --target's value, sanitize to prevent injection
+const excludeIndices = new Set([targetSpaceIdx, targetSpaceIdx + 1].filter(i => i >= 0));
+const path = (args.find((a, i) => !a.startsWith('-') && !excludeIndices.has(i)) || '.').replace(/[\n\r]/g, '');
+
+const result = await Task({
+  subagent_type: "agnix:agnix-agent",
+  prompt: `Validate agent configurations.
+Path: ${path}
+Fix: ${fix}
+Strict: ${strict}
+Target: ${target}
+
+Return structured results between === AGNIX_RESULT === markers.`
+});
+```
+
+### Phase 2: Parse Agent Results
+
+Extract structured JSON from agent output:
+
+```javascript
+function parseAgnix(output) {
+  const match = output.match(/=== AGNIX_RESULT ===[\s\S]*?({[\s\S]*?})[\s\S]*?=== END_RESULT ===/);
+  return match ? JSON.parse(match[1]) : { errors: 0, warnings: 0, diagnostics: [] };
+}
+
+const findings = parseAgnix(result);
+```
+
+### Phase 3: Present Results
+
+#### No Issues
+
+```markdown
+## Validation Passed
+
+No issues found in agent configurations.
+
+- Files validated: N
+- Target: {target}
+```
+
+#### Issues Found
+
+```markdown
+## Agent Config Issues
+
+| File | Line | Level | Rule | Message |
+|------|------|-------|------|---------|
+| SKILL.md | 3 | error | AS-004 | Invalid name |
+| CLAUDE.md | 15 | warning | PE-003 | Generic instruction |
+
+## Summary
+
+- **Errors**: N
+- **Warnings**: N
+- **Fixable**: N
+
+## Do Next
+
+- [ ] Run `/agnix --fix` to auto-fix {fixable} issues
+- [ ] Review remaining issues manually
+```
+
+#### After Fix
+
+```markdown
+## Fixed Issues
+
+| File | Line | Rule | Fix Applied |
+|------|------|------|-------------|
+| SKILL.md | 3 | AS-004 | Renamed to lowercase |
+
+**Fixed**: N issues
+**Remaining**: N issues (manual review needed)
+```
+
+## Supported Files
+
+| File Type | Examples |
+|-----------|----------|
+| Skills | `SKILL.md` |
+| Memory | `CLAUDE.md`, `AGENTS.md` |
+| Hooks | `${STATE_DIR}/settings.json` (Claude: .claude/, OpenCode: .opencode/, Codex: .codex/) |
+| MCP | `*.mcp.json` |
+| Cursor | `.cursor/rules/*.mdc` |
+| Copilot | `.github/copilot-instructions.md` |
+
+## Error Handling
+
+- **agnix not installed**: Show install command `cargo install agnix-cli`
+- **Invalid path**: Exit with "Path not found: [path]"
+- **Parse errors**: Show raw agnix output
+
+## Links
+
+- [agnix GitHub](https://github.com/avifenesh/agnix)
+- [Rules Reference](https://github.com/avifenesh/agnix/blob/main/knowledge-base/VALIDATION-RULES.md)

package/plugins/agnix/skills/agnix/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: agnix
+description: "Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 155 rules across 10+ AI tools."
+version: 5.0.0
+argument-hint: "[path] [--fix] [--strict] [--target=claude-code|cursor|codex]"
+---
+
+# agnix
+
+Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins across 10+ AI tools including Claude Code, Cursor, GitHub Copilot, Codex CLI, OpenCode, Gemini CLI, Cline, Windsurf, Kiro, and Amp.
+
+## Parse Arguments
+
+```javascript
+const args = '$ARGUMENTS'.split(' ').filter(Boolean);
+const targetPath = args.find(a => !a.startsWith('--')) || '.';
+const fix = args.includes('--fix');
+const strict = args.includes('--strict');
+const target = args.find(a => a.startsWith('--target='))?.split('=')[1] || 'claude-code';
+```
+
+## When to Use
+
+Invoke when user asks to:
+- "Lint my agent configs"
+- "Validate my skills"
+- "Check my CLAUDE.md"
+- "Validate hooks"
+- "Lint MCP configs"
+- "Fix agent configuration issues"
+- "Check if my SKILL.md is correct"
+
+## Prerequisites
+
+agnix must be installed. Check with:
+```bash
+agnix --version
+```
+
+If not installed:
+```bash
+cargo install agnix-cli
+```
+
+## Execution
+
+### 1. Validate Project
+
+```bash
+agnix .
+```
+
+### 2. If Issues Found and Fix Requested
+
+```bash
+agnix --fix .
+```
+
+### 3. Re-validate to Confirm
+
+```bash
+agnix .
+```
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `agnix .` | Validate current project |
+| `agnix --fix .` | Auto-fix issues |
+| `agnix --strict .` | Treat warnings as errors |
+| `agnix --target claude-code .` | Only Claude Code rules |
+| `agnix --target cursor .` | Only Cursor rules |
+| `agnix --watch .` | Watch mode - re-validate on changes |
+| `agnix --format json .` | JSON output |
+| `agnix --format sarif .` | SARIF for GitHub Code Scanning |
+
+## Supported Files
+
+| File Type | Examples |
+|-----------|----------|
+| Skills | `SKILL.md` |
+| Memory | `CLAUDE.md`, `AGENTS.md` |
+| Hooks | `${STATE_DIR}/settings.json` |
+| MCP | `*.mcp.json` |
+| Cursor | `.cursor/rules/*.mdc` |
+| Copilot | `.github/copilot-instructions.md` |
+
+## Output Format
+
+```
+CLAUDE.md:15:1 warning: Generic instruction 'Be helpful' [fixable]
+  help: Remove generic instructions. Claude already knows this.
+
+skills/review/SKILL.md:3:1 error: Invalid name [fixable]
+  help: Use lowercase letters and hyphens only
+
+Found 1 error, 1 warning (2 fixable)
+```
+
+Exit codes:
+- `0` - No errors (warnings allowed)
+- `1` - Errors found
+- `2` - Invalid arguments
+
+## Rule Categories
+
+| Prefix | Category | Examples |
+|--------|----------|----------|
+| AS-* | Agent Skills | Name format, triggers, description |
+| CC-* | Claude Code | Hooks, memory, plugins |
+| MCP-* | MCP Protocol | Server config, tool definitions |
+| PE-* | Prompt Engineering | Generic instructions, redundancy |
+| XP-* | Cross-Platform | Compatibility across tools |
+| AGM-* | AGENTS.md | Structure, sections |
+| COP-* | GitHub Copilot | Instructions format |
+| CUR-* | Cursor | MDC format, rules |
+
+## Common Issues & Fixes
+
+| Issue | Solution |
+|-------|----------|
+| Invalid skill name | Use lowercase with hyphens: `my-skill` |
+| Directory/name mismatch | Rename directory to match `name:` field |
+| Generic instructions | Remove "be helpful", "be accurate" |
+| Missing trigger phrase | Add "Use when..." to description |
+
+## Integration
+
+This skill is standalone and can be invoked directly via `/agnix`.
+
+For CI integration, see the [GitHub Action](https://github.com/avifenesh/agnix#github-action).
+
+## Links
+
+- [GitHub](https://github.com/avifenesh/agnix)
+- [Rules Reference](https://github.com/avifenesh/agnix/blob/main/knowledge-base/VALIDATION-RULES.md)
+- [Configuration](https://github.com/avifenesh/agnix/blob/main/docs/CONFIGURATION.md)

package/plugins/audit-project/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "audit-project",
+  "version": "5.0.0",
+  "description": "Multi-agent iterative code review until zero issues remain",
+  "author": {
+    "name": "Avi Fenesh",
+    "email": "[email protected]",
+    "url": "https://github.com/avifenesh"
+  },
+  "homepage": "https://github.com/avifenesh/agentsys#audit-project",
+  "repository": "https://github.com/avifenesh/agentsys",
+  "license": "MIT",
+  "keywords": [
+    "code-review",
+    "quality",
+    "multi-agent",
+    "framework-specific",
+    "iterative"
+  ]
+}