Files

T

pplate 87e0b9359e feat(roo): add Patrick-persona custom modes, skills, and mode-specific rules

Add 4 new custom modes with BigMind guidance:
- rules-bigmind/: Introspective Patrick mode (BigMind development)
- rules-homelab/: Tinkerer Patrick mode (TrueNAS, Docker, infra)
- rules-mcp-builder/: Craftsman Patrick mode (pi_mcps MCP servers)
- rules-paisy/: Professional Patrick mode (ADP Germany payroll)

Add reusable skills:
- skills/assessment-first/: structured assessment.md before implementation
- skills/bigmind-session-ritual/: mandatory session start/end ritual
- skills/gitea-push/: conventional commit + Gitea push workflow
- skills/new-mcp-server/: FastMCP scaffold procedure
- skills-bigmind/, skills-homelab/, skills-mcp-builder/, skills-paisy/: mode-specific skill dirs

Update existing rules:
- rules-architect, rules-ask, rules-code, rules-debug, rules-orchestrator:
  add BigMind session guidance (search before task, announce focus, hypotheses)

Add plans/MODES_AND_SKILLS_PLAN.md: full architecture document

2026-04-04 09:52:08 +02:00

2.9 KiB

Raw Blame History

MCP Builder Mode Behavior — Roo Code

Active Persona: Craftsman Patrick

Patrick is in MCP Builder mindset. He is building or extending MCP servers in the pi_mcps monorepo. Consistency and testability are the highest values — every server should feel like it belongs in the same ecosystem.

pi_mcps Structure (always active in this mode)

~/pi_mcps/
  mcp/
    {server-name}/          ← one dir per server
      src/
        server.py           ← FastMCP server (single file)
        __init__.py
      tests/
        conftest.py         ← sys.path + shared fixtures
        test_server.py      ← 100% mock coverage
      pyproject.toml        ← name=mcp-{name}, uv-managed
      README.md
  java/                     ← Java projects (not MCP servers)
  plans/                    ← architecture plans

FastMCP Pattern (non-negotiable)

from fastmcp import FastMCP

mcp = FastMCP("server-name")

@mcp.tool()
def tool_name(param: str) -> str:
    """Tool description."""
    ...

if __name__ == "__main__":
    mcp.run()

Before Starting Any MCP Build

Search Existing Patterns: memory_search_facts("pi_mcps server") + memory_search_chunks("FastMCP pattern")
Check Gitea: Does a similar server already exist in pi_mcps?
Write PLAN.md: Purpose, tools list with signatures, tech stack, v1 scope boundaries
Announce Focus: memory_announce_focus(session_id, "MCP Builder: new server X", files=["mcp/X/src/server.py"], ide_hint="VS Code")
Form Hypothesis: memory_add_hypothesis(session_id, "Server X will need N tools and Y authentication pattern")

Standard Build Sequence

mcp/{name}/PLAN.md — purpose, tools, tech stack
mcp/{name}/src/__init__.py — empty
mcp/{name}/src/server.py — FastMCP server with all tools
mcp/{name}/tests/conftest.py — sys.path + fixtures
mcp/{name}/tests/test_server.py — full mock coverage
mcp/{name}/pyproject.toml — uv + fastmcp + deps
mcp/{name}/README.md — usage, env vars, tool list

pyproject.toml Conventions

[project]
name = "mcp-{name}"
requires-python = ">=3.11"
dependencies = ["fastmcp>=0.1.0", ...]

[project.optional-dependencies]
test = ["pytest", "pytest-mock", "pytest-cov"]

Test Conventions

Mock ALL external calls (HTTP, filesystem, subprocess)
Use monkeypatch for env vars and module-level state
conftest.py: sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
Aim for 100% tool function coverage
Run: uv run pytest tests/ -v

After Building a Server

Store Fact: memory_store_fact("codebase", "mcp/{name} has N tools: [list]. Stack: X. Env vars: Y.")
Wire into .roo/mcp.json: Add the server entry with correct uv path
Update root README.md: Add to MCPs table
Push to Gitea: Conventional commit: feat(mcp-{name}): add initial server with N tools
Resolve Hypothesis: Was the tool count and auth pattern as predicted?

2.9 KiB Raw Blame History