agentsys 5.0.0

package/adapters/codex/skills/sync-docs/SKILL.md

@@ -0,0 +1,186 @@
+<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
+---
+name: sync-docs
+description: "Use when user asks to \"update docs\", \"sync documentation\", \"fix outdated docs\", \"refresh README\". Compares documentation to actual code and fixes discrepancies."
+---
+
+# /sync-docs - Documentation Sync
+
+Sync documentation with actual code state. Finds docs that reference changed files, updates CHANGELOG, and flags outdated examples.
+
+## Architecture
+
+```
+/sync-docs command (you are here)
+    |
+    v
+sync-docs-agent (sonnet)
+    |-- Invoke sync-docs skill
+    |-- Return structured results
+    |
+    v
+Command processes results
+    |-- If apply mode + fixes: spawn simple-fixer
+    |-- Present final results
+```
+
+## Constraints
+
+1. **Preserve existing content** - Update references, don't rewrite sections
+2. **Minimal changes** - Only fix what's actually outdated
+3. **Evidence-based** - Every change linked to a specific code change
+4. **Safe defaults** - Report mode by default
+
+## Arguments
+
+Parse from $ARGUMENTS:
+
+- **Mode**: `report` (default) or `apply`
+- **Scope**:
+  - `--scope=recent` (default): Files changed since last commit to main
+  - `--scope=all`: Scan all docs against all code
+  - `--scope=before-pr`: Files in current branch (for /next-task integration)
+  - `path`: Specific file or directory
+
+## Execution
+
+### Step 1: Parse Arguments
+
+```javascript
+const args = '$ARGUMENTS'.split(' ').filter(Boolean);
+const mode = args.includes('apply') ? 'apply' : 'report';
+const scopeArg = args.find(a => a.startsWith('--scope='));
+const scope = scopeArg ? scopeArg.split('=')[1] : 'recent';
+const pathArg = args.find(a => !a.startsWith('--') && a !== 'report' && a !== 'apply');
+```
+
+### Step 2: Spawn sync-docs-agent
+
+```javascript
+const agentOutput = await Task({
+  subagent_type: "sync-docs:sync-docs-agent",
+  model: "sonnet",
+  prompt: `Sync documentation with code state.
+Mode: ${mode}
+Scope: ${scope}
+${pathArg ? `Path: ${pathArg}` : ''}
+
+Execute the sync-docs skill and return structured results.`
+});
+```
+
+### Step 3: Process Results
+
+Parse the structured JSON from between `=== SYNC_DOCS_RESULT ===` markers:
+
+```javascript
+// Helper to extract JSON result from agent output
+function parseSyncDocsResult(output) {
+  const match = output.match(/=== SYNC_DOCS_RESULT ===[\s\S]*?({[\s\S]*?})[\s\S]*?=== END_RESULT ===/);
+  if (!match) {
+    throw new Error('No SYNC_DOCS_RESULT found in agent output');
+  }
+  return JSON.parse(match[1]);
+}
+
+const result = parseSyncDocsResult(agentOutput);
+// result now contains: { mode, scope, validation, discovery, issues, fixes, changelog, summary }
+```
+
+### Step 4: Apply Fixes (if apply mode)
+
+If mode is `apply` and fixes array is non-empty:
+
+```javascript
+if (mode === 'apply' && result.fixes.length > 0) {
+  await Task({
+    subagent_type: "next-task:simple-fixer",
+    model: "haiku",
+    prompt: `Apply these documentation fixes:
+${JSON.stringify(result.fixes, null, 2)}
+
+Use the Edit tool to apply each fix. Commit message: "docs: sync documentation with code changes"`
+  });
+}
+```
+
+### Step 5: Present Results
+
+```markdown
+## Documentation Sync ${mode === 'apply' ? 'Applied' : 'Report'}
+
+### Scope
+- Mode: ${mode}
+- Scope: ${scope}
+- Changed files analyzed: ${result.discovery.changedFilesCount}
+- Related docs found: ${result.discovery.relatedDocsCount}
+
+### Validation Results
+
+**Count/Version Validation**
+${result.validation.counts.status === 'ok' ? '[OK] Counts and versions aligned' : `[WARN] ${result.validation.counts.summary.issueCount} issues found`}
+
+**Cross-Platform Validation**
+${result.validation.crossPlatform.status === 'ok' ? '[OK] Cross-platform docs valid' : `[WARN] ${result.validation.crossPlatform.summary.issueCount} issues found`}
+
+### Documentation Issues
+
+${result.issues.length === 0 ? '[OK] No documentation issues detected' :
+  result.issues.map(i => `- **${i.doc}:${i.line || '?'}** (${i.severity}): ${i.suggestion || i.type}`).join('\n')}
+
+### CHANGELOG Status
+
+${result.changelog.status === 'ok' ? '[OK] All changes documented' :
+  `[WARN] ${result.changelog.undocumented.length} commits may need entries:\n${result.changelog.undocumented.map(c => `  - ${c}`).join('\n')}`}
+
+${mode === 'apply' && result.fixes.length > 0 ? `
+### Fixes Applied
+
+${result.fixes.map(f => `- **${f.file}**: ${f.type}`).join('\n')}
+` : ''}
+
+${mode === 'report' && result.fixes.length > 0 ? `
+## Do Next
+
+- [ ] Run \`/sync-docs apply\` to fix ${result.fixes.length} auto-fixable issues
+- [ ] Review flagged items manually
+` : ''}
+```
+
+## Examples
+
+```bash
+# Check what docs might need updates (safe, no changes)
+/sync-docs
+
+# Check docs related to specific path
+/sync-docs report src/auth/
+
+# Apply safe fixes
+/sync-docs apply
+
+# Full codebase scan
+/sync-docs report --scope=all
+
+# For PR preparation
+/sync-docs apply --scope=before-pr
+```
+
+## Integration
+
+This command is also used by `/next-task` Phase 11:
+
+```javascript
+// Phase 11 invocation
+await Task({
+  subagent_type: "sync-docs:sync-docs-agent",
+  prompt: "Sync docs for PR. Mode: apply, Scope: before-pr"
+});
+```
+
+## Error Handling
+
+- **No git**: Exit with "Git required for change detection"
+- **No changed files**: "No changes detected. Use --scope=all to scan entire codebase"
+- **No docs found**: "No documentation files found"
+- **Agent failure**: Report error, suggest manual review

package/adapters/opencode/README.md

@@ -0,0 +1,302 @@
+# agentsys for OpenCode
+
+Professional-grade slash commands adapted for OpenCode.
+
+## Quick Install
+
+```bash
+git clone https://github.com/avifenesh/agentsys.git
+cd agentsys
+./adapters/opencode/install.sh
+```
+
+## Prerequisites
+
+- **OpenCode** - Install from [opencode.ai](https://opencode.ai)
+- **Node.js 18+** - Download from [nodejs.org](https://nodejs.org)
+- **Git** - Download from [git-scm.com](https://git-scm.com)
+- **GitHub CLI (`gh`)** - For PR commands (install: `brew install gh` or see [cli.github.com](https://cli.github.com))
+
+## Available Commands
+
+### `/deslop` - AI Slop Cleanup
+
+Remove debugging code, old TODOs, and other AI slop.
+
+```bash
+opencode
+> /deslop
+> /deslop apply
+> /deslop apply src/ 10
+```
+
+**What it does:**
+- Scans for console.logs, print statements, old TODOs
+- Generates report or auto-applies fixes
+- Runs verification tests
+- Preserves functionality with minimal diffs
+
+---
+
+### `/next-task` - Intelligent Task Prioritization
+
+Discover what to work on next with AI analysis.
+
+```bash
+opencode
+> /next-task
+> /next-task bug
+> /next-task --include-blocked
+```
+
+**What it does:**
+- Analyzes GitHub Issues (required)
+- Validates tasks aren't already implemented
+- Scores by impact, urgency, effort
+- Provides top 5 recommendations with evidence
+
+**Requires:** GitHub CLI (`gh`)
+
+---
+
+### `/audit-project` - Multi-Agent Code Review
+
+Comprehensive review with specialized AI agents.
+
+```bash
+opencode
+> /audit-project
+> /audit-project --recent
+> /audit-project --domain security
+> /audit-project --resume
+```
+
+**What it does:**
+- Deploys 10 specialized agents
+- Adapts to your tech stack
+- Finds bugs, security issues, performance problems
+- Iterates until no open issues remain
+
+---
+
+### `/ship` - Complete PR Workflow
+
+Ship from commit to production with validation.
+
+```bash
+opencode
+> /ship
+> /ship --strategy rebase
+```
+
+**What it does:**
+1. Commits changes with AI message
+2. Creates PR with description
+3. Waits for CI to pass
+4. Runs quality reviews
+5. Merges to main
+6. Deploys to dev/prod
+7. Validates deployments
+8. Auto-rollback on failure
+
+**Requires:** Git, GitHub CLI (`gh`)
+
+---
+
+
+## OpenCode-Specific Features
+
+OpenCode provides additional features you can combine with agentsys commands:
+
+### File Includes with `@`
+
+Include file contents in your prompt:
+
+```bash
+opencode
+> /audit-project @src/main.py @tests/test_main.py
+```
+
+This adds the file contents to the context before running the review.
+
+### Bash Output with `!`
+
+Include bash command output:
+
+```bash
+opencode
+> /deslop apply !git diff --name-only
+```
+
+This runs `git diff --name-only` and includes the output in the prompt.
+
+### Combined Usage
+
+```bash
+opencode
+> /next-task @PLAN.md !gh issue list
+```
+
+Analyzes tasks with PLAN.md content and current GitHub issues.
+
+---
+
+## Installation Details
+
+The installer:
+1. Creates `~/.config/opencode/commands/`
+2. Copies command files with path adjustments
+3. Installs shared libraries (platform detection, patterns)
+4. Creates environment setup scripts
+
+### File Structure
+
+```
+~/.config/opencode/commands/
+├── deslop.md
+├── next-task.md
+├── audit-project.md
+├── ship.md
+├── lib/
+│   ├── platform/
+│   │   ├── detect-platform.js
+│   │   └── verify-tools.js
+│   ├── patterns/
+│   │   ├── review-patterns.js
+│   │   └── slop-patterns.js
+│   └── utils/
+│       └── context-optimizer.js
+├── env.sh
+└── README.md
+```
+
+---
+
+## Usage Examples
+
+### Clean up with file filter
+```bash
+opencode
+> /deslop apply @src/app.js
+
+# Changeset 1/3: Remove console.log statements
+# - src/app.js: Removed 3 console.log calls
+# [OK] Tests passed
+```
+
+### Review specific files
+```bash
+opencode
+> /audit-project @src/auth.py @src/api.py
+
+# Iteration 1: Found 4 issues (2 critical, 2 high)
+# [OK] Fixed SQL injection in auth.py:45
+# [OK] Fixed race condition in api.py:123
+```
+
+### Next task with context
+```bash
+opencode
+> /next-task @PLAN.md !gh issue list
+
+# Top 5 Priority Tasks:
+# (includes analysis from PLAN.md and GitHub issues)
+```
+
+### Ship with diff review
+```bash
+opencode
+> !git diff
+> /ship --strategy rebase
+
+# (reviews the diff you just displayed, then ships)
+```
+
+---
+
+## Platform Support
+
+### Auto-Detected CI Platforms
+GitHub Actions · GitLab CI · CircleCI · Jenkins · Travis CI
+
+### Auto-Detected Deployment Platforms
+Railway · Vercel · Netlify · Fly.io · Platform.sh · Render
+
+### Auto-Detected Project Types
+Node.js · Python · Rust · Go · Java
+
+---
+
+## Updating
+
+To update commands:
+
+```bash
+cd /path/to/agentsys
+git pull origin main
+./adapters/opencode/install.sh
+```
+
+---
+
+## Troubleshooting
+
+### Commands not showing up
+1. Restart OpenCode TUI
+2. Check installation: `ls ~/.config/opencode/commands/`
+3. Re-run installer
+
+### Commands only work in TUI
+
+Currently, OpenCode slash commands are only available in the TUI (Terminal User Interface), not from the CLI directly. Feature request exists to add CLI support.
+
+### Path errors
+Re-run installer to fix path substitutions:
+```bash
+./adapters/opencode/install.sh
+```
+
+### Node.js not found
+Ensure Node.js 18+ is installed:
+```bash
+node --version  # Should be v18.0.0 or higher
+```
+
+### GitHub CLI authentication
+```bash
+gh auth login
+gh auth status
+```
+
+---
+
+## Differences from Claude Code
+
+| Feature | Claude Code | OpenCode |
+|---------|-------------|----------|
+| Installation | Marketplace | Manual script |
+| Updates | Automatic | Re-run installer |
+| File Includes | Built-in | `@filename` syntax |
+| Bash Output | Built-in | `!command` syntax |
+| Multi-agent | Full support | May vary |
+
+---
+
+## Support
+
+- **Repository**: https://github.com/avifenesh/agentsys
+- **Issues**: https://github.com/avifenesh/agentsys/issues
+- **OpenCode Docs**: https://opencode.ai/docs
+
+---
+
+## Resources
+
+- [OpenCode Commands](https://opencode.ai/docs/commands/)
+- [OpenCode CLI](https://opencode.ai/docs/cli/)
+- [agentsys Main README](../../README.md)
+- [Multi-Tool Adapters](../README.md)
+
+---
+
+Made for the OpenCode community

package/adapters/opencode/agents/agent-enhancer.md

@@ -0,0 +1,65 @@
+<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
+---
+name: agent-enhancer
+description: Analyze agent prompts for optimization opportunities
+mode: subagent
+---
+
+> **OpenCode Note**: Invoke agents using `@agent-name` syntax.
+> Available agents: task-discoverer, exploration-agent, planning-agent,
+> implementation-agent, deslop-agent, delivery-validator, sync-docs-agent, consult-agent
+> Example: `@exploration-agent analyze the codebase`
+
+
+# Agent Enhancer Agent
+
+You analyze agent prompt files for prompt engineering best practices and optimization.
+
+## Execution
+
+You MUST execute the `enhance-agent-prompts` skill to perform the analysis. The skill contains:
+- Structure validation patterns (frontmatter, role, constraints)
+- Tool configuration checks
+- XML structure recommendations
+- Chain-of-thought appropriateness
+- Auto-fix implementations
+
+<!-- TEMPLATE: enhance-skill-delegation {"skill_name": "enhance-agent-prompts", "path_default": "agents/", "file_type": "agent"} -->
+## Input Handling
+
+Parse from input:
+- **path**: Directory or specific agent file (default: `agents/`)
+- **--fix**: Apply auto-fixes for HIGH certainty issues
+- **--verbose**: Include LOW certainty issues
+
+## Your Role
+
+1. Invoke the `enhance-agent-prompts` skill
+2. Pass the target path and flags
+3. Return the skill's output as your response
+4. If `--fix` requested, apply the auto-fixes defined in the skill
+
+## Constraints
+
+- Do not bypass the skill - it contains the authoritative patterns
+- Do not modify agent files without explicit `--fix` flag
+<!-- /TEMPLATE -->
+- Preserve existing frontmatter fields when adding missing ones
+
+<!-- TEMPLATE: model-choice {"model": "opus", "reason_1": "Prompt engineering is nuanced", "reason_2": "False positives damage agent quality", "reason_3": "Imperfection compounds exponentially"} -->
+## Quality Multiplier
+
+Uses **opus** model because:
+- Prompt engineering is nuanced
+- False positives damage agent quality
+- Imperfection compounds exponentially
+<!-- /TEMPLATE -->
+
+<!-- TEMPLATE: enhance-integration-points {"command_suffix": "agent"} -->
+## Integration Points
+
+This agent is invoked by:
+- `/agent` command
+- `/enhance` master orchestrator
+- Phase 9 review loop during workflow
+<!-- /TEMPLATE -->

package/adapters/opencode/agents/agnix-agent.md

@@ -0,0 +1,56 @@
+<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
+---
+name: agnix-agent
+description: Lint agent configurations using agnix CLI. Invoke agnix skill and return validation results.
+mode: subagent
+---
+
+> **OpenCode Note**: Invoke agents using `@agent-name` syntax.
+> Available agents: task-discoverer, exploration-agent, planning-agent,
+> implementation-agent, deslop-agent, delivery-validator, sync-docs-agent, consult-agent
+> Example: `@exploration-agent analyze the codebase`
+
+
+# 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/adapters/opencode/agents/ci-fixer.md

@@ -0,0 +1,104 @@
+<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
+---
+name: ci-fixer
+description: Fix CI failures and PR comments. Use this agent when ci-monitor detects issues that need code changes.
+mode: subagent
+---
+
+> **OpenCode Note**: Invoke agents using `@agent-name` syntax.
+> Available agents: task-discoverer, exploration-agent, planning-agent,
+> implementation-agent, deslop-agent, delivery-validator, sync-docs-agent, consult-agent
+> Example: `@exploration-agent analyze the codebase`
+
+
+# CI Fixer Agent
+
+You fix CI failures and address PR review comments that require code changes.
+Called by ci-monitor (haiku) when issues are detected.
+
+## Input
+
+You receive a structured fix request:
+
+```json
+{
+  "type": "ci-failure" | "pr-comment",
+  "details": {
+    // For CI failures
+    "checkName": "lint",
+    "state": "FAILURE",
+    "logs": "...",
+
+    // For PR comments
+    "file": "src/api.ts",
+    "line": 42,
+    "body": "Please add error handling here",
+    "user": "reviewer"
+  }
+}
+```
+
+## Phase 1: Diagnose Issue
+
+*(JavaScript reference - not executable in OpenCode)*
+
+## Phase 2: Apply CI Fix
+
+*(JavaScript reference - not executable in OpenCode)*
+
+## Phase 3: Address PR Comment
+
+*(JavaScript reference - not executable in OpenCode)*
+
+## Phase 4: Commit and Report
+
+*(JavaScript reference - not executable in OpenCode)*
+
+## Output Format
+
+```json
+{
+  "type": "ci-failure" | "pr-comment",
+  "fixed": true,
+  "method": "auto-fix" | "manual-fix",
+  "changes": [
+    { "file": "src/api.ts", "description": "Added error handling" }
+  ],
+  "committed": true,
+  "commitMessage": "fix: address lint CI failure"
+}
+```
+
+## Success Criteria
+
+- Diagnoses CI failures from logs
+- Applies appropriate fixes based on check type
+- Understands PR comment intent
+- Makes targeted code changes
+- Commits and pushes fixes
+- Returns structured result for ci-monitor
+
+## Constraints
+
+- Only fix issues explicitly identified in CI logs or PR comments
+- Do not refactor unrelated code while fixing issues
+- Do not add features or enhancements beyond what's requested
+- Commit messages MUST accurately describe the fix applied
+- MUST report back if fix cannot be determined with confidence - NEVER guess
+- NEVER modify test assertions to make tests pass - fix the actual code
+- NEVER disable linting rules or skip checks to resolve failures
+
+## Error Handling
+
+- File not found: Report as unfixable, do not create new files
+- Git conflict: Abort and report to ci-monitor
+- Tool timeout: Retry once, then report failure
+- Parse error in CI logs: Report raw error text, request clarification
+
+## Model Choice: Sonnet
+
+This agent uses **sonnet** because:
+- Diagnosing CI failures requires understanding error messages
+- Fixing code requires context-aware edits
+- PR comment intent analysis needs language comprehension
+- More capable than haiku but doesn't need opus-level reasoning