{"slug": "opencode-mentor-an-anti-vibecoding-programming-mentor-configuration", "title": "OpenCode Mentor: An anti-vibecoding, programming mentor configuration", "summary": "MAI released OpenCode Mentor, an opinionated OpenCode configuration that routes software-development learning through a mentor-first agent named Rob rather than generating code directly. The configuration defines five agents — Mentor Orchestrator, Mentor, Reviewer, Architect, and Drill Instructor — and runs a diagnose → teach → practice → assess → reflect → progress loop, with a pair-programmer prompt included but disabled by default. Runtime learner state is written under `.opencode/mentor/` in each active project and is intentionally excluded from the public configuration, which requires an OpenCode installation, Bun, and Git.", "body_md": "MAI is an opinionated [OpenCode](https://opencode.ai/) configuration for learning software development with AI. It is inspired by [Boot.dev](https://boot.dev/) and [PAI](https://github.com/danielmiessler/pai), with a mentor-first goal: use AI to strengthen reasoning and independent problem-solving, not merely to produce code quickly.\n\nThe default assistant is **Rob**, a learning orchestrator that routes work to specialist agents. The prompts favor diagnosis, small hints, deliberate practice, review, verification, and gradually reduced support. This repository is configuration and an evolving experiment, not a claim that AI can replace teachers, experience, or independent judgment.\n\n``` php\nOpenCode\n  -> opencode.json and AGENTS.md\n  -> mentor-orchestrator\n  -> mentor | reviewer | architect | drill-instructor\n  -> skills and project-aware tools\n  -> local learner state and session reflection\n```\n\n- `opencode.json` selects the primary agent, loads plugins, configures Context7, and defines baseline permissions.\n- `AGENTS.md` establishes the Rob identity and repository-wide operating rules.\n- `agents/` contains the orchestrator and specialist prompts.\n- `skills/core/SKILL.md` supplies the shared tutoring policy at runtime.\n- `tools/tutor.ts` exposes learner-profile, concept-graph, curriculum, exercise, grading, and reflection tools implemented under`tools/tutor/` .\n- `plugins/context-loader.ts` injects the shared Core policy once per session.\n\n| Agent | Responsibility | \n|---|---|\n| Mentor Orchestrator | Classifies requests, retrieves only relevant learner context, and delegates to a specialist. | \n| Mentor | Explains concepts, diagnoses errors, and gives the least help needed for progress. | \n| Reviewer | Reviews submitted work for correctness, design, security, and learning evidence without rewriting it by default. | \n| Architect | Explores system boundaries, data flow, constraints, and trade-offs. | \n| Drill Instructor | Creates focused exercises, evaluates attempts, and adjusts difficulty from observed results. | \n\nA pair-programmer prompt is included but disabled by default so the mentor-first workflow remains the primary path. OpenCode's built-in `explore` agent is used for codebase discovery where permitted.\n\n- [`PEDAGOGY.md`](https://github.com/davejpeters/opencode-mentor/blob/main/PEDAGOGY.md) explains the educational rationale and vocabulary.\n- [`skills/core/SKILL.md`](https://github.com/davejpeters/opencode-mentor/blob/main/skills/core/SKILL.md) is the operational source of truth for tutoring behavior.\n- Role prompts in `agents/` specialize Core without replacing it.\n- `skills/assignment/` defines learner-owned practice tasks; the other skills add focused workflows such as review, TDD, security, and Go development.\n\nThe central loop is **diagnose → teach → practice → assess → reflect → progress**. Assistance is calibrated to demonstrated work, and the system aims to fade scaffolding as the learner becomes more independent.\n\n| Path | Purpose | \n|---|---|\n| `agents/` | Primary and specialist agent definitions. | \n| `commands/` | Reusable OpenCode command prompts. | \n| `plugins/` | Context loading, environment protection, command filtering, and desktop notifications. | \n| `rules/` | Language- and workflow-specific instructions. | \n| `skills/` | Loadable guidance for pedagogy and engineering workflows. | \n| `tools/` | Tutor-state tools and small utilities such as JSON validation, date/time, math, and speech. | \n| `PEDAGOGY.md` | Maintainer-facing teaching model. | \n| `BACKLOG.md` | Planned improvements. | \n\nRuntime learner state is written inside each active project under `.opencode/mentor/`. It can contain learner identifiers, project paths, goals, evidence, misconceptions, exercises, and reflections. **Runtime learner state and personal metadata are intentionally not distributed with this public configuration.**\n\nPrerequisites:\n\n- A working OpenCode installation.\n- [Bun](https://bun.sh/) for the TypeScript tools and plugins.\n- Git for installation and updates.\n- Optional: [Context7 MCP](https://github.com/upstash/context7) network access for current library documentation,[beads](https://github.com/steveyegge/beads) for issue tracking,[graphify](https://github.com/Graphify-Labs/graphify) or[codegraph](https://github.com/colbymchenry/codegraph) for codebase discovery.\n\nBack up any existing OpenCode configuration before installing. Then clone this repository as the global configuration and install its development dependency:\n\n```\nmv ~/.config/opencode ~/.config/opencode.backup\ngit clone https://github.com/davejpeters/opencode-mentor ~/.config/opencode\ncd ~/.config/opencode\nbun install\n```\n\nReview `opencode.json`, agent permissions, and plugin behavior before first use. Restart OpenCode after changing configuration, agents, skills, or plugins because those files are loaded at startup.\n\nCommon starting points:\n\n1. Change the Rob name and identity in `AGENTS.md` .\n2. Adjust language and workflow rules under `rules/` .\n3. Tune agent prompts and permissions in `agents/` and`opencode.json` .\n4. Add, remove, or revise workflows under `skills/` .\n5. Review defaults in `tools/tutor/runtime.ts` , including the preferred language and learner identifier strategy.\n6. Disable integrations that are unavailable on your machine.\n7. Add more skills, tools, agents, commands, and plugins.\n\nThe configuration combines prompt-level boundaries with OpenCode permissions and small defensive plugins:\n\n- Shell commands generally require approval; a narrow set of read-only or verification commands is allowed explicitly.\n- `plugins/env-protection.ts` blocks tool reads whose path contains`.env` .\n- `plugins/safety-filter.ts` blocks shell commands containing`rm` .\n- Agent permissions restrict editing, writing, shell use, and delegation by role.\n- The mentor policy avoids complete target implementations while guided learning can still move the learner forward.\n- OpenCode sharing is disabled in `opencode.json` .\n\nThese are guardrails, not a security sandbox. Inspect proposed commands and changes, keep secrets out of the repository, and tighten permissions for your environment.\n\n- `plugins/notifications.ts` calls`notify-send` for idle-session and permission-request desktop notifications. It is intended for Linux desktops with a notification daemon; remove the plugin from`opencode.json` elsewhere.\n\nThe notification plugin tolerates command failures.", "url": "https://wpnews.pro/news/opencode-mentor-an-anti-vibecoding-programming-mentor-configuration", "canonical_source": "https://github.com/davejpeters/opencode-mentor", "published_at": "2026-09-16 21:15:14+00:00", "updated_at": "2026-09-16 21:25:05.813627+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["OpenCode Mentor", "OpenCode", "MAI", "Rob", "Boot.dev", "PAI", "Bun", "Git"], "alternates": {"html": "https://wpnews.pro/news/opencode-mentor-an-anti-vibecoding-programming-mentor-configuration", "markdown": "https://wpnews.pro/news/opencode-mentor-an-anti-vibecoding-programming-mentor-configuration.md", "text": "https://wpnews.pro/news/opencode-mentor-an-anti-vibecoding-programming-mentor-configuration.txt", "jsonld": "https://wpnews.pro/news/opencode-mentor-an-anti-vibecoding-programming-mentor-configuration.jsonld"}}