shadowtek

Shadowtek Claude Plugin

Private Claude Code plugin for the Shadowtek team. Provides skills, agents, commands, rules, and hooks for web design, hosting, and ads projects.

View Build Pipeline Diagram → Interactive reference — /new-project main flow + all standalone commands. Download button included for sharing.

---

Quick Start (new team members)

Requirement: GitHub access to the private shadowtek/shadowtek-claude-plugin repo.

Step 1: Register the marketplace (one time)

claude plugin marketplace add shadowtek/shadowtek-claude-plugin

Registers the Shadowtek marketplace across all Claude Code interfaces — CLI, VS Code, and Desktop app.

Step 2: Install the plugin

• CLI: claude plugin install shadowtek@shadowtek-claude-plugin
• VS Code: Type /plugins in the Claude Code chat panel → find "shadowtek" → Install
• Desktop app: Click + → Plugins → find "shadowtek" → Install

Step 3: Run setup

~/.claude/plugins/shadowtek/setup.sh

Installs everything-claude-code, which shadowtek depends on for agents and extended tooling.

Step 4: Updates

• CLI: claude plugins update shadowtek
• VS Code / Desktop: Plugin manager → click Update

Alternative: Pre-configure via settings

Add to ~/.claude/settings.json to skip Step 1:

{
  "extraKnownMarketplaces": {
    "shadowtek-plugins": {
      "source": {
        "source": "github",
        "repo": "shadowtek/shadowtek-claude-plugin"
      }
    }
  }
}

---

Command Pipelines

Commands are designed to chain. Below are the standard flows and the preferred run order.

---

Full-Service Web Project

For Shadowtek brand/design/build engagements.

/new-project
    ↓
/brand-agent  or  /brand-guidelines   (if brand work needed)
    ↓
/build-orchestrator
    ↓
/pre-flight
    ↓
/deploy
    ↓
/publish-brand    (optional — publish deliverables to brand.shadowtek.com.au)
    ↓
/handoff          (optional — engineering handoff doc)

---

SiteLaunch (Tradie Lead Gen)

/new-project auto-routes when SiteLaunch is selected at Step 0.

/new-project  →  /sitelaunch-build
    ↓
/pre-flight
    ↓
/deploy

---

Ads Campaign from Brand

Produces a ready-to-import Google Ads Editor CSV using brand data.

/brand-agent        ← must run first to produce brand.json
    ↓
/brand-to-ads

---

Cloudflare Security

New account / client onboarding (all zones at once):

/cf-harden-bulk
    ↓
/cf-overview        ← verify everything scored correctly

Single zone setup or override:

/cf-harden
    ↓
/cf-audit           ← confirm pass/fail per check

Audit only (no changes):

/cf-overview        ← account-wide score, surfaces failing zones
    ↓
/cf-audit           ← drill into a specific zone

---

Directory Network

For new city/niche deployments in the directory-network monorepo. Standalone — no dependencies.

/new-directory

---

All Commands

/new-project — Project Intake

Structured intake that routes to the right build track. Always the starting point for any new client project.

/new-project

• One question at a time — never asks two at once
• Reads SHADOWTEK-AGENTS.md, STACK.md, and CONVENTIONS.md before making stack decisions
• Shadowtek track: project type → discovery → stack decision → scaffolding (WordPress, Headless WP + Astro, Astro static, landing page, web app)
• SiteLaunch track: auto-selected at Step 0 → collects trade, location, services, trust signals, pages, brand assets → hands off to /sitelaunch-build

---

/brand-agent — Brand Intelligence Agent

Three-tier brand deliverable system. Produces self-contained HTML files for client handoff.

/brand-agent

Tier	Deliverables	Best for
Tier 1 — Brand Identity	Brand Guide HTML + brand.json	New clients, visual rebrand
Tier 2 — Brand + Positioning	+ Audience Summary HTML	Strategy-focused engagements
Tier 3 — Full Brand Agent	+ Marketing Strategy HTML	Full brand + go-to-market

• 25-question intake (one at a time)
• Researches the client site and competitors via Playwright + WebSearch
• Generates brand-colored, offline-capable HTML deliverables
• Tier 3 outputs: 30-60-90 roadmap, channel strategy, KPI dashboard, budget guidance, risk register
• Accepts a context payload from /new-project — skips already-known data

---

/brand-guidelines — Standalone Brand Guide

Produces a brand guide HTML + brand.json without the full brand-agent intake. Faster for clients with an existing brand direction.

/brand-guidelines

• Accepts context payload from /new-project or /build-orchestrator
• Outputs brand.json for use by /build-orchestrator and /brand-to-ads

---

/brand-to-ads — Brand to Google Ads CSV