Clearpath

Clearpath is a product delivery plugin for Claude Code and Cursor with a simple workflow: prototype → approve in chat → agent builds autonomously.

It combines:

• GSD Core-style context engineering: phase loop, fresh-context work, state artifacts.
• Superpowers-style development discipline: spec-first, plan-first, mandatory TDD (red-green-refactor), review.
• gstack-style role review: product/CEO, design, engineering, QA, security, release.
• Context Ledger: artifact memory without reading everything at startup.

Install on Claude Code

From GitHub marketplace

Add the marketplace:

/plugin marketplace add minhvhdev/clearpath

Install Clearpath:

/plugin install clearpath@clearpath-marketplace

Reload plugins:

/reload-plugins

Start:

/clearpath:go

Or just describe what you want to build or change.

Local development install

From the parent directory of this plugin:

claude --plugin-dir ./clearpath-plugin

Install on Cursor

From marketplace

In Cursor Settings > Plugins, add the marketplace minhvhdev/clearpath and install Clearpath. Restart Cursor after installation.

Local development install

1. Clone this repo:

   git clone https://github.com/minhvhdev/clearpath.git

2. In Cursor, open Settings > Plugins and add the cloned directory as a local plugin.
3. Restart Cursor.

After installation, the Clearpath skills, agents, hooks, and MCP servers are available. Use the same workflow and skills as on Claude Code.

Usage

Inside Claude Code or Cursor, you can just say what you want. The Autopilot detects the project mode and routes the request. You can also use namespaced skills such as:

/clearpath:go             (default autopilot entrypoint)
/clearpath:goal           (explicit one-shot goal mode; skips approval gate)
/clearpath:init
/clearpath:start
/clearpath:update
/clearpath:adopt
/clearpath:doctor
/clearpath:design-prototype
/clearpath:execute
/clearpath:test-driven-development
/clearpath:verify
/clearpath:verify-web
/clearpath:verify-windows
/clearpath:autonomy

Simplest usage

1. Install/enable the plugin.
2. Open Claude Code at your project root.
3. Tell Claude what you want to build or change.

Examples:

Build me a SaaS landing page for ...
Add billing settings to this app.
Review this existing codebase and prepare it for Clearpath.
Fix the onboarding bug and verify it.

Lifecycle:

detect -> prototype -> present -> user approves in chat ->
TDD implement (RED -> verify fail -> GREEN -> verify pass) -> verify -> done

For UI work, the agent will:

1. Build an HTML + Tailwind CSS prototype under .clearpath/prototype/ and show you how to preview it.
2. Ask you to Approve or Request changes.
3. After you reply "approve" (or similar), continue building without routine questions.

If you want Clearpath to skip that checkpoint for a single run, invoke /clearpath:goal.

.clearpath/docs/AUTOPILOT.md is a continuity artifact created by workflow skills. See docs/AUTOPILOT.md.

Structure

clearpath-plugin/
├── .claude-plugin/plugin.json    # Claude Code manifest
├── .cursor-plugin/plugin.json    # Cursor manifest
├── .cursor/rules/clearpath.mdc   # Cursor always-on Clearpath context
├── .cursor/rules/clearpath-autopilot.mdc # Cursor always-on routing
├── .mcp.json
├── skills/
├── agents/
├── hooks/
│   ├── hooks.json                # Claude Code hooks
│   └── hooks-cursor.json         # Cursor hooks
├── scripts/
├── bin/
├── tests/
├── templates/
└── docs/

Required local prerequisites

Hard requirements:

• Claude Code or Cursor (Agent mode)
• Bash-compatible shell (Git Bash on Windows)
• jq
• Git recommended for real projects

MCP layer expected by Clearpath workflows:

• Chrome DevTools MCP via npx -y chrome-devtools-mcp@latest with screenshot guardrails in .mcp.json (jpeg, quality 70, max 1600x3000) to keep image payloads under tighter provider request limits
• Serena via uvx --from git+https://github.com/oraios/serena ... --context=claude-code --project-from-cwd
• Codebase-Memory MCP via codebase-memory-mcp on PATH

Run:

./bin/clearpath-doctor

Doctor and prerequisites

Run /clearpath:doctor to verify:

• User-scope skills: design-taste-frontend, impeccable
• MCP servers: chrome-devtools, serena, codebase-memory-mcp
• CLI: jq, git, node, npx, uvx, codebase-memory-mcp

For Cursor, keep .cursor/rules/clearpath.mdc and .cursor/rules/clearpath-autopilot.mdc in the project so Clearpath instructions and routing stay active even if hook-delivered Autopilot context is dropped by the IDE.

If anything is missing, the agent will ask for permission, then run:

CLEARPATH_DOCTOR_INSTALL_APPROVED=1 clearpath-doctor-install

Validation

./tests/plugin-structure-test.sh
./tests/hook-smoke-test.sh
./bin/clearpath-doctor
claude plugin validate . --strict

claude plugin validate requires the Claude Code CLI and must be run in your local environment.