VibeCoding System

Instructions

Implementation Reference

• vibe-services/context-manager/index.ts:66-77 (handler)

  Core handler function that creates a project object, saves it to context, and returns the first clarification question.

  async startProjectClarification(projectName: string, initialDescription: string = ""): Promise<{
    question: string;
  }> {
    const projectPath = process.cwd();
    const project = createProjectObject(projectName, initialDescription, projectPath);
    this.saveCurrentProject(project);
  
    const firstQuestion = DEFAULT_CLARIFICATION_QUESTIONS[0];
    return {
      question: firstQuestion,
    };
  }

• vibe-services/context-manager/index.ts:238-253 (handler)

  MCP CallToolRequest handler case for 'start-clarification' that parses arguments, calls the core handler, and formats the response.

  case 'start-clarification': {
    const { projectName, initialDescription } = z.object({
      projectName: z.string(),
      initialDescription: z.string().optional()
    }).parse(args);
    
    const result = await contextManager.startProjectClarification(projectName, initialDescription);
    return {
      content: [
        {
          type: 'text',
          text: `🚀 Project clarification started for "${projectName}".\n\nQuestion 1: ${result.question}`
        }
      ]
    };
  }

• vibe-services/context-manager/index.ts:182-198 (registration)

  Tool registration in ListTools response, including name, description, and input schema definition.

    name: 'start-clarification',
    description: 'Start a project clarification process',
    inputSchema: {
      type: 'object',
      properties: {
        projectName: {
          type: 'string',
          description: 'The name of the project'
        },
        initialDescription: {
          type: 'string',
          description: 'Initial description of the project'
        }
      },
      required: ['projectName']
    }
  },

• vibe-services/context-manager/index.ts:184-197 (schema)

  Input schema for the 'start-clarification' tool defining parameters projectName (required) and initialDescription (optional).

  inputSchema: {
    type: 'object',
    properties: {
      projectName: {
        type: 'string',
        description: 'The name of the project'
      },
      initialDescription: {
        type: 'string',
        description: 'Initial description of the project'
      }
    },
    required: ['projectName']
  }