oimpresso-mcp-first

Route project knowledge retrieval through MCP tools instead of filesystem search.

Updated May 14, 2024
One-click install
npx skills add https://github.com/wagnerra23/oimpresso.com --skill oimpresso-mcp-first
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oimpresso-mcp-first
Source: https://github.com/wagnerra23/oimpresso.com/tree/main/.claude/skills/mcp-first
Command: npx skills add https://github.com/wagnerra23/oimpresso.com --skill oimpresso-mcp-first

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasting time by forcing the AI to use the project’s MCP tools and canonical memory sources first, keeping knowledge retrieval audited, permissioned, and cross-tenant safe.

Core Features & Use Cases

  • MCP-first knowledge routing: Prefer MCP tools over filesystem reads/grep for any request that involves project memory, ADRs, cycles, sessions, or tasks.
  • Question-to-tool mapping: Turns common user intents (active cycle state, goals, inbox, tasks, ADR lookup, recent sessions) into the correct MCP tool calls.
  • Zero private auto-memory enforcement: Avoids creating private working-memory files in Claude projects; persistent knowledge goes to the git-backed canonical paths.
  • When filesystem is acceptable: Allows filesystem reads mainly during debugging or when MCP is down, and allows specific templates for writing decisions during documented edits.

Quick Start

Ask: “Use MCP to find the current cycle status, my active tasks, and the latest relevant ADR for the topic ‘multi-tenant isolation’.”

Frequently Asked Questions about oimpresso-mcp-first

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve project knowledge and ADRs using MCP tools instead of filesystem search?

To retrieve project knowledge using MCP tools, route requests for canonical memory, ADRs, and tasks through MCP-first execution rather than filesystem reads. This enforces audited, permissioned, and cross-tenant-safe access while preventing untracked knowledge retrieval.

What is the best way to look up active cycle status and tasks for ERP team workflows?

The best way to look up active cycle status and tasks for ERP workflows is mapping user intents to specific MCP tool calls. This retrieves current cycle state, goals, inbox items, and tasks directly from permissioned project memory sources.

Why does MCP-first knowledge routing prevent private auto-memory files in Claude projects?

MCP-first knowledge routing prevents private auto-memory files because it enforces a zero private working-memory policy. Persistent knowledge is directed to git-backed canonical paths instead of local project files, ensuring long-lived, audited project governance.

Can I use filesystem reads when MCP tools are down or during debugging?

Filesystem reads are acceptable when MCP tools are down or during debugging. Outside these exceptions, the system enforces MCP-first execution to maintain cross-tenant safety and audited retrieval for all project memory, sessions, and ADRs.

How do I fetch recent sessions and ADRs for a specific topic like multi-tenant isolation?

To fetch recent sessions and ADRs for a specific topic, ask the system to use MCP to discover relevant ADRs and session logs. It maps your query to the correct tool calls for cross-tenant-safe retrieval.

What are the limitations of relying on filesystem search for project governance and auditing?

Relying on filesystem search bypasses permissioned, cross-tenant-safe access and audited knowledge retrieval. It lacks MCP-first routing for cycle status and ADR lookup, risking untracked changes and violating the no private auto-memory policy.