agentic-web-developer 1.0.9 → 2.0.1

package/README.md

@@ -1,26 +1,28 @@
 # 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 **`/awd-taste`** (taste training — not a department) (full `/agentic-web-developer-*` names and the `/agentic-web-developer` router). Installed globally for **opencode** and **Claude Code**; `--no-commands` to skip.
+- **Taste training** — users *train* the agent's taste into a global profile (`~/.agentic-web-developer/taste-profile.md`: three dials, point of view, annotated idea archive, ban list). The agent reads it before designing, declares a one-line design read, **always proposes 1–3 gated in-style deviations** over the inspiration (declining = faithful recreation), audits the result 0–100 before approval, and files lasting feedback back into the profile — taste compounds across projects, never assumed.
 - **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).
+- 16 reference playbooks, 10 department playbooks, a knowledge base (`references/knowledge-base/` — 8 distilled technique files + index), and 8 ready-to-fill templates (builder brief, scaffold HTML, `siteconfig.ts`, outlier anatomy, 3D scene brief, copy, QA report, taste profile).
 
 ## Install
 
@@ -41,11 +43,13 @@ 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.
 
-> **No local agent? Run it in Google AI Studio.** Paste `SKILL.md` into **System instructions**, enable the **URL Context** tool (the skill fetches its reference files and validates your key from `skills.animotion.click` — no env vars or file attachments needed), add your key to the system instructions, and build in Canvas. Full setup + stage mapping: `references/google-ai-studio.md` in the skill.
+> **No local agent? Run it in Google AI Studio.** Paste `references/ai-studio-system-prompt.md` into **System instructions** (a compact, contract-first router — *not* the raw `SKILL.md`, which browsers tend to ignore), enable the **URL Context** tool (the skill fetches its reference files and validates your key from `skills.animotion.click` — no env vars or file attachments needed), add your key to the system instructions, and build in Canvas. Full setup, department mapping and "it builds anyway" troubleshooting: `references/google-ai-studio.md` in the skill.
 
 > **On first run the skill asks for its Pro license key** (or admin credentials) and validates it once per session — or pass it up front with `--license-key=…` and skip the prompt. See [License & unlocking](#license--unlocking-the-skill).
 
@@ -55,7 +59,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 +71,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 +144,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 +156,27 @@ 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)
+> `/awd-taste` — train or refine your taste profile (works with or without a project)
+
+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/             # 12 slash-command files (router + 10 departments + taste trainer; 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, 14 non-negotiables, department map, modes, footer spec
+│   ├── departments/      # 10 department playbooks + INDEX + DEPARTMENT-TEMPLATE
+│   ├── references/       # 16 playbooks (incl. licensing.md, taste-system.md)
+│   └── templates/        # 8 fill-in templates (incl. 3D scene brief, copy, QA report, taste profile)
 ├── 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,21 @@ 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)
+  /awd-taste                                 taste training (not a department —
+                                             builds/edits your taste profile any time)
+  -> 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-taste.md

@@ -0,0 +1,18 @@
+---
+description: Agentic Web Developer — Taste training (teach the agent your taste: dials, POV, idea archive, bans)
+---
+
+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. **This is the taste trainer, not a department** — it runs inside or outside a project, adds no delivery stage, and never blocks the 10-department flow. Read `references/taste-system.md` and `templates/taste-profile-template.md` before asking anything.
+3. **Open the profile** at `~/.agentic-web-developer/taste-profile.md` (browser: the persistent TASTE PROFILE block). Missing → create it from the template. Existing → show a 3-line summary (dials, top bans, last decision-log entry) and offer to refine.
+4. **Pick the session** with one gate (options + recommended default):
+   - **Quick train** (default, ~5 min): three dials → 3 idea-archive references annotated *what / why it's good / what to steal* → hates list on top of the standing AI-tell bans.
+   - **Deep train** (opt-in, offer once after a quick train): 4–6 forced-choice A/B screen pairs, record each winner **in the user's words**, convert the whys into POV lines and bans.
+   - **Refine** (anytime the user arrives with changes): apply their words immediately — e.g. "set density to 8", "never use serif for this brand" — then confirm the diff in one line.
+5. **One question per response**, options + recommended default (derived from their niche if a project is open), record every answer in the profile and stamp `Last updated`.
+6. **Never invent profile entries.** Only the user's words and clearly-labeled defaults. Bans they override get moved to "User-overridden defaults", not deleted.
+7. **Training done:** tell them the profile now applies automatically — Strategy shows it at intake, Research gates deviations against it, Design reads it before producing anything (design read → audit → feedback classified back into the profile). If a project is open, append the **progress footer**; if not, close with one line on what was saved.
+
+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. If they named **taste** (or asked to train/refine taste), run `commands/agentic-web-developer-taste.md` instead — it is a trainer, not a department. 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. **Taste:** quick 5-min train offered (3 dials, 3 annotated idea-archive refs, hates) → saved to `~/.agentic-web-developer/taste-profile.md`. 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` + **1–3 proposed deviations** (keep → change → because). **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"* · "Approve the deviations?" → *"take #1, decline #2 and #3"* |
+| **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"*. Design read declared (style × inspiration + approved deviation · variance/motion/density = 7/5/4 · top bans). 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. Taste audit: **84/100** before the gate | "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,11 @@ 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) — always followed by **1–3 gated in-style deviations**, so the result evolves the inspiration instead of copying it
+- The **taste profile** (read before design, audit before approval, lasting feedback filed back) — train or refine it any time with `/awd-taste`
+- 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,27 @@ 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 (23 files — 12 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 |
+| `/agentic-web-developer-taste` · `/awd-taste` | Taste training — build or refine the taste profile (works with or without a project; not a department) |
+
+Departments: `strategy` · `research` · `content` · `design` · `frontend` · `backend` · `motion` · `qa` · `deploy` · `growth` — plus the standalone taste trainer (`taste`). 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 +95,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,17 +121,18 @@ 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
 
 AI Studio has no file system to install into — the skill runs there via paste + URL fetch instead:
 
-1. Paste `SKILL.md` (below the frontmatter) into AI Studio's **System instructions**.
+1. Paste the skill's `references/ai-studio-system-prompt.md` (the paste-ready contract — **not** the raw `SKILL.md`) into AI Studio's **System instructions**.
 2. Enable the **URL Context** tool — the skill uses it to validate your license and fetch each reference file from `skills.animotion.click` with your key (no env vars, no file attachments).
 3. Add your license key (or admin pair) to the System instructions, or paste it when the gate asks.
 4. Build in **Canvas** as a single HTML file, then **Download the code** and deploy.
@@ -123,15 +145,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 +176,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.9",
-  "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.1",
+  "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/d5460b68-09cf-415a-bd6f-b3ea8099d03a/skilltar.gz"
+    "source": "https://4e2zaktqel.ucarecd.net/f3037da1-80c0-4758-8a00-fefb4ce8ba9e/skilltar.gz"
   },
   "publishConfig": {
     "access": "public"