Coder Workflow

Claude Code plugin: MCP-backed codebase exploration, Modular MVC + Service + Repository refactoring, and Cloudflare-fronted Docker deploys.

Highlights

• coder-workflow skill — codegraph MCP routing guide (which tool to call, when graph beats grep, anti-patterns)
• refraktor skill — language-agnostic refactor to Modular MVC + Service + Repository with mandatory planning gate
• deploy-docker skill — Cloudflare (DNS-01) → Traefik → Docker Compose on VPS, with worked examples
• Codegraph MCP server (coder-workflow mcp) — graph queries, impact analysis, cycle/orphan detection, quality gates
• One command: /refraktor (architectural refactor entry point)
• Safety hooks: rm-guard, force-push-guard, env-write-guard, graph-freshness nudge

Components

Skills

| Skill | Purpose | | --- | --- | | coder-workflow | Codegraph MCP routing: which tool to call, when graph beats grep, when to use analyze_impact before refactors | | refraktor | Refactor to Modular MVC + Service + Repository with mandatory planning gate | | deploy-docker | Cloudflare DNS-01 → Traefik → Docker Compose deploys with working examples |

Commands

| Command | Purpose | | --- | --- | | /refraktor | Plan + execute a Modular MVC + Service + Repository refactor |

Hooks

| Hook | Trigger | Purpose | | --- | --- | --- | | UserPromptSubmit | every prompt | Skill detection nudge, prompt log | | SessionStart | startup / resume / compact / clear | Banner, graph freshness check, auto-scan if missing | | PreToolUse | Bash / Write / Grep / Glob / Agent | rm-guard, force-push-guard, env-write-guard, graph-first reminders, no-Explore enforcement | | PostToolUse | Write / Bash / codegraph MCP / Agent | Async graph refresh, package/commit/test logs | | PostToolUseFailure | * | Async failure log | | PostToolBatch | every batch | Async batch size log | | Stop | session end | Verification checklist + async graph refresh | | StopFailure | rate_limit / max_output_tokens / server_error | Recovery guidance | | FileChanged | package.json / .env / CLAUDE.md / hooks.json / tsconfig / .mcp.json / skills/*/SKILL.md | On-disk change notices | | CwdChanged | directory change | CodeGraph availability check | | PostCompact | after compaction | Re-orientation notice | | SubagentStart | any subagent spawn | Async agent lifecycle log | | SubagentStop | any subagent stop | Async agent lifecycle log | | TaskCompleted | task done | Echo + async log | | InstructionsLoaded | session_start / nested_traversal / include | Async CLAUDE.md load log | | ConfigChange | project_settings / user_settings | Config source log | | SessionEnd | session end | Session summary |

Installation

Default (global): Installs to ~/.claude/skills/coder-workflow/ — Claude Code auto-discovers and loads the plugin on every session start.

./install.sh

Symlink for development (so changes to the repo are immediately reflected):

./install.sh --link

Install into the current project only (.claude/ directory):

./install.sh --project

Preview install actions without changing files:

./install.sh --dry-run

Install selected components only:

./install.sh refraktor deploy-docker coder-workflow
./install.sh --skills-only coder-workflow refraktor
./install.sh --hooks-only
./install.sh --commands-only

Windows PowerShell equivalents:

.\install.ps1
.\install.ps1 -Project
.\install.ps1 -Link
.\install.ps1 -DryRun

After installation: Restart Claude Code or run /reload-plugins to load the new plugin.

Skill names

When installed as a plugin, skills are namespaced:

| Skill | Command | |-------|---------| | coder-workflow | /coder-workflow:coder-workflow | | refraktor | /coder-workflow:refraktor | | deploy-docker | /coder-workflow:deploy-docker |

Commands are namespaced too:

| Command | Slash command | |---------|---------------| | refraktor | /coder-workflow:refraktor |

Local testing

cc --plugin-dir .

Trigger examples:

refractor src/modules/user to controller service repository
cek struktur controller service repository
setup deploy Docker GHCR VPS Traefik
where is function createUser called from
what is the blast radius of changing Db.exec

Deploy guide

See docs/docker-ghcr-vps-traefik-deploy.md for the general Docker deploy template covering GitHub Actions, GHCR, VPS, Docker Compose, Traefik labels, secrets, verification, and 404/502 debugging.

For the Cloudflare-fronted multi-service template, see skills/deploy-docker/examples/ (Dockerfile, docker-compose.yml, github-workflow.yml, traefik-labels.md, README.md).

Production checklist

• Keep skills/, commands/, and docs/ committed and reviewed like source code.
• Run ./install.sh --dry-run before installing into shared environments.
• Use ./install.sh --project for repository-specific workflows.
• Use ./install.sh --link only during local plugin development.
• Use Claude Code built-in plan mode before significant edits.
• Graph before grep — prefer mcp__codegraph__query_graph over Grep / Bash(find) for symbol questions.
• Refactor with impact analysis — run mcp__codegraph__analyze_impact before any non-trivial change.
• Plan before refactor — refraktor requires a planning gate; do not skip it.

Repository layout

coder-workflow/
├── .claude-plugin/plugin.json
├── .editorconfig
├── CHANGELOG.md
├── LICENSE
├── README.md
├── package.json
├── tsconfig.json
├── biome.json
├── hooks/
│   ├── hooks.json
│   └── scripts/              # guard + telemetry scripts
├── commands/
│   └── refraktor.md
├── skills/
│   ├── coder-workflow/
│   │   └── SKILL.md
│   ├── refraktor/
│   │   ├── SKILL.md
│   │   └── references/
│   │       └── layer-contract.md
│   └── deploy-docker/
│       ├── SKILL.md
│       ├── references/
│       │   └── deploy-guide.md
│       └── examples/          # Dockerfile, docker-compose.yml, etc.
├── docs/
│   └── docker-ghcr-vps-traefik-deploy.md
├── src/                       # TypeScript CLI + codegraph MCP server
├── test/                      # node:test suite
├── install.sh
├── install.ps1