ai-eng-research

AI Engineering System

AI engineering workflow toolkit for Claude Code and OpenCode with namespaced commands, 38 specialized agents, and reusable skills covering the full development lifecycle from idea to production.

Packages

This repository ships three npm packages:

• @ai-eng-system/core - shared library and content-loading helpers
• @ai-eng-system/toolkit - generated Claude Code, OpenCode, Cursor, Gemini, Pi, and marketplace assets
• @ai-eng-system/cli - executable installer and command-line workflows

The repo root package is private and is never published.

Deploy on Coolify

Scheduled Research Runner (Pi cron on your VPS): docs/deploy/coolify.md

Optional docs site: docs-site/DEPLOYMENT.md

Quick Start

Install the CLI

npm install -g @ai-eng-system/cli

# Install commands, agents, and skills into the current project
ai-eng install --scope project

# Or install globally for OpenCode
ai-eng install --scope global

Claude Code

/plugin marketplace add v1truv1us/ai-eng-system
/plugin install ai-eng-system@ai-eng-marketplace

OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-skills", "ai-eng-system"]
}

OpenCode learning automation now surfaces toast-based suggestions for /ai-eng/decision-journal and /ai-eng/quality-gate, then waits for explicit /ai-eng/learning-approve, /ai-eng/learning-dismiss, or /ai-eng/learning-snooze consent. Local policy and state live under .ai-context/learning/.

Pi

pi install npm:@ai-eng-system/toolkit

Pi loads skills from .pi/skills/ and command prompts from .pi/prompts/ in the toolkit package.

Cursor

See docs/cursor-setup.md. Install @ai-eng-system/toolkit and use the generated .cursor-plugin bundle (skills, agents, and rules/cursor/).

Gemini CLI

See docs/gemini-cli-setup.md. Install @ai-eng-system/toolkit and copy the generated .gemini/ bundle (skills and commands).

Core Workflow

Phase	Command	Purpose
Research	/ai-eng/research	Multi-phase codebase and external research
Specify	/ai-eng/specify	Feature/spec generation with TCRO structure
Plan	/ai-eng/plan	Implementation planning
Work	/ai-eng/work	Guided execution with quality gates
Verify	/verify	Lint, typecheck, test, build gate
Review	/ai-eng/review	Multi-agent code review

Shorthand lifecycle entrypoints:

Shorthand	Canonical Command
/spec	/ai-eng/specify
/build	/ai-eng/work

/ai-eng/plan and /ai-eng/review are direct lifecycle entrypoints with no separate shorthand file.

Related commands:

• /ai-eng/ralph-wiggum - iterative full-cycle workflow
• /ai-eng/simplify - code reuse, quality, and efficiency simplification

What Is Included

• Commands under the ai-eng/ namespace plus shorthand lifecycle entrypoints
• 38 specialized agents
• Skills covering the full development lifecycle (Define, Plan, Build, Verify, Review, Ship) plus repository-specific workflows

Selected commands beyond the core workflow:

• creation: /ai-eng/create-plugin, /ai-eng/create-agent, /ai-eng/create-command, /ai-eng/create-skill, /ai-eng/create-tool
• quality and analysis: /ai-eng/code-review, /ai-eng/agent-analyzer, /ai-eng/fact-check, /ai-eng/deep-research, /ai-eng/content-optimize
• operations: /ai-eng/deploy, /ai-eng/docker, /ai-eng/cloudflare, /ai-eng/github, /ai-eng/k8s, /ai-eng/monitoring, /ai-eng/security-scan
• utilities: /ai-eng/context, /ai-eng/knowledge-capture, /ai-eng/knowledge-architecture, /ai-eng/decision-journal, /ai-eng/quality-gate, /ai-eng/maintenance-review, /ai-eng/learning-approve, /ai-eng/learning-dismiss, /ai-eng/learning-snooze, /ai-eng/init, /ai-eng/seo

Claude marketplace packaging note:

• ai-eng-core keeps the core plan/work/review workflow
• ai-eng-learning now packages /ai-eng/knowledge-architecture, /ai-eng/decision-journal, /ai-eng/quality-gate, /ai-eng/maintenance-review, /ai-eng/learning-approve, /ai-eng/learning-dismiss, and /ai-eng/learning-snooze
• /ai-eng/knowledge-capture remains outside that plugin group

See docs/reference/commands.md for the full command list.

Skills

The generated outputs now preserve namespaced skill paths.

Examples:

• skills/ai-eng/simplify/SKILL.md -> /ai-eng/simplify
• skills/workflow/ralph-wiggum/SKILL.md -> /ai-eng/ralph-wiggum
• skills/comprehensive-research/SKILL.md -> /ai-eng/research
• skills/knowledge-architecture/SKILL.md -> /ai-eng/knowledge-architecture

See docs/reference/skills.md for the full skill inventory.

Optional: GTM skills (opt-in)