@@ -25,13 +25,14 @@ description: "Non-negotiable development standards for ScreenGraph. Enforces arc
252511. [Commands](#commands)
262612. [Build & Deployment](#build--deployment)
272713. [Handoff Documentation](#handoff-documentation)
28+ 14. [Vibe Usage](#vibe-usage-engineering-personas)
2829
2930### Part II: Environment Policy
30- 14 . [Single Environment Execution](#single-environment-execution)
31- 15 . [Worktree Usage](#worktree-usage)
32- 16 . [Standard Ports](#standard-ports)
33- 17 . [Cursor Modes](#cursor-dropdown-modes)
34- 18 . [Enforcement Rules](#enforcement-what-agents-cannot-do)
31+ 15 . [Single Environment Execution](#single-environment-execution)
32+ 16 . [Worktree Usage](#worktree-usage)
33+ 17 . [Standard Ports](#standard-ports)
34+ 18 . [Cursor Modes](#cursor-dropdown-modes)
35+ 19 . [Enforcement Rules](#enforcement-what-agents-cannot-do)
3536
3637---
3738
@@ -253,6 +254,71 @@ Update after significant changes.
253254
254255---
255256
257+ ### 🎭 Vibe Usage (Engineering Personas)
258+
259+ **ALWAYS load appropriate vibe before starting domain-specific work:**
260+
261+ **What are vibes?**
262+ - Role-based profiles that configure AI agents with domain-specific MCP tools, documentation, Task commands, and workflow patterns
263+ - Every vibe extends `base_vibe` (graphiti, context7, sequential-thinking)
264+ - Located in `vibes/` directory
265+
266+ **Available Vibes:**
267+ - **backend_vibe** — Backend/API work (encore-mcp, github, backend-debugging)
268+ - **frontend_vibe** — Frontend/UI work (playwright, svelte, figma, vercel)
269+ - **infra_vibe** — DevOps/automation (mcp-builder, skill-creator, github, vercel)
270+ - **qa_vibe** — Testing/QA (playwright, encore-mcp, webapp-testing)
271+
272+ **Mandatory Workflow:**
273+ ```
274+ 1. BEFORE starting work: Load appropriate vibe
275+ "Load backend_vibe and [task]"
276+ "Load frontend_vibe and [task]"
277+
278+ 2. DURING work:
279+ - Use vibe-specific MCP tools (not manual scripting)
280+ - Follow vibe-specific rules and documentation
281+ - Run vibe-recommended Task commands
282+ - Leverage vibe-specific Claude skills
283+
284+ 3. AFTER completing:
285+ - Run quality checks (founder rules, tests, smoke tests)
286+ - Document discoveries via Graphiti
287+ - Update handoff docs if significant changes
288+ ```
289+
290+ **Examples:**
291+ ```
292+ ✅ "Load backend_vibe and optimize agent state machine"
293+ → Uses encore-mcp for introspection, backend-debugging skill
294+
295+ ✅ "Load frontend_vibe and build navigation component"
296+ → Uses playwright for inspection, svelte docs, autofixer
297+
298+ ✅ "Load qa_vibe and write E2E tests for run flow"
299+ → Uses webapp-testing skill, playwright automation
300+
301+ ✅ "Load infra_vibe and create Stripe MCP server"
302+ → Uses @mcp-builder_skill 4-phase process
303+ ```
304+
305+ **MCP Tools Registry:**
306+ - **Location:** `.cursor/mcp.json` (template) and `.cursor/mcp.local.json` (secrets, gitignored)
307+ - All vibes reference tools from this registry
308+ - To add new tool: Update mcp.json → Update relevant vibe → Document in Graphiti
309+
310+ **Enforcement:**
311+ - ❌ Never work without loading appropriate vibe (you'll miss critical tools/context)
312+ - ❌ Never ignore vibe-specific rules (they ensure consistency)
313+ - ❌ Never skip Graphiti search before implementing (avoid reinventing)
314+ - ✅ ALWAYS search Graphiti for existing patterns before starting
315+ - ✅ ALWAYS document solutions via Graphiti after solving complex issues
316+ - ✅ ALWAYS use vibe-specific MCP tools instead of manual work
317+
318+ **See:** `vibes/README.md` for complete vibe documentation and decision tree
319+
320+ ---
321+
256322## Part II: Environment Policy
257323
258324### Single Environment Execution
0 commit comments