verify-product-discovery-coaches

Files (5)

• SKILL.md
• README.md · features/
• claude-code-package-validation.md · features/
• coach-skill-catalogue.md · features/
• codex-marketplace-installation.md · features/

SKILL.md (first lines)

# Verify Product Discovery Coaches

This repository ships a plugin package rather than a long-running application.
The real user surfaces are Codex marketplace installation and Claude Code plugin
validation. Do not start an interactive Claude or Codex session for this skill.

---

## Launch

No server or build is required. Start each verification run from the repository
root with an isolated Codex home and a durable evidence directory:

```bash
export RUN_ID="$(date -u +%Y%m%dT%H%M%SZ)"
export ARTIFACT_DIR=".artifacts/verification/$RUN_ID"
export CODEX_VERIFY_HOME="$(mktemp -d)"
mkdir -p "$ARTIFACT_DIR"
```

The package is ready to drive when `claude`, `codex`, and the repository root
manifests are available. The Codex run is isolated by `CODEX_HOME`; it does not
read or change the user's normal Codex installation state.

---

## Doctor

Before driving, run this read-only package health check:

```bash
claude plugin validate .
python3 - <<'PY'
import json
from pathlib import Path
for path in (
    'plugin.json',
    '.codex-plugin/plugin.json',
    '.claude-plugin/plugin.json',
    '.agents/plugins/marketplace.json',
    '.claude-plugin/marketplace.json',
):
    json.loads(Path(path).read_text(encoding='utf-8'))
    print(f'valid JSON: {path}')
PY
```

Drive the package only when Claude Code reports validation success and every
manifest parses as JSON. This check does not mutate a profile, install a plugin,
or call a model.

---

## Drive

Use the exact marketplace name and plugin identifier from the manifests. Drive
the Codex installation path as a user would, while writing all command output
to the evidence directory:

```bash
CODEX_HOME="$CODEX_VERIFY_HOME" \
  codex plugin marketplace add . --json \
  | tee "$ARTIFACT_DIR/codex-marketplace-add.json"
CODEX_HOME="$CODEX_VERIFY_HOME" \
  codex plugin add product-discovery-coaches@product-discovery-coaches --json \
  | tee "$ARTIFACT_DIR/codex-plugin-add.json"
CODEX_HOME="$CODEX_VERIFY_HOME" \
  codex plugin list \
  | tee "$ARTIFACT_DIR/codex-plugin-list.txt"
claude plugin validate . \
  | tee "$ARTIFACT_DIR/claude-plugin-validate.txt"
```

The proof passes only when the marketplace-add result names
`product-discovery-coaches`, the plugin-add result reports version `1.0.0`, the
Codex list reports it as `installed, enabled`, and Claude Code reports
`Validation passed`.

Use the feature map before expanding coverage. The Codex installation recipe is
the only fully isolated drive in this repository. The Claude Code feature is a
real package validator, not an interactive model execution; do not claim a
coach prompt was executed unless an isolated Claude session actually ran it.

---

## Evidence

Keep each run's output under `.artifacts/verification/$RUN_ID/`. That directory
is ignored by Git so evidence does not become product content. Capture the
commands above and their resulting state, not merely successful exit codes.

A valid proof exercises the real marketplace and installation path, captures
the add result and installed-plugin list, and captures the independent Claude
Code validation result. It must not use internal state setters, replace a
marketplace with handcrafted cache files, or rely on a test-only endpoint.

The Codex sandbox writes a cache below `$CODEX_VERIFY_HOME`. Confirm that the
plugin list identifies the package as installed before cleanup. The commands do
not use a dry-run mode, so observe the generated temporary cache rather than
assuming nothing was written.

---

## Cleanup

Remove only the isolated Codex home created in Launch:

```bash
rm -rf "$CODEX_VERIFY_HOME"
unset CODEX_VERIFY_HOME
```

Do not kill processes by name: this verification starts no persistent process.
Do not remove `$ARTIFACT_DIR`; evidence must survive cleanup. Confirm it remains
with `test -d "$ARTIFACT_DIR"`.

---

## Helpers

From brunogama/product-discovery-coaches, MIT.

More from brunogama/product-discovery-coaches