AIWG: Reusable Workflows for AI Coding Tools

Overview

AIWG is a TypeScript toolkit for reusable project context and specialist workflows across AI tools such as Claude Code, Codex, Copilot, and Cursor. It addresses the loss of project decisions between sessions by organizing work into reusable instructions and saved artifacts, while letting teams use their existing AI provider.

Its CLI deploys agents, skills, rules, and templates into provider-readable locations. Workflows can share project artifacts in .aiwg/, coordinate specialist reviews, and support tasks across software development, research, operations, and other domains. AIWG supplies procedures and tools, not a model of its own; provider capabilities and optional integrations determine what can run.

Key Features

• Deploy shared workflow assets to multiple AI providers with aiwg use.
• Save project-specific requirements, decisions, reviews, and other artifacts in .aiwg/ for later sessions.
• Use specialist agents and skills for software delivery, security, testing, research, marketing, forensics, and operations.
• Structure reviews as authoring, specialist feedback, synthesis, and human approval where supported.
• Run bounded agent loops with verification, checkpoints, and recovery options.
• Use optional Jev decision support to handle bounded choices such as gates or severity scores, with fallback to the assistant's reasoning.
• Extend the installed capabilities with project-local frameworks, addons, and other custom assets.

Use Cases

• Engineering teams can retain requirements and architecture decisions across sessions, then use them to guide implementation and review.
• Technical leads can organize security, performance, and testability feedback around a shared design artifact before approving a change.
• Researchers can maintain source-linked notes and reuse them in later synthesis work.
• Operators can prepare deployment runbooks, monitoring checks, and rollback plans before a production change.
• Individual developers can install a focused workflow for a bounded review or writing task without adopting a full project lifecycle.

Getting Started

With Node.js 24 or newer, install and deploy the complete asset set:

npm i -g aiwg
cd /path/to/your/project
aiwg use all --provider claude

Replace claude with your provider selector. See the README for setup guidance, supported providers, and framework choices.

Alternatives

• compound-engineering-plugin: Focuses on an end-to-end cycle of brainstorming, planning, implementation, review, and captured learnings rather than deploying broader project context and specialist agents.
• agent-skills: Provides skills for specification, implementation, review, testing, and sprints, rather than a CLI for deploying project context and workflows across providers.
• agent-skills: Offers a portable Markdown skill pack for engineering workflows, rather than project artifacts and a TypeScript deployment CLI.
• agent-feed: Installs repository-owned instructions, task and review gates, and tool adapters, rather than a broader library of project context and specialist agents.

Considerations

• AIWG is actively developed, with regular commits and releases and recent issue and pull-request activity. However, its contributor base is small and work is overwhelmingly concentrated in one person, creating a maintainer-dependency risk.
• Node.js 24 or newer is required. The base install excludes some native features that require explicit opt-in; those features are not necessary for core deployment.
• Installing workflow assets does not start optional servers, storage services, or orchestration components. Those have separate prerequisites and configuration.
• Provider support varies. A role definition is not a separate model, and a written rule does not by itself enforce a constraint. Parallel reviews and recovery behavior depend on the provider and environment.
• The project describes its workflows as support for review and verification, not a guarantee of correct results, citations, or unattended completion.