cklph-visual-qa

---

[!NOTE] TL;DR — One repo, one marketplace (cklph), four plugins that layer on each other: a dev-workflow spine, opinionated Next.js + Supabase patterns, a value-based consulting practice, and a business operating cadence. Install only what you need.

---

🧩 The four plugins

Plugin	What it does	When you want it
cklph-os	Dev-workflow spine — phase loop (refine → survey → spec → plan → build → review → verify → ship), three adversarial agents (cklph-implementer / cklph-reviewer / red-team), daily-rhythm primitives (triage · decide · daily-frame · weekly-review), self-improvement loop (learn), and quality-gate hooks.	Always. This is the core.
cklph-nextjs	Opinionated Next.js + Supabase patterns layered on top of the official vercel:* skills — layered lib/ architecture, mutation security checklist, data-layer abstraction rules, 12 review pitfalls, full stack coverage.	If you work in Next.js + Supabase repos (e.g. MailPrism, SendBriefs, BeforeMerge).
cklph-architect	Value-based consulting practice — discover · scope · propose · price · position · engagement-shape. Codifies the discipline in original prose; no Weiss / Stark / Enns IP republished.	If you consult and want options-not-estimates rather than single-quote vendor mode.
cklph-eos	Business operating cadence — quarterly priorities, weekly sync, scorecard, issues resolution, people-fit, accountability mapping. Generic terms throughout; no branded EOS IP republished.	If you have (or are adding) a team and need operating rhythm.

---

🚀 Quick start

Add the marketplace once:

/plugin marketplace add Chykalophia/cklph-marketplace

Install only what you want:

/plugin install cklph-os@cklph            # the dev spine — always
/plugin install cklph-nextjs@cklph        # only if you work in Next.js + Supabase
/plugin install cklph-architect@cklph     # only if you consult
/plugin install cklph-eos@cklph           # only if you operate a team

Restart your CLI after install so the skills load.

[!TIP] Claude Desktop — add the marketplace under Settings → Plugins, point at this repo, then install. Skills, commands, and agents load there. Hooks are CLI-only.

---

🧠 Where to begin — the start-here skill

cklph-os ships a start-here skill that runs at the start of every task. It sets instruction priority, routes you to the right skill before you act, and applies context-discipline rules (trust tiers · A/B/C confusion stop-templates · marker hygiene). If you read one skill before using anything else, read this one.

---

🔧 The build flow (cklph-os)

Eight composable phases — run one standalone, or chain them with the orchestrator.

Phase	Command	Does
refine	/cklph-os:refine	sharpen a vague idea (optional)
survey	/cklph-os:survey	gap-fill across users / devices / edges / cross-cutting concerns
spec	/cklph-os:spec	requirements + acceptance criteria
plan	/cklph-os:plan	decompose into a wave task-graph
build	/cklph-os:build	execute via sub-agent waves
review	/cklph-os:review	adversarial review (standard or red-team intensity)
verify	/cklph-os:verify	run checks + walk acceptance criteria
ship	/cklph-os:ship	open a PR

[!TIP] /cklph-os:flow <goal> runs the whole loop and asks your mode first: full-agentic · partial · interactive.

---

🛡️ Quality-gate hooks (CLI only)

• pre-commit-gate — TypeScript + ESLint + Semgrep on every git commit. Skips merge commits and bulk stages (>500 files). Lints SKILL.md descriptions for the YAML colon-space trap. Configurable warning budget via CKLPH_ESLINT_MAX_WARNINGS.
• nextjs-quality-check — App Router patterns and 'use client' discipline on Next.js file edits.
• security-check — advisory secret scanning on every edit (gitleaks + bandit if installed).

---

🖥️ Surface support (honest)