claud-coach
claud-coach *a proposito mal escrito como prueba de concepto* es un compañero de aprendizaje para desarrolladores, te guía con preguntas en
Open source Repository Open in the app JSON README (API)
About
claud-coach *a proposito mal escrito como prueba de concepto* es un compañero de aprendizaje para desarrolladores, te guía con preguntas en lugar de darte respuestas directas, y bloquea PRs de baja calidad antes de que lleguen a tus reviewers. Caracteristicas: - Diseñado para TDAH/ADD: respuestas cortas, una cosa a la vez, siempre estructurado - Modo mentor te acompaña paso a paso en tareas, con plan estructurado, sección de testing y checklist de PR incluidos - PR Guardian: revisa automáticamente título, descripción y tests antes de cada git push o gh pr create - /wdyt: veredicto rápido sobre tus cambios recientes, sin explicaciones innecesarias
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- irinaterebiznik
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-04-23T12:35:23Z
- Repository state
- ativo
- Language
- Shell
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
irinaterebiznik/claud-coach/claud-coach
README
# claud-coach > A Claude Code plugin that teaches you to think instead of handing you answers — and blocks sloppy PRs before they reach your reviewers. Built for developers still building their instincts, and for everyone who keeps forgetting things before hitting submit. **Especially useful for developers with ADHD or ADD** — every response is short, structured, and one thing at a time. --- ## What it does - **Guides you through tasks** with questions instead of answers (shadowing mode) - **Checks your PR** automatically before every `git push` or `gh pr create` - **Quick sanity check** on demand with `/wdyt` — fast verdict, no lecture --- ## Commands Once the plugin is installed, use these in any Claude Code session: **Mentor mode** — teaching companion with built-in PR checks: | Command | What it does | |---|---| | `/dev-mentor:mentor` | Start or re-enter mentor mode | | `/dev-mentor:mentor shadowing` | Jump straight into guided task mode | | `/dev-mentor:mentor straight` | Switch to direct answers | | `/dev-mentor:wdyt` | Quick sanity check on recent changes | **PR Guardian** — standalone, no mentor needed: | Command | What it does | |---|---| | `/dev-mentor:pr-guardian` | Run the PR checklist — direct, no teaching | PR Guardian runs **automatically** before `git push` and `gh pr create`, regardless of which mode is active. --- ## Install **Via CLI** (user scope, available across all projects): ```bash claude plugin install dev-mentor@claud-coach ``` **Via the plugin UI** inside Claude Code: ``` /plugin ``` Search for `dev-mentor` and install from there. **Scope options:** | Flag | Where it installs | Use case | |---|---|---| | *(default)* | `~/.claude/settings.json` | Personal, all projects | | `--scope project` | `.claude/settings.json` | Shared with team via git | | `--scope local` | `.claude/settings.local.json` | Project-only, gitignored | --- ## Configure your checklist Drop a `.pr-guardian.yml` at the root of any repo to define your team's requirements: ```yaml # .pr-guardian.yml title: - Starts with ticket number (e.g. PROJ-123) - Under 72 characters description: - Linked ticket in description - Testing steps provided - Breaking changes noted if any code: - Unit tests added or updated - No debug logs left in required_sections: - "## Summary" - "## Test Plan" ``` No `.pr-guardian.yml`? It falls back to a sensible default. See [`skills/pr-guardian/references/checklist-template.md`](skills/pr-guardian/references/checklist-template.md) for examples. --- ## Testing in a clean environment Uses Docker to spin up a fresh environment with no existing Claude Code config or plugins. **1. Build the image:** ```bash docker build -t claud-coach-test . ``` **2. Create a `.env` file in the project root:** ```bash ANTHROPIC_API_KEY=your_key_here ``` > `.env` is already in `.gitignore` — your key won't be committed. **3. Run a clean container:** ```bash docker run -it --rm \ -v $(pwd):/plugin \ --env-file .env \ claud-coach-test bash ``` **4. Inside the container, start Claude with the plugin loaded:** ```bash claude --plugin-dir /plugin ``` **5. Verify it works:** - Session-start greeting appears with the three mode options - Commands respond: `/dev-mentor:mentor`, `/dev-mentor:wdyt`, `/dev-mentor:pr-guardian` - Hook fires when you run `git push` --- ## Use as a template This repo is a GitHub template. Click **"Use this template"** to fork it as a starting point for your own Claude Code plugin. --- ## License [MIT](LICENSE)