prepare

Memory Prepare Command (/memory:prepare)

1. Overview

The memory:prepare command delegates to a universal-executor agent to analyze the project and return a structured "Core Content Pack". This pack is loaded into the main thread's memory, providing essential context for subsequent agent operations while minimizing token consumption.

Core Philosophy:

• Agent-Driven: Fully delegates execution to universal-executor agent
• Read-Only Analysis: Does not modify code, only extracts context
• Structured Output: Returns standardized JSON content package
• Memory Optimization: Package loaded directly into main thread memory
• Token Efficiency: CLI analysis executed within agent to save tokens

2. Parameters

• "task context description" (Required): Task description to guide context extraction

  • Example: "在当前前端基础上开发用户认证功能"
  • Example: "重构支付模块API"
  • Example: "修复数据库查询性能问题"

• --tool <gemini|qwen> (Optional): Specify CLI tool for agent to use (default: gemini)

  • gemini: Large context window, suitable for complex project analysis
  • qwen: Alternative to Gemini with similar capabilities

3. Agent-Driven Execution Flow

The command fully delegates to universal-executor agent, which autonomously:

1. Analyzes Project Structure: Executes get_modules_by_depth.sh to understand architecture
2. Loads Documentation: Reads CLAUDE.md, README.md and other key docs
3. Extracts Keywords: Derives core keywords from task description
4. Discovers Files: Uses CodexLens MCP or rg/find to locate relevant files
5. CLI Deep Analysis: Executes Gemini/Qwen CLI for deep context analysis
6. Generates Content Package: Returns structured JSON core content package

4. Core Content Package Structure

Output Format - Loaded into main thread memory for subsequent use:

{
  "task_context": "在当前前端基础上开发用户认证功能",
  "keywords": ["前端", "用户", "认证", "auth", "login"],
  "project_summary": {
    "architecture": "TypeScript + React frontend with Vite build system",
    "tech_stack": ["React", "TypeScript", "Vite", "TailwindCSS"],
    "key_patterns": [
      "State management via Context API",
      "Functional components with Hooks pattern",
      "API calls encapsulated in custom hooks"
    ]
  },
  "relevant_files": [
    {
      "path": "src/components/Auth/LoginForm.tsx",
      "relevance": "Existing login form component",
      "priority": "high"
    },
    {
      "path": "src/contexts/AuthContext.tsx",
      "relevance": "Authentication state management context",
      "priority": "high"
    },
    {
      "path": "CLAUDE.md",
      "relevance": "Project development standards",
      "priority": "high"
    }
  ],
  "integration_points": [
    "Must integrate with existing AuthContext",
    "Follow component organization pattern: src/components/[Feature]/",
    "API calls should use src/hooks/useApi.ts wrapper"
  ],
  "constraints": [
    "Maintain backward compatibility",
    "Follow TypeScript strict mode",
    "Use existing UI component library"
  ]
}