Agent-Skills.md

Agent Skills: /proxiblue-skills:workflow-onboard-project

IN-DDEV onboarding workflow that brings a Mage-OS project's claude-code session into the full ProxiBlue stack. Runs ENTIRELY inside the DDEV web container — does NOT do host-side prep. The skill verifies upfront that the pb-codegraph MCP is reachable and refuses if not. Once verified: installs the 4 ProxiBlue plugins (pb-hcf, pb-hcf-playwright-tdd, proxiblue-skills, hyva-ai-tools), runs /hcf:project-setup, configures Playwright+pcov TDD via /pb-hcf-playwright-tdd:setup, and wires all per-domain playbooks via /pb-hcf:wire (one wire skill, multi-playbook installer). Visible TodoWrite list throughout. Idempotent — re-runnable, skips already-done steps.

UncategorizedID: proxiblue/claude-skills/workflow-onboard-project

Repository

proxiblue/claude-skills
ProxiBlue
181

Install this agent skill to your local

pnpm dlx add-skill https://github.com/ProxiBlue/claude-skills/tree/HEAD/workflow-onboard-project

Skill Files

Browse the full folder contents for workflow-onboard-project.

Download Skill

Loading file tree…

workflow-onboard-project/SKILL.md

Skill Metadata

Name
workflow-onboard-project
Description
"IN-DDEV onboarding workflow that brings a Mage-OS project's claude-code session into the full ProxiBlue stack. Runs ENTIRELY inside the DDEV web container — does NOT do host-side prep. The skill verifies upfront that the pb-codegraph MCP is reachable and refuses if not. Once verified: installs the 4 ProxiBlue plugins (pb-hcf, pb-hcf-playwright-tdd, proxiblue-skills, hyva-ai-tools), runs /hcf:project-setup, configures Playwright+pcov TDD via /pb-hcf-playwright-tdd:setup, and wires all per-domain playbooks via /pb-hcf:wire (one wire skill, multi-playbook installer). Visible TodoWrite list throughout. Idempotent — re-runnable, skips already-done steps."

/proxiblue-skills:workflow-onboard-project

In-container onboarding for a Mage-OS DDEV project. Assumes all host-side prep is done.

Pre-flight (FIRST step inside container)

  1. Run hostname && pwd && ls /var/www/html 2>/dev/null and confirm you're inside a DDEV web container with /var/www/html as the project root. If not → refuse with "this skill runs inside the DDEV web container, run ddev ssh from the host first".
  2. Verify host-side prereqs via container-visible signals:
    • mcp__pb-codegraph__list_repos returns a non-empty list → if empty/unavailable, refuse with "pb-codegraph MCP not available or project not indexed — check .ddev/pb-codegraph/registry.json and restart the session"
  3. Detect Magento: grep -E '"(mage-os|magento)/(product-community-edition|magento2-base)"' /var/www/html/composer.json — if no match, refuse (this stack is Mage-OS-only).

Visible todo list

1. Verify in-DDEV context + host-side prereqs satisfied
2. Install pb-hcf plugin (skip if installed)
3. Install pb-hcf-playwright-tdd plugin (skip if installed)
4. Install proxiblue-skills plugin (likely already present — skip if so)
5. Install hyva-ai-tools plugin (skip if installed)
6. /hcf:project-setup (skip if .claude/CLAUDE.md already shows HCF setup)
7. /pb-hcf-playwright-tdd:setup (refuses if pcov absent — surface fix, stop)
8. /pb-hcf:wire (re-run safely if already wired — multi-playbook installer)
9. Verify .claude/{CLAUDE.md, testing.md, wires.json} exist + CLAUDE.md has pb-hcf fence + every playbook listed in wires.json has its .claude/<name>.md
10. Print "ready — invoke /proxiblue-skills:workflow-build-feature for your first ticket"

Step details

Steps 2-5 — plugin installs (idempotent)

For each:

/plugin install pb-hcf@pb-hcf
/plugin install pb-hcf-playwright-tdd@pb-hcf-playwright-tdd
/plugin install proxiblue-skills@proxiblue-skills
/plugin install hyva-ai-tools@hyva-ai-tools

For any that report "already installed" → mark task completed and proceed (not an error).

Step 6 — HCF project setup

/hcf:project-setup

HCF will ask its own questions about scope, plan dir, etc. Pass through. If .claude/CLAUDE.md already exists with HCF markers → ask user if they want to re-run (default: skip).

Step 7 — Playwright + pcov TDD setup

/pb-hcf-playwright-tdd:setup

HARD requirement: pcov must be loaded in the container. If the skill refuses with "pcov absent", relay the exact .ddev/config.yaml fix it suggests:

webimage_extra_packages: [..., php<X.Y>-pcov]
xdebug_enabled: false

Then ddev restart from the host, then ddev ssh back in, then re-invoke this skill (will skip already-completed earlier steps).

Step 8 — wire all per-domain playbooks

/pb-hcf:wire

Multi-playbook installer: discovers every *.md under pb-hcf's templates/playbooks/, installs each as .claude/<name>.md, appends a single fenced section to .claude/CLAUDE.md listing pointers to all of them, runs per-domain reachability probes, and writes .claude/wires.json as the wire registry.

Idempotent — re-running refreshes the wire registry timestamp + re-probes reachability. Pass --reprobe to update only reachability state.

Step 9 — final verification

test -f /var/www/html/.claude/CLAUDE.md && echo "CLAUDE.md ok"
test -f /var/www/html/.claude/testing.md && echo "testing.md ok"
test -f /var/www/html/.ddev/pb-codegraph/registry.json && echo "pb-codegraph registry ok"
grep -q "<!-- pb-hcf:start -->" /var/www/html/.claude/CLAUDE.md && echo "pb-hcf fence ok"

All four should report ok. If any missing → surface which step's output the user should re-check.

Step 10 — completion

============================================================
ONBOARDING COMPLETE — /var/www/html

Plugins installed:   pb-hcf, pb-hcf-playwright-tdd, proxiblue-skills, hyva-ai-tools
HCF setup:           done (.claude/CLAUDE.md present)
TDD config:          done (.claude/testing.md present, pcov verified)
pb-codegraph:       done (.ddev/pb-codegraph/registry.json + CLAUDE.md fence present)

Next: /proxiblue-skills:workflow-build-feature  (for your first ticket)
Reference: ~/claude-plugins-central/WORKFLOW.md
============================================================

What this skill does NOT do

  • Does not do any host-side work. No image build, no ddev add-on, no build-mount.sh, no ddev restart. Refuses upfront if the host-side prep isn't done.
  • Does not modify .ddev/config.yaml (e.g., to add pcov). If pcov absent, prints the YAML the user must add host-side, stops.
  • Does not push or commit anything.
  • Does not run any feature tasks — just bootstrap.

Recovery

Re-invoke anytime. Each step is idempotent:

  • Plugin installs: "already installed" is OK
  • /hcf:project-setup: asks before overwriting
  • /pb-hcf-playwright-tdd:setup: idempotent re-runs, asks before overwrite
  • /pb-hcf:wire: refreshes .claude/wires.json registry, replaces fenced CLAUDE.md section, re-probes per-domain reachability

The TaskCreate list re-seeds; completed steps just verify+skip on re-runs.