Quick Start

Not sure where to start?

→ Start Here if AIWG is new to you

→ Find your scenario in the Getting Started guides

These cover the common situations in plain terms: new project, existing code, just trying it out, team setup, writing, auditing, automation.

For a guided first run, use:

aiwg wizard --dry-run --goal "help me start a project"
aiwg status --probe --json

If you can describe the goal but do not know the AIWG term for it, use the Beginner Language Map. Start by asking: "How best can we use AIWG for our situation?"

First-success recipes:

• Ask the steward to route you
• Find one AIWG capability
• Verify AIWG is working

---

Claude Code

Get started in seconds with the Claude Code plugin:

/plugin marketplace add jmagly/ai-writing-guide
/plugin install sdlc@aiwg

That's it. You now have the full SDLC framework with agents and workflow commands.

Full Claude Code Setup Guide - troubleshooting, all plugins, regeneration commands

---

npm + CLI (Multi-Platform)

For CLI tools and deploying to other platforms:

npm install -g aiwg

On macOS, read macOS Install Guide first if global npm installs fail with `EACCES` or if `aiwg` is not found after install. The recommended Mac path is Node 24 through `nvm`, then `npm install -g aiwg`.

Deploy to your project:

cd /path/to/your/project

# New project? Scaffold first:
aiwg -new

# Deploy framework artifacts:
aiwg use sdlc              # Software development
aiwg use marketing         # Marketing campaigns
aiwg use all               # Everything

Then ask your AI assistant to set up the project for AIWG:

Help me set up this project for AIWG.

The agent-led setup conversation should determine the right repository behavior, issue storage, delivery policy, signing expectations, and provider choices for your project. The assistant may use `aiwg setup project` behind the scenes to preview and write the resulting `.aiwg/aiwg.config` policy.

Open in your AI platform and integrate:

cursor .                   # Cursor
droid .                    # Factory AI

`aiwg use` already wired natural-language commands into the project context. On an existing project — or to pull in the latest AIWG on a project you set up earlier — run `/aiwg-regenerate` in the tool to re-tailor that context to your codebase (on a brand-new project it's optional). See the Regenerate Guide for details.

You're ready. See the Intake Guide for starting projects.

---

Other Platforms

Platform	Guide
OpenClaw	Setup Guide
Factory AI	Setup Guide
Warp Terminal	Setup Guide
Cursor	Setup Guide
GitHub Copilot	Setup Guide
OpenCode	Setup Guide
Codex	Setup Guide
OpenHuman	Setup Guide

---

Artifact Types

AIWG deploys five artifact types to every supported platform:

Type	What It Is	Deploy target
Agents	Specialized AI personas (Test Engineer, Security Auditor, etc.)	Platform agents dir
Commands	Slash commands and CLI workflows	Platform commands dir
Skills	NLP-triggered, single-step capabilities	Platform skills dir
Rules	Context-loaded constraints and conventions	Platform rules dir
Behaviors	Reactive capabilities with scripts + event hooks	Platform behaviors dir

Behaviors are new. They are the layer above skills — they subscribe to system events (file writes, deploys, schedules) and react automatically, in addition to being invocable on demand. Behaviors Guide

---

Framework Options (npm install only)

Note: These CLI commands require npm installation (`npm install -g aiwg`). Plugin users get the same agents and commands directly in Claude Code.

Framework	What It's For
`aiwg use sdlc`	Software development lifecycle
`aiwg use marketing`	Marketing campaigns
`aiwg use writing`	Voice profiles, authentic content
`aiwg use all`	All frameworks

---

CLI Reference (npm install only)

The `aiwg` CLI is only available via npm install. Plugin users access all functionality through Claude Code's native interface.

aiwg -new                  # Scaffold new project
aiwg use <framework>       # Deploy framework
aiwg -version              # Show version
aiwg -update               # Update AIWG
aiwg -help                 # All commands

---

Bleeding edge: Install from HEAD of main (may be experimental):

curl -fsSL https://raw.githubusercontent.com/jmagly/ai-writing-guide/main/tools/install/install.sh | bash && source ~/.bash_aliases