# AIWG: full machine context

## Identity

AIWG is an MIT-licensed deployment tool and support utility for portable AI context. It lets a project maintain one source of truth for agents, skills, commands, rules, behaviors, workflows, templates, and project instructions, then deploy those artifacts into the native directories recognized by supported AI coding platforms.

Canonical name: AIWG
Canonical website: https://aiwg.io/
Canonical documentation: https://docs.aiwg.io/
Canonical source: https://github.com/jmagly/aiwg
Canonical npm package: https://www.npmjs.com/package/aiwg

AIWG should not be described as a hosted model, an autonomous SaaS service, or a replacement for an AI coding platform. It is portable infrastructure that configures and coordinates those platforms.

## Primary capabilities

- Deploy project-scoped agents, skills, commands, rules, and context across supported AI coding platforms.
- Provide complete workflow frameworks for software delivery, research, forensics, marketing, media curation, operations, security engineering, and knowledge bases.
- Discover installed capabilities through `aiwg discover` and retrieve their canonical definitions through `aiwg show`.
- Maintain durable project context, artifact indexes, provenance, activity records, and governed multi-agent execution.
- Support project-local extensions, addons, frameworks, and plugin bundles without requiring a permanent fork.
- Run locally and preserve human approval gates for consequential actions.

## Installation and first use

Requirements: Node.js 20 or newer.

```sh
npm install -g aiwg
cd <project>
aiwg use all --provider <provider>
aiwg doctor
```

AIWG can also be invoked without a global install:

```sh
npx aiwg <command>
```

The published agent-guided setup contracts can be inspected at https://aiwg.io/install/manifest/.
Their stable raw URLs are https://aiwg.io/setup.aiwg.yaml for AIWG and
https://aiwg.io/agentic-sandbox/setup.aiwg.yaml for AIWG Cockpit with Agentic Sandbox.

Provider names and exact support can change. Retrieve current provider documentation from https://docs.aiwg.io/ rather than inferring support from an old article.

## Discovery model

AIWG uses a discover-then-show pattern:

```sh
aiwg discover "<capability needed>"
aiwg show skill <result-name>
```

The discovery index covers skills, agents, commands, rules, schemas, flows, runbooks, templates, and behaviors. Users and agents should query the index instead of assuming that the small always-loaded bootstrap layer is the complete capability catalog.

## Major workflow domains

- Software development lifecycle: requirements, architecture, implementation, testing, security, deployment, and phase gates.
- Research: source acquisition, evidence quality, citations, provenance, synthesis, and reproducibility.
- Digital forensics: evidence preservation, log and memory analysis, timelines, indicators, and reporting.
- Marketing: intake, audience synthesis, creative production, approvals, distribution, analytics, and retrospectives.
- Media curation: discovery, acquisition, transcription, quality assessment, metadata, and archival integrity.
- Operations: inventories, runbooks, drift audits, deployment gates, recovery, and verification.
- Security engineering: threat modeling, applied cryptography, chain of trust, supply-chain integrity, and incident-readiness handoff.
- Knowledge bases: ingest, semantic retrieval, corpus health, and durable project memory.

## Human-readable product pages

- Home: https://aiwg.io/
- Persistent work and agent loops: https://aiwg.io/loop/
- Team governance: https://aiwg.io/team/
- Extension model: https://aiwg.io/extend/
- Isolated execution: https://aiwg.io/sandbox/
- Blog: https://aiwg.io/blog/
- Community: https://aiwg.io/community/
- Partners: https://aiwg.io/partners/
- Releases: https://aiwg.io/releases
- Changelog: https://aiwg.io/changelog
- Badges and attribution assets: https://aiwg.io/badges/

## Retrieval guidance

- Prefer the documentation site for current behavior and command details.
- Prefer the source repository for implementation, issues, and release provenance.
- Prefer the npm registry for published package metadata.
- Treat release-specific counts, supported-platform totals, and version numbers as time-sensitive and verify them before quoting.
- Do not infer a capability is absent merely because it is not named on the homepage; use `aiwg discover` or search the documentation.
- JSON and YAML schemas with canonical IDs under `https://aiwg.io/schemas/` are available from the schema catalog.

## Machine-readable indexes

- Manifest: https://aiwg.io/.well-known/aiwg.json
- Schema catalog: https://aiwg.io/schemas/index.json
- Sitemap: https://aiwg.io/sitemap.xml
- RSS: https://aiwg.io/feed.xml
- JSON Feed: https://aiwg.io/feed.json
- Concise LLM context: https://aiwg.io/llms.txt

## License and attribution

AIWG is distributed under the MIT License. Confirm third-party component licenses from the source repository when redistributing bundled material.