agentic-web-developer 1.0.8 → 2.0.0

package/README.md

@@ -1,26 +1,27 @@
 # agentic-web-developer
 
-An **agentic skill** that turns an AI coding agent into a complete web-development and website-selling system
+An **agentic skill** that turns an AI coding agent into a complete web-development and website-selling system — organized as **10 departments** (Strategy → Research → Content → Design → Frontend → Backend → Motion → QA → Deploy → Growth), each with its own slash command (`/agentic-web-developer-<dept>`, short alias `/awd-<dept>`).
 
 Plus a **novel-idea / product-launch mode** for websites not covered by the videos (SaaS, products, marketplaces).
 
 And a **Mode C** for advanced 3D / WebGL sites — cinematic Three.js builds in the style of Kage and Towers.
 
-Plus a **Mode D** for design-sketch intake — hand over your sketches/wireframes and the skill reads the pages and layouts off them, confirms an inventory, and runs only the stages needed.
+Plus a **Mode D** for design-sketch intake — hand over your sketches/wireframes and the skill reads the pages and layouts off them, confirms an inventory, and runs only the departments needed.
 
 > **Licensed — Pro plan ($7/month).** The skill validates an Animotion **Pro key** (or staff admin credentials) once per session before doing any work. [![Get Pro — $7/mo](https://img.shields.io/badge/Get_Pro-%247%2Fmonth-38ED26)](https://skills.animotion.click/checkout?plan=pro) [![Get Studio — $15/mo](https://img.shields.io/badge/Get_Studio-%2415%2Fmonth-222222)](https://skills.animotion.click/checkout?plan=studio) — payment steps, install-with-key commands and credential setup: **[License & unlocking](#license--unlocking-the-skill)** · full guide **[docs/LICENSING.md](docs/LICENSING.md)**.
 
 ## What you get
 
-- **Stage-gated pipeline** (Intake → Niche → Research → Design → Build → QA → Animation handoff → Deploy → Sell) where the agent **asks for your input at every step** — it never runs ahead on assumptions.
+- **10-department system** — Strategy (intake, mode, validation) · Research (design DNA + competitor intelligence) · Content (all the copy, agent-written) · Design (UI/UX + generated assets) · Frontend (framework, scaffold, build) · Backend (server-side, *only on request*) · Motion (motion brief + AnimotionJS handoff) · Quality Assurance (conversion, a11y, perf, SEO) · Deployment (ship + verify) · Growth (launch, outreach, monetization) — **one gate per stage, progress footer on every response**, the agent **never runs ahead on assumptions**.
+- **Slash commands** — `/awd-strategy`, `/awd-research`, `/awd-content`, `/awd-design`, `/awd-frontend`, `/awd-backend`, `/awd-motion`, `/awd-qa`, `/awd-deploy`, `/awd-growth` (plus full `/agentic-web-developer-*` names and the `/agentic-web-developer` router). Installed globally for **opencode** and **Claude Code**; `--no-commands` to skip.
 - **Four modes** — Mode A build-and-sell, Mode B novel idea / product launch, Mode C advanced 3D / WebGL experience, Mode D design-sketch intake.
 - **Dev-mode toolkit (opt-in, removable)** — a live CSS styling toolbar plus a prototyping toolbar (hotspots, viewport switcher, grid/measure, states, annotations), gated behind an ask-first question and wrapped in one flag / one marked block so it's fully stripped before production.
 - **Knowledge base** — 8 distilled technique files from Meng To's public skills (video → analysis prompts, interaction-prompt packs, full-page capture, inspiration bundles, the single-file demo contract, 16 3D techniques, 14 SVG illustration styles, ThreeUI components), indexed so the agent consults them instead of improvising.
-- **User's asks are law** — explicit requirements are implemented exactly as stated; the skill's own machinery (modes, research, toolkit) is offered, never forced.
+- **User's asks are law** — explicit requirements are implemented exactly as stated; the skill's own machinery (modes, research, toolkit) is offered, never forced. The agent generates all copy and assets — you supply facts, brand assets and the inspiration pack.
 - **Design-tool agnostic** — Figma, Paper, Google Stitch, Google AI Studio, Framer or code-first. You supply the credentials/MCP for your tool of choice.
 - **Framework agnostic** — Next.js, React, Vue, Svelte, Astro, plain HTML, WordPress, GoHighLevel — you pick.
 - **All animation is delegated** to the [AnimotionJS agentic skill](https://skills.animotion.click/checkout) — this skill never writes animation code itself.
-- 15 reference playbooks, a knowledge base (`references/knowledge-base/` — 8 distilled technique files + index), and 5 ready-to-fill templates (builder brief, scaffold HTML, `siteconfig.ts`, outlier anatomy, 3D scene brief).
+- 15 reference playbooks, 10 department playbooks, a knowledge base (`references/knowledge-base/` — 8 distilled technique files + index), and 7 ready-to-fill templates (builder brief, scaffold HTML, `siteconfig.ts`, outlier anatomy, 3D scene brief, copy, QA report).
 
 ## Install
 
@@ -41,7 +42,9 @@ npx agentic-web-developer install --all
 npx agentic-web-developer detect
 ```
 
-Other flags: `--license-key=<key>` (save your Pro key during install — see [License & unlocking](#license--unlocking-the-skill)), `--admin-email` / `--admin-secret` (staff), `--force` (overwrite), `--dry-run` (print targets only), `--dir=<path>` (custom destination), `--source=<url|path>` / `--token=<key>` (skill source).
+Other flags: `--license-key=<key>` (save your Pro key during install — see [License & unlocking](#license--unlocking-the-skill)), `--admin-email` / `--admin-secret` (staff), `--force` (overwrite), `--dry-run` (print targets only), `--dir=<path>` (custom destination), `--source=<url|path>` / `--token=<key>` (skill source), `--no-commands` (skip the slash commands).
+
+For **opencode** and **Claude Code**, the installer also writes the **slash commands** globally — `/agentic-web-developer` plus `/agentic-web-developer-<dept>` and the `/awd-<dept>` aliases — to `~/.config/opencode/command/` and `~/.claude/commands/`.
 
 Then **restart your AI agent** so it loads the skill.
 
@@ -55,7 +58,7 @@ Then **restart your AI agent** so it loads the skill.
 
 `opencode` · `claude` · `copilot` · `cursor` · `windsurf` · `codex` · `cline` · `roo` · `cody` · `codium` · `aider` · `continue` · `augment` · `amazonq` · `jetbrains`
 
-The installer writes **each agent's own file format** with the right frontmatter — `SKILL.md` for skill agents, `skill.md` for Windsurf/Codium, `rules/*.mdc` for Cursor, `rules/*.md` for Continue/Augment/Amazon Q, `CONVENTIONS.md` for Aider — and puts the `references/` + `templates/` payload where that agent can read it. Same 15 agents as the AnimotionJS skill.
+The installer writes **each agent's own file format** with the right frontmatter — `SKILL.md` for skill agents, `skill.md` for Windsurf/Codium, `rules/*.mdc` for Cursor, `rules/*.md` for Continue/Augment/Amazon Q, `CONVENTIONS.md` for Aider — and puts the `references/` + `templates/` + `departments/` payload where that agent can read it. Same 15 agents as the AnimotionJS skill.
 
 ### Manual install (no CLI)
 
@@ -67,13 +70,11 @@ The skill ships behind the **Animotion Pro plan — $7/month**. One validation p
 
 ### How to pay for Pro
 
-1. **Click a Get Pro button** (top of this README or above) — opens [`skills.animotion.click/checkout?plan=pro`](https://skills.animotion.click/checkout?plan=pro) with Pro preselected ($7/month). Studio ($15/month) also unlocks this skill *and* the AnimotionJS animation skill you need at Stage 8.
+1. **Click a Get Pro button** (top of this README or above) — opens [`skills.animotion.click/checkout?plan=pro`](https://skills.animotion.click/checkout?plan=pro) with Pro preselected ($7/month). Studio ($15/month) also unlocks this skill *and* the AnimotionJS animation skill you need at the Motion department.
 2. **Enter your email** — the license is tied to it.
 3. **Continue to Payment** → Stripe's hosted checkout (card).
 4. **Confirm** — monthly, cancel anytime.
-5. **Copy your key** (`sec_live_…`) from the confirmation page.
-
-### How to give the skill your key (or admin credentials)
+5. **Copy your key** (`sec_live_…`) from the confirmation page.### How to give the skill your key (or admin credentials)
 
 Pick one — the gate looks for environment variables first, then the installer's config file, then asks you once:
 
@@ -142,7 +143,7 @@ npx animotion-skills install --tier=agentic --all --license-key=YOUR_KEY
 - License key (Studio plan, $15/month): https://skills.animotion.click/checkout
 - Local source on the author's machine: `C:\Users\creat\Projects\Animotionjs\animotion-skills`
 
-Without it, the skill will still design and build — but it will stop at Stage 8 and ask you to install Animotion before any motion work.
+Without it, the skill will still design and build — but it will stop at the Motion department and ask you to install Animotion before any motion work.
 
 ## Using the skill
 
@@ -154,18 +155,26 @@ Just talk to your agent:
 > "I have design sketches — turn them into a website"
 > "Use the agentic-web-developer skill"
 
-The agent classifies the project (Mode A: build-and-sell, Mode B: novel idea, Mode C: advanced 3D/WebGL, Mode D: design-sketch intake), then walks you through every gate.
+Or jump straight into a department (opencode + Claude Code, after install):
+
+> `/awd-design` — enter the Design department directly
+> `/agentic-web-developer-qa` — full-name form of the same command
+> `/agentic-web-developer` — router (starts at Strategy unless you name a department)
+
+The agent classifies the project (Mode A: build-and-sell, Mode B: novel idea, Mode C: advanced 3D/WebGL, Mode D: design-sketch intake), then walks you through every gate — one department at a time, with a progress footer on every response.
 
 ## Project layout
 
 ```
 agentic-web-developer/
 ├── package.json          # npm manifest (bin: agentic-web-developer, awd.source)
-├── bin/install.js        # zero-dependency installer CLI (all 15 agents, per-agent formats)
+├── bin/install.js        # zero-dependency installer CLI (all 15 agents, per-agent formats, slash commands)
+├── commands/             # 11 slash-command files (router + 10 departments; installer derives /awd-* aliases)
 ├── skill/                # ← the skill itself (source of truth; never published)
-│   ├── SKILL.md
-│   ├── references/       # 11 playbooks (incl. licensing.md)
-│   └── templates/        # 5 fill-in templates (incl. 3D scene brief)
+│   ├── SKILL.md          # the router: license gate, 13 non-negotiables, department map, modes, footer spec
+│   ├── departments/      # 10 department playbooks + INDEX + DEPARTMENT-TEMPLATE
+│   ├── references/       # 15 playbooks (incl. licensing.md)
+│   └── templates/        # 7 fill-in templates (incl. 3D scene brief, copy, QA report)
 ├── docs/                 # ← the only content tracked in Git
 │   ├── INSTALL.md        # install guide for all 15 agents
 │   ├── EXAMPLES.md       # worked walkthroughs: Mode A + Mode B

package/bin/install.js

@@ -4,7 +4,7 @@
  *
  *   npx agentic-web-developer install [--agent=<key>|all] [--source=<url|path>] [--token=<key>]
  *                                     [--license-key=<key> | --admin-email=<e> --admin-secret=<s>]
- *                                     [--force] [--dry-run] [--dir=<path>]
+ *                                     [--force] [--dry-run] [--dir=<path>] [--no-commands]
  *   npx agentic-web-developer detect
  *
  * The npm package ships only this installer (+ docs). The skill payload is
@@ -245,6 +245,95 @@ function copyRecursive(src, dest) {
 function installPayload(payloadDir, skillDir) {
   copyRecursive(path.join(skillDir, "references"), path.join(payloadDir, "references"));
   copyRecursive(path.join(skillDir, "templates"), path.join(payloadDir, "templates"));
+  if (fs.existsSync(path.join(skillDir, "departments"))) {
+    copyRecursive(path.join(skillDir, "departments"), path.join(payloadDir, "departments"));
+  }
+}
+
+/* ------------------------------ slash commands ------------------------------ */
+// Installed globally for opencode (~/.config/opencode/command/) and Claude Code
+// (~/.claude/commands/). Each full-name command file (agentic-web-developer-<slug>.md)
+// also gets a short alias (awd-<slug>.md) derived from the filename.
+
+const COMMANDS = {
+  opencode: {
+    name: "OpenCode",
+    // fallback order: last entry wins when none exists — prefer ~/.config/opencode/command
+    dirs: [
+      path.join(HOME, ".opencode", "command"),
+      path.join(HOME, ".config", "opencode", "command")
+    ]
+  },
+  claude: {
+    name: "Claude Code",
+    // Claude Code reads user commands from ~/.claude/commands
+    dirs: [path.join(HOME, ".claude", "commands")]
+  }
+};
+
+// commands/ lives next to the skill folder (repo root) or inside it.
+function resolveCommandsSource(skillDir) {
+  const nested = path.join(skillDir, "commands");
+  if (fs.existsSync(nested)) return nested;
+  const sibling = path.join(path.dirname(skillDir), "commands");
+  if (fs.existsSync(sibling)) return sibling;
+  return null;
+}
+
+function pickCommandDir(cmd) {
+  for (const d of cmd.dirs) {
+    if (fs.existsSync(d)) return d;
+  }
+  return cmd.dirs[cmd.dirs.length - 1];
+}
+
+function commandDestPaths(key) {
+  if (flags.dir) {
+    return { dir: path.join(path.resolve(flags.dir), "commands") };
+  }
+  const cmd = COMMANDS[key];
+  if (!cmd) return null;
+  return { dir: pickCommandDir(cmd) };
+}
+
+// Writes every command file + derived awd-* alias. Returns written/skipped counts.
+function installCommands(skillDir, key) {
+  const spec = commandDestPaths(key);
+  if (!spec) return null;
+  const src = resolveCommandsSource(skillDir);
+  if (!src) return null;
+
+  let written = 0;
+  let skipped = 0;
+  if (flags["dry-run"]) {
+    const names = fs.readdirSync(src).filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, ""));
+    const all = names.flatMap((n) =>
+      n.startsWith(`${SKILL_NAME}-`) ? [n, `awd-${n.slice(SKILL_NAME.length + 1)}`] : [n]
+    );
+    console.log(`          cmds: ${spec.dir}{/${all.join(", /")}}`);
+    return { dir: spec.dir, written: 0, skipped: all.length, dryRun: true };
+  }
+
+  fs.mkdirSync(spec.dir, { recursive: true });
+  for (const entry of fs.readdirSync(src)) {
+    if (!entry.endsWith(".md")) continue;
+    const base = entry.replace(/\.md$/, "");
+    const targets = [entry];
+    if (base.startsWith(`${SKILL_NAME}-`)) {
+      targets.push(`awd-${base.slice(SKILL_NAME.length + 1)}.md`);
+    }
+    const body = fs.readFileSync(path.join(src, entry), "utf8");
+    for (const t of targets) {
+      const dest = path.join(spec.dir, t);
+      if (fs.existsSync(dest) && !flags.force) {
+        skipped++;
+        continue;
+      }
+      fs.writeFileSync(dest, body);
+      written++;
+    }
+  }
+  return { dir: spec.dir, written, skipped, dryRun: false };
 }
 
 /* ------------------------- license config (the gate) ----------------------- */
@@ -432,10 +521,23 @@ function detect() {
     }
     if (installed && !fs.existsSync(payloadDir)) installed = false;
     if (present) found++;
-    const status = installed ? "INSTALLED" : present ? "not installed" : "agent not found";
+    let status = installed ? "INSTALLED" : present ? "not installed" : "agent not found";
+    // slash commands (opencode + claude only)
+    let cmdNote = "";
+    if (COMMANDS[key]) {
+      const dir = pickCommandDir(COMMANDS[key]);
+      const mainCmd = path.join(dir, `${SKILL_NAME}.md`);
+      const aliasCmd = path.join(dir, "awd-strategy.md");
+      if (fs.existsSync(mainCmd) || fs.existsSync(aliasCmd)) {
+        cmdNote = `  cmds: ${dir}`;
+      } else if (installed) {
+        cmdNote = "  cmds: not installed";
+      }
+    }
     console.log(
       `  ${present || installed ? "*" : " "} ${key.padEnd(10)} ${agent.name.padEnd(20)} ${status}` +
-        (installed ? `  -> ${mainFile}` : "")
+        (installed ? `  -> ${mainFile}` : "") +
+        cmdNote
     );
   }
   console.log(`\n  Install: npx ${SKILL_NAME} install --agent=<key>   (or --all, or omit --agent for auto)\n`);
@@ -473,8 +575,9 @@ async function install() {
     if (flags["dry-run"]) {
       console.log(`[dry-run] ${agent.name} (${key})`);
       console.log(`          main: ${mainFile}`);
-      console.log(`          refs: ${payloadDir}{/references, /templates}`);
+      console.log(`          refs: ${payloadDir}{/references, /templates, /departments}`);
       if (licenseFlagsPresent()) console.log(`          lic:  ${path.join(payloadDir, "animotion-config.json")}`);
+      if (!flags["no-commands"]) installCommands(skillDir, key);
       done++;
       continue;
     }
@@ -490,6 +593,12 @@ async function install() {
       console.log(`skip ${agent.name}: already installed at ${mainFile} (use --force to overwrite)`);
       const existingCfg = writeLicenseConfig(payloadDir);
       if (existingCfg) console.log(`  license config: ${existingCfg}`);
+      if (!flags["no-commands"]) {
+        const cmds = installCommands(skillDir, key);
+        if (cmds && !cmds.dryRun) {
+          console.log(`  commands: ${cmds.written} written, ${cmds.skipped} kept -> ${cmds.dir}`);
+        }
+      }
       continue;
     }
 
@@ -514,6 +623,12 @@ async function install() {
     console.log(`  main: ${mainFile}`);
     console.log(`  refs: ${payloadDir}`);
     if (cfgFile) console.log(`  license config: ${cfgFile}`);
+    if (!flags["no-commands"]) {
+      const cmds = installCommands(skillDir, key);
+      if (cmds && !cmds.dryRun) {
+        console.log(`  commands: ${cmds.written} written, ${cmds.skipped} kept -> ${cmds.dir}`);
+      }
+    }
     done++;
   }
 
@@ -573,10 +688,19 @@ Options:
   --dry-run       Print target paths without copying
   --dir=<path>    Install into <path>/${SKILL_NAME} (flat, SKILL.md layout)
   --home=<path>   Use <path> as the home directory (testing)
+  --no-commands   Skip installing the slash commands (/agentic-web-developer-* + /awd-*)
 
 Skill source order: --source > AWD_SOURCE > ./skill > package.json awd.source
 The npm package ships only this installer (+ docs) — never the skill source.
 
+Slash commands (opencode + claude, unless --no-commands):
+  /agentic-web-developer                     router (starts at Strategy)
+  /agentic-web-developer-<dept>              full name per department
+  /awd-<dept>                                short alias (strategy, research, content,
+                                             design, frontend, backend, motion, qa,
+                                             deploy, growth)
+  -> opencode: ~/.config/opencode/command/   claude: ~/.claude/commands/
+
 Each agent gets its own file format:
   skill agents (opencode, claude, copilot, cody, codex, roo, cline, jetbrains)
                             -> <skills>/${SKILL_NAME}/SKILL.md

package/commands/agentic-web-developer-backend.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Backend department (APIs, forms, auth, payments, CMS, databases — runs only on request)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Backend** department: read `departments/backend.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing: what server-side work, data, stack, services), one gate per stage, record answers, append the **progress footer** to every response. Security and tests are part of "done".
+4. Handoff when complete: the next department is **Motion** (`/awd-motion`) — offer to continue.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-content.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Content department (messaging strategy, all site copy, SEO metadata — the agent writes it)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Content** department: read `departments/content.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only for missing factual business details: real testimonials, stats, contacts, pricing — never invent them), one gate per stage, record answers, append the **progress footer** to every response.
+4. Handoff when complete: the next department is **Design** (`/awd-design`) — offer to continue.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-deploy.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Deployment (pick the target, strip dev artifacts, ship, verify live)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Deployment** department: read `departments/deploy.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing: target, domain, repo, CI, secrets), one gate per stage, record answers, append the **progress footer** to every response. The deployment target is the user's choice; the dev toolkit never ships.
+4. Handoff when complete: the next department is **Growth** (`/awd-growth`) — offer to continue.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-design.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Design department (tool selection, UI/UX design, generated asset production)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Design** department: read `departments/design.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing: design tool + credentials, asset inventory), one gate per stage, record answers, append the **progress footer** to every response. The agent generates all assets; only reference + brand assets come from the user.
+4. Handoff when complete: the next department is **Frontend** (`/awd-frontend`) — offer to continue.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-frontend.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Frontend department (framework selection, scaffold, full site build)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Frontend** department: read `departments/frontend.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing: framework, dev-toolkit yes/no), one gate per stage, record answers, append the **progress footer** to every response. Never write animation code — static states only.
+4. Handoff when complete: offer **Backend** (`/awd-backend`) only if the user needs server-side work; otherwise the next department is **Motion** (`/awd-motion`).
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-growth.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Growth (launch, outreach sequences, monetization, analytics — the terminal department)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Growth** department: read `departments/growth.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing: launch scope, outreach capacity, analytics preference, monetization stance), one gate per stage, record answers, append the **progress footer** to every response. Ethics first: compliance-checked outreach, honest claims.
+4. When complete, use the delivery-complete footer variant (no Next line) and offer: re-run any department, or a new project via `/awd-strategy`.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-motion.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Motion department (motion brief + AnimotionJS handoff — animation is never hand-written)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Motion** department: read `departments/motion.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing: Animotion installed, motion appetite), one gate per stage, record answers, append the **progress footer** to every response. You never write animation code — if Animotion isn't installed, stop and install it.
+4. Handoff when complete: the next department is **Quality Assurance** (`/awd-qa`) — offer to continue.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-qa.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Quality Assurance (conversion/UX QA, performance/a11y/SEO audit, responsive & regression pass)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Quality Assurance** department: read `departments/qa.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing: test surface, tooling), one gate per stage, record answers, append the **progress footer** to every response. Fix issues without altering the approved design language.
+4. Handoff when complete: the next department is **Deployment** (`/awd-deploy`) — offer to continue.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-research.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Research department (design DNA extraction + outlier competitor intelligence)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Research** department: read `departments/research.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing; flag any prerequisite from Strategy that is missing), one gate per stage, record answers, append the **progress footer** to every response.
+4. Handoff when complete: the next department is **Content** (`/awd-content`) — offer to continue.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer-strategy.md

@@ -0,0 +1,12 @@
+---
+description: Agentic Web Developer — Strategy department (project intake, mode classification A/B/C/D, validation, lead pipeline)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (at most once per session).
+2. Enter the **Strategy** department: read `departments/strategy.md` and follow it exactly.
+3. Run its intake first — self-serve from `build-state.md` (ask only what's missing), one gate per stage, record answers, append the **progress footer** to every response.
+4. Handoff when complete: tell the user the next department is **Research** (`/awd-research`) and offer to continue.
+
+User arguments: $ARGUMENTS

package/commands/agentic-web-developer.md

@@ -0,0 +1,11 @@
+---
+description: Agentic Web Developer — full website system (license-gated; routes into the 10-department flow, starting at Strategy)
+---
+
+Run the **agentic-web-developer** skill (read its `SKILL.md` first).
+
+1. **License gate** — run it before any work (SKILL.md → "License gate"), at most once per session.
+2. **Route** — if the user named a department in the arguments (strategy / research / content / design / frontend / backend / motion / qa / deploy / growth), enter that department's file under `departments/` and follow it. Otherwise enter **Strategy** (`departments/strategy.md`) and run its intake — it collects everything later departments need.
+3. **Discipline** — self-serve intake from `build-state.md` (ask only what's missing), one gate per stage, record every answer, and append the **progress footer** to every response (SKILL.md → "Progress footer"). Backend runs only if the user asks for it.
+
+User arguments: $ARGUMENTS

package/docs/EXAMPLES.md

@@ -1,6 +1,6 @@
 # Examples — the two scenarios
 
-The skill runs the same 11-stage gated pipeline in both modes. Every stage ends with a question to you; answers are recorded in `build-state.md`. These are two complete walkthroughs.
+The skill runs the same **10-department flow** in both modes (Backend runs only if you ask for it). Every stage ends with a question to you; answers are recorded in `build-state.md`; the agent appends a progress footer to every response. These are two complete walkthroughs.
 
 ---
 
@@ -10,21 +10,23 @@ The skill runs the same 11-stage gated pipeline in both modes. Every stage ends
 
 > "Build me a website that converts for my pool cleaning business in Phoenix."
 
+(Or jump straight in: `/awd-strategy`)
+
 **Mode:** A (build-and-sell — the video default). Goal: a site you can sell as a product, plus the outreach system to find buyers.
 
-| Stage | What happens | The gate (you answer) |
+| Department | What happens | The gate (you answer) |
 |---|---|---|
-| 0 — Intake | Agent records: offer ("pool cleaning, weekly plans"), audience (Phoenix homeowners), mode A, no client list yet, $0/mo tool budget | "Confirm the offer and audience — and do you have any clients/leads yet, or start from zero?" → *"start from zero"* |
-| 1 — Money framework | Runs **M** of M.O.N.E.Y: validates "pool cleaning in Phoenix" — unsexy niche, 20+ businesses, most sites outdated, you know the trade | "Pick the niche: pool cleaning, HVAC, or landscaping in Phoenix?" → *"pool cleaning"* |
-| 2 — Research | **Design Blueprint Extractor** on an inspiration site you name (e.g. a clean SaaS-style home-services site) → `builderbrief.md`, `scaffold.html`, `tokens.json`. **Outlier Research** scrapes 12 pool companies → top 5 / bottom 5 → `outlier-anatomy.md` (winners: price-on-site, booking form, reviews above fold; losers: flash intros, no phone number) | "Approve the inspiration site and the outlier findings?" → *"yes, but keep the blue from the inspiration"* |
-| 3 — Design tool | — | "Which tool: Stitch, AI Studio, Figma, Paper, or code-first?" → *"Stitch"* |
-| 4 — Design | Section plan from the anatomy: hero + phone CTA, stat strip (years, pools serviced), plans grid, how-it-works, reviews, FAQ, quote form | "Review the design — approve before code?" → *"approve"* |
-| 5 — Framework | — | "Framework?" → *"plain HTML/CSS + a bit of JS"* (client wants cheap hosting) |
-| 6 — Build | Page(s) built 1:1 from the design, all content from `siteconfig.ts`; AI-generated hero image iterated until the pool photo leaves room for the headline | "Look at localhost — review before QA?" → *"looks good"* |
-| 7 — QA | Conversion blueprint + UI/UX checklist: H1 "Pool Cleaning That Never Misses a Week" (6 words), AA contrast, form tested, mobile widths checked | "QA passed — approve?" → *"approve"* |
-| 8 — Animation | You're told: **all motion goes to AnimotionJS** (Stage plan): hero reveal, scroll reveals, plan-card hover, counter on the stat strip → motion brief written and handed to the Animotion skill | "Animotion installed? Approve the motion brief?" → *"installed, approved"* |
-| 9 — Deploy | — | "Deploy where: GitHub→Vercel, GoHighLevel, or WordPress?" → *"GitHub → Vercel"* |
-| 10 — Sell | Runs the outreach system: scrapes Phoenix pool companies (Apify, budget-capped), enriches emails, then sends: *free site as the foot in the door* → hosting retainer ($50–150/mo) → SEO/reviews upsells; Day 1/3/7 follow-ups | "Draft the outreach emails for niche 'pool cleaning'?" → *"send to 20 leads"* |
+| **1 Strategy** | Agent records: offer ("pool cleaning, weekly plans"), audience (Phoenix homeowners), mode A, no client list yet, $0/mo tool budget. Runs **M** of M.O.N.E.Y: unsexy niche, 20+ businesses, most sites outdated. Lead pipeline: scrapes 20 Phoenix companies → `leads.csv` | "Confirm the offer/audience — clients yet, or start from zero?" → *"start from zero"* · "Pick the niche: pool cleaning, HVAC, or landscaping?" → *"pool cleaning"* |
+| **2 Research** | **Design Blueprint Extractor** on an inspiration site you name (a clean SaaS-style home-services site) → `builderbrief.md`, `scaffold.html`, `tokens.json`. **Outlier Research** on 12 pool companies → top 5 / bottom 5 → `outlier-anatomy.md` (winners: price-on-site, booking form, reviews above fold; losers: flash intros, no phone number) | "Approve the inspiration site and the outlier findings?" → *"yes, but keep the blue from the inspiration"* |
+| **3 Content** | Agent drafts every word: H1 options, hero, offer stack, plans, reviews, FAQ, contact — real facts only from you (testimonials, pricing, phone) | "Pick the H1 and confirm the primary CTA" · "Full copy draft — approve or edit?" → *"approve"* |
+| **4 Design** | Tool question → *"Stitch"*. Section plan from the anatomy: hero + phone CTA, stat strip, plans grid, how-it-works, reviews, FAQ, quote form. Asset production: hero image, icons, OG image — all generated | "Which tool — and do you have credentials?" → *"Stitch"* · "Review the design — approve?" → *"approve"* |
+| **5 Frontend** | Framework question → *"plain HTML/CSS + a bit of JS"* (cheap hosting). Dev-toolkit offer → *"no"*. Page(s) built 1:1 from the design, content from `siteconfig.ts`, hero iterated until the pool photo leaves room for the headline | "Look at localhost — review?" → *"looks good"* |
+| **7 Motion** | You're told **all motion goes to AnimotionJS**: hero reveal, scroll reveals, plan-card hover, counter on the stat strip → motion brief written and handed to the Animotion skill | "Animotion installed? Approve the motion brief?" → *"installed, approved"* |
+| **8 Quality Assurance** | Conversion blueprint + UI/UX checklist: H1 "Pool Cleaning That Never Misses a Week" (6 words), AA contrast, form tested, mobile widths; web-quality audit (Lighthouse/CWV/a11y/SEO); `qa-report.md` | "QA passed — approve?" → *"approve"* |
+| **9 Deployment** | — | "Deploy where: GitHub→Vercel, GoHighLevel, or WordPress?" → *"GitHub → Vercel"* |
+| **10 Growth** | Outreach system: scrapes Phoenix pool companies (Apify, budget-capped), enriches emails, then drafts: *free site as the foot in the door* → hosting retainer ($50–150/mo) → SEO/reviews upsells; Day 1/3/7 follow-ups; analytics wired | "Draft the outreach emails for niche 'pool cleaning'?" → *"send to 20 leads"* |
+
+(Backend never ran — static site, recorded as "not required".)
 
 **Result:** a deployed, converting site + a repeatable client-acquisition loop. The same `siteconfig.ts` makes the next local-business site a clone, not a rebuild.
 
@@ -36,21 +38,19 @@ The skill runs the same 11-stage gated pipeline in both modes. Every stage ends
 
 > "I have a SaaS idea — FocusFlow, a focus timer with team accountability. I want to launch it."
 
-**Mode:** B (novel idea / product launch — no customer list). Re-scopes Stages 1, 2's outliers, 4–7's goal, 3/5's surface, and 10's motion.
+**Mode:** B (novel idea / product launch — no customer list). Re-scopes Strategy validation, Research outliers, Content/Design/Frontend's conversion goal and surface, and Growth's launch motion.
 
-| Stage | What happens | The gate (you answer) |
+| Department | What happens | The gate (you answer) |
 |---|---|---|
-| 0 — Intake | Agent records: idea ("FocusFlow — team focus timer"), audience (remote teams / ADHD founders), mode B, **brand assets collected**: existing teal logo + palette from your deck; **inspiration sites collected**: linear.app and stripe.com | "Confirm the idea and audience — and what brand assets exist?" → *"teal logo + palette; new type"* |
-| 1 — Idea/audience validation | Re-scoped: who has this problem (r/ADHD, remote-work Discords), alternatives (Float, Motion, plain Pomodoro), demand signals (competitor reviews complaining about pricing) | "Audience confirmed: remote teams of 2–10?" → *"yes"* |
-| 2 — Research | **Design Blueprint Extractor runs exactly like Mode A**: linear.app as inspiration (type scale, density, border language) + **second pass on your brand** (teal palette from the logo/deck) → merged: brand colors win, linear sets the feel → `builderbrief.md`, `scaffold.html`, `tokens.json`. **Outlier Research** re-scoped to rival launch pages (Motion, Forest, Pomodoro apps by traffic/reviews) → `outlier-anatomy.md` | "Approve the inspiration + extracted brand style?" → *"yes, keep #0D9488 as primary"* |
-| 3 — Design tool | — | "Tool?" → *"code-first (Next.js)"* (multi-page app-like site) |
-| 4 — Design | Section plan re-scoped to the product's anatomy: demo/video hero, feature grid, integrations logos, pricing tiers, testimonials, FAQ — single CTA: **Join the waitlist** | "Approve the design?" → *"approve"* |
-| 5 — Framework | — | "Framework?" → *"Next.js"* — multi-page scaffold: `/`, `/pricing`, `/docs` |
-| 6 — Build | Pages built from the outlier anatomy; AI-generated abstract hero matched to the teal palette; conversion goal wired: waitlist form (email only, no password) | "Review on localhost?" → *"approve"* |
-| 7 — QA | Same checklists, goal adjusted: H1 "Focus Together, Finish Faster" (5 words), one CTA everywhere, form → provider tested, responsive pass | "QA passed?" → *"approve"* |
-| 8 — Animation | Motion brief to AnimotionJS: hero mask reveal, feature-card scroll stagger, pricing hover lift, waitlist-button magnetic hover | "Animotion installed? Approve brief?" → *"approved"* |
-| 9 — Deploy | — | "Deploy where?" → *"GitHub → Vercel + custom domain"* |
-| 10 — Launch motion | Re-scoped from cold outreach: waitlist/launch email sequence, founder outreach (remote-work communities, r/SaaS), Product Hunt draft — same email rules (human subject, no hard ask, proof + link); monetization = trial/paid tiers instead of retainers | "Draft the launch emails and PH post?" → *"yes"* |
+| **1 Strategy** | Records: idea ("FocusFlow — team focus timer"), audience (remote teams / ADHD founders), mode B, **brand assets**: existing teal logo + palette from your deck; **inspiration sites**: linear.app and stripe.com. Validation re-scoped: who has this problem (r/ADHD, remote-work Discords), alternatives (Float, Motion, plain Pomodoro), demand signals (competitor reviews complaining about pricing). No lead scraping | "Confirm the idea/audience — what brand assets exist?" → *"teal logo + palette; new type"* · "Audience: remote teams of 2–10?" → *"yes"* |
+| **2 Research** | Extractor runs exactly like Mode A: linear.app as inspiration + **second pass on your brand** (teal palette from the logo/deck) → merged: brand colors win, linear sets the feel. Outliers re-scoped to rival launch pages (Motion, Forest, Pomodoro apps by traffic/reviews) | "Approve the inspiration + extracted brand style?" → *"yes, keep #0D9488 as primary"* |
+| **3 Content** | Product copy: demo-led hero, feature benefits, pricing tiers, waitlist CTA — voice gate on brand adjectives | "Pick the H1 and confirm CTA: **Join the waitlist**" · "Copy draft — approve?" → *"approve"* |
+| **4 Design** | Tool → *"code-first (Next.js)"* (multi-page app-like site). Product anatomy: demo/video hero, feature grid, integrations logos, pricing tiers, testimonials, FAQ — single CTA | "Approve the design?" → *"approve"* |
+| **5 Frontend** | Framework → *"Next.js"* — multi-page scaffold: `/`, `/pricing`, `/docs`. AI-generated abstract hero matched to the teal palette; waitlist form (email only) wired | "Review on localhost?" → *"approve"* |
+| **7 Motion** | Motion brief to AnimotionJS: hero mask reveal, feature-card scroll stagger, pricing hover lift, waitlist-button magnetic hover | "Animotion installed? Approve brief?" → *"approved"* |
+| **8 Quality Assurance** | Same checklists, goal adjusted: H1 "Focus Together, Finish Faster" (5 words), one CTA everywhere, form → provider tested, responsive pass | "QA passed?" → *"approve"* |
+| **9 Deployment** | — | "Deploy where?" → *"GitHub → Vercel + custom domain"* |
+| **10 Growth** | Re-scoped from cold outreach: waitlist/launch email sequence, founder outreach (remote-work communities, r/SaaS), Product Hunt draft — same email rules (human subject, no hard ask, proof + link); monetization = trial/paid tiers; analytics events on the waitlist | "Draft the launch emails and PH post?" → *"yes"* |
 
 **Result:** a live multi-page product site with your brand DNA extracted alongside the inspiration, waitlist converting, and a launch sequence ready to send.
 
@@ -58,10 +58,10 @@ The skill runs the same 11-stage gated pipeline in both modes. Every stage ends
 
 ## What's identical in both modes
 
-- Inspiration-site **design DNA extraction** and **brand-style extraction** (Stage 2)
-- The conversion blueprint and QA checklists (Stage 7)
-- Deployment (Stage 9)
-- **The animation rule:** no motion code is ever written by this skill — Stage 8 hands a motion brief to the **AnimotionJS agentic skill** for all 15 supported agents
-- A question gate at the end of every stage
+- Inspiration-site **design DNA extraction** and **brand-style extraction** (Research)
+- The conversion blueprint and QA checklists (Content + Quality Assurance)
+- Deployment (Deployment — the user always picks the target)
+- **The animation rule:** no motion code is ever written by this skill — Motion hands a motion brief to the **AnimotionJS agentic skill** for all 15 supported agents
+- A question gate at the end of every stage, a progress footer on every response, and `/awd-<dept>` commands to jump into any department
 
 Install for your agent: [INSTALL.md](./INSTALL.md).

package/docs/INSTALL.md

@@ -1,6 +1,6 @@
 # Installing agentic-web-developer
 
-The skill installs into **15 AI coding agents** — the same 15 the AnimotionJS skill supports. The installer writes each agent's own file format (`SKILL.md`, `skill.md`, a rules file, or `CONVENTIONS.md`) with the right frontmatter, plus the reference playbooks and templates alongside it.
+The skill installs into **15 AI coding agents** — the same 15 the AnimotionJS skill supports. The installer writes each agent's own file format (`SKILL.md`, `skill.md`, a rules file, or `CONVENTIONS.md`) with the right frontmatter, plus the department playbooks, reference playbooks and templates alongside it. For **opencode** and **Claude Code** it also installs the **slash commands** (`/agentic-web-developer`, `/agentic-web-developer-<dept>`, `/awd-<dept>`) globally.
 
 > **The npm package contains only the installer and these docs** — never the skill source. The installer fetches the skill payload from a *skill source* you configure (see [Skill source](#skill-source)).
 
@@ -38,6 +38,26 @@ Then **restart your AI agent** so it loads the skill.
 | `--dry-run` | Print the target paths without writing anything |
 | `--dir=<path>` | Install flat into `<path>/agentic-web-developer/` (SKILL.md layout) |
 | `--home=<path>` | Use `<path>` as the home directory (for testing) |
+| `--no-commands` | Skip installing the slash commands (opencode + claude) |
+
+## Slash commands (opencode + Claude Code)
+
+Alongside the skill, the installer writes the command files to the agent's global command directory:
+
+| Agent | Command directory |
+|---|---|
+| opencode | `~/.config/opencode/command/` (or `~/.opencode/command/`) |
+| Claude Code | `~/.claude/commands/` |
+
+Commands installed (21 files — 11 sources, `awd-*` aliases derived automatically):
+
+| Command | Does |
+|---|---|
+| `/agentic-web-developer` | Router — license gate, then Strategy (or the department named in the arguments) |
+| `/agentic-web-developer-strategy` … `-growth` | Enter one of the 10 departments by full name |
+| `/awd-strategy` … `/awd-growth` | The same 10 departments, short alias |
+
+Departments: `strategy` · `research` · `content` · `design` · `frontend` · `backend` · `motion` · `qa` · `deploy` · `growth`. Skip with `--no-commands`; refresh with `--force`. Agents other than opencode/claude still get the full skill — they just enter departments by asking ("use the Design department") instead of a slash command.
 
 ## Skill source
 
@@ -74,21 +94,21 @@ The package author normally sets `awd.source` in `package.json` once, so end use
 
 | Key | Agent | File written | Plus |
 |---|---|---|---|
-| `opencode` | OpenCode | `~/.config/opencode/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
-| `claude` | Claude Code | `~/.claude/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
-| `copilot` | GitHub Copilot | `%APPDATA%\github-copilot\skills\agentic-web-developer\SKILL.md` | `references/`, `templates/` |
+| `opencode` | OpenCode | `~/.config/opencode/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/`, `departments/` + commands |
+| `claude` | Claude Code | `~/.claude/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/`, `departments/` + commands |
+| `copilot` | GitHub Copilot | `%APPDATA%\github-copilot\skills\agentic-web-developer\SKILL.md` | `references/`, `templates/`, `departments/` |
 | `cursor` | Cursor | `~/.cursor/rules/agentic-web-developer.mdc` | payload in `~/.cursor/skills/agentic-web-developer/` |
-| `windsurf` | Windsurf (Codeium) | `~/.codeium/windsurf/skills/agentic-web-developer/skill.md` | `references/`, `templates/` |
-| `cody` | Cody (Sourcegraph) | `~/.cody/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
-| `codium` | Codium | `~/.codium/skills/agentic-web-developer/skill.md` | `references/`, `templates/` |
+| `windsurf` | Windsurf (Codeium) | `~/.codeium/windsurf/skills/agentic-web-developer/skill.md` | `references/`, `templates/`, `departments/` |
+| `cody` | Cody (Sourcegraph) | `~/.cody/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/`, `departments/` |
+| `codium` | Codium | `~/.codium/skills/agentic-web-developer/skill.md` | `references/`, `templates/`, `departments/` |
 | `aider` | Aider | `~/.aider/skills/CONVENTIONS.md` | payload in `~/.aider/skills/agentic-web-developer/` |
 | `continue` | Continue | `~/.continue/rules/agentic-web-developer.md` | payload in `~/.continue/skills/agentic-web-developer/` |
-| `codex` | Codex (OpenAI) | `~/.codex/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
-| `roo` | Roo Code | `~/.roo/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
-| `cline` | Cline | `~/.cline/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
+| `codex` | Codex (OpenAI) | `~/.codex/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/`, `departments/` |
+| `roo` | Roo Code | `~/.roo/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/`, `departments/` |
+| `cline` | Cline | `~/.cline/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/`, `departments/` |
 | `augment` | Augment | `~/.augment/rules/agentic-web-developer.md` | payload in `~/.augment/skills/agentic-web-developer/` |
 | `amazonq` | Amazon Q | `~/.amazonq/rules/agentic-web-developer.md` | payload in `~/.amazonq/skills/agentic-web-developer/` |
-| `jetbrains` | JetBrains AI | `~/.junie/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/` |
+| `jetbrains` | JetBrains AI | `~/.junie/skills/agentic-web-developer/SKILL.md` | `references/`, `templates/`, `departments/` |
 
 Notes:
 
@@ -100,11 +120,12 @@ Notes:
 
 Get the skill folder itself (the package doesn't contain it — take it from your configured source, or a copy someone sent you), then place the files as the table above says:
 
-- **SKILL.md agents** — copy the `skill/` folder to `<skills-dir>/agentic-web-developer/` (it must contain `SKILL.md`, `references/`, `templates/`).
+- **SKILL.md agents** — copy the `skill/` folder to `<skills-dir>/agentic-web-developer/` (it must contain `SKILL.md`, `references/`, `templates/`, `departments/`).
 - **Windsurf / Codium** — same, but rename `SKILL.md` to `skill.md`.
-- **Cursor** — copy `skill/SKILL.md` to `~/.cursor/rules/agentic-web-developer.mdc`, keep `references/` + `templates/` in `~/.cursor/skills/agentic-web-developer/`.
+- **Cursor** — copy `skill/SKILL.md` to `~/.cursor/rules/agentic-web-developer.mdc`, keep `references/` + `templates/` + `departments/` in `~/.cursor/skills/agentic-web-developer/`.
 - **Continue / Augment / Amazon Q** — copy `skill/SKILL.md` to the agent's `rules/agentic-web-developer.md` (paths in the table), payload alongside in `skills/agentic-web-developer/`.
 - **Aider** — copy `skill/SKILL.md` (without its `---` frontmatter block) to `~/.aider/skills/CONVENTIONS.md`.
+- **Slash commands (opencode + Claude Code)** — copy every file from the repo's `commands/` folder into `~/.config/opencode/command/` or `~/.claude/commands/`, then add `awd-<dept>.md` duplicates of each `agentic-web-developer-<dept>.md` if you want the short aliases.
 
 ## No local agent: Google AI Studio
 
@@ -123,15 +144,20 @@ Step-by-step, GET license URL, reference URL patterns and session hygiene: the s
 npx agentic-web-developer detect
 ```
 
-`INSTALLED` next to an agent means the skill file and its payload are both in place.
+`INSTALLED` next to an agent means the skill file and its payload are both in place. For opencode/claude it also shows the slash-command status (`cmds:` path, or `not installed`).
 
 ## Uninstall
 
-Delete what the table lists for your agent — the skill file **and** the `agentic-web-developer/` payload folder. For example:
+Delete what the table lists for your agent — the skill file **and** the `agentic-web-developer/` payload folder. For opencode/claude, also delete the command files (`agentic-web-developer*.md` and `awd-*.md`). For example:
 
 ```bash
 # opencode
 rm -rf ~/.config/opencode/skills/agentic-web-developer
+rm -f ~/.config/opencode/command/agentic-web-developer*.md ~/.config/opencode/command/awd-*.md
+
+# claude
+rm -rf ~/.claude/skills/agentic-web-developer
+rm -f ~/.claude/commands/agentic-web-developer*.md ~/.claude/commands/awd-*.md
 
 # cursor (rule file + payload)
 rm -f ~/.cursor/rules/agentic-web-developer.mdc
@@ -149,7 +175,7 @@ npx animotion-skills install --detect
 ```
 
 - License key (Studio plan, $15/month): https://skills.animotion.click/checkout
-- Without a key the build still works up to Stage 8 (animation handoff), where it stops and asks you to install Animotion.
+- Without a key the build still works up to the Motion department (animation handoff), where it stops and asks you to install Animotion.
 
 ## Repository vs npm package vs skill source
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-web-developer",
-  "version": "1.0.8",
-  "description": "Agentic skill for building high-converting websites that sell — design DNA extraction, outlier competitor research, conversion blueprints, the M.O.N.E.Y sales framework, lead generation, cloning, outreach and deployment, with a novel-idea/product-launch mode. All animation work is delegated to the AnimotionJS agentic skill.",
+  "version": "2.0.0",
+  "description": "Department-based agentic skill for building high-converting websites that sell — 10 departments (Strategy, Research, Content, Design, Frontend, Backend, Motion, QA, Deploy, Growth) with slash commands (/awd-*), design DNA extraction, outlier competitor research, conversion blueprints, the M.O.N.E.Y sales framework, lead generation, cloning, outreach and deployment, plus product-launch, 3D/WebGL and design-sketch modes. All animation work is delegated to the AnimotionJS agentic skill.",
   "keywords": [
     "opencode",
     "skill",
@@ -17,13 +17,16 @@
     "google-ai-studio",
     "gemini",
     "animotion",
-    "animotionjs"
+    "animotionjs",
+    "departments",
+    "slash-commands"
   ],
   "bin": {
     "agentic-web-developer": "bin/install.js"
   },
   "files": [
     "bin",
+    "commands",
     "docs",
     "README.md"
   ],
@@ -37,7 +40,7 @@
   },
   "license": "UNLICENSED",
   "awd": {
-    "source": "https://4e2zaktqel.ucarecd.net/f1600612-35fa-41cc-8fdc-d6997ef71ea4/skilltar.gz"
+    "source": "https://4e2zaktqel.ucarecd.net/f3037da1-80c0-4758-8a00-fefb4ce8ba9e/skilltar.gz"
   },
   "publishConfig": {
     "access": "public"