ruvnet/ruflo · error · Error

Prompt not found: ${name}

Error message

Prompt not found: ${name}

What it means

PromptRegistry.get() found no registered prompt under the requested name in its prompts map. The lookup happens before argument validation, so an unknown prompt name is reported as such rather than as a missing-argument problem.

Source

Thrown at v3/@claude-flow/mcp/src/prompt-registry.ts:129

    const result: PromptListResult = { prompts };

    if (endIndex < allPrompts.length) {
      result.nextCursor = this.encodeCursor({ offset: endIndex });
    }

    return result;
  }

  /**
   * Get a prompt with arguments
   */
  async get(
    name: string,
    args: Record<string, string> = {}
  ): Promise<PromptGetResult> {
    const prompt = this.prompts.get(name);
    if (!prompt) {
      throw new Error(`Prompt not found: ${name}`);
    }

    // Validate required arguments
    if (this.options.validateArguments && prompt.arguments) {
      for (const arg of prompt.arguments) {
        if (arg.required && !(arg.name in args)) {
          throw new Error(`Missing required argument: ${arg.name}`);
        }
      }
    }

    const messages = await prompt.handler(args);

    this.emit('prompt:get', { name, argCount: Object.keys(args).length });

    return {
      description: prompt.description,
      messages,

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Register the prompt with prompt-registry before requesting it by name.
2. Check for typos in the prompt name; list registered prompts to confirm the exact name.

When it happens

Trigger: Thrown at v3/@claude-flow/mcp/src/prompt-registry.ts:129 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/3fc430825751ea2d. Report an issue: GitHub.