init_project_docs

Instructions

Implementation Reference

• src/index.ts:1752-1812 (handler)

  Handler for 'document_organizer__init_project_docs' tool (matches 'init_project_docs'): parses input, creates documentation directories (docs/plans/*, docs/progress), generates and writes template MD files (CURRENT_STATUS.md, ACTIVE_PLAN.md, .claude-instructions.md), skips existing files, returns JSON summary

  case "document_organizer__init_project_docs": {
    const { directory_path, project_name, project_type } = InitProjectDocsArgsSchema.parse(args);
    const validatedPath = validatePath(directory_path);
    
    // Create required directory structure
    const requiredDirs = [
      'docs',
      'docs/plans',
      'docs/plans/archived',
      'docs/plans/superseded',
      'docs/progress'
    ];
    
    for (const dir of requiredDirs) {
      await fs.mkdir(path.join(validatedPath, dir), { recursive: true });
    }
    
    // Generate templates
    const currentStatusContent = generateCurrentStatusTemplate(project_name, project_type);
    const activePlanContent = generateActivePlanTemplate(project_name);
    const claudeInstructionsContent = generateClaudeInstructionsTemplate(project_name, project_type);
    
    // Write required files
    const filesToCreate = [
      { path: 'CURRENT_STATUS.md', content: currentStatusContent },
      { path: 'ACTIVE_PLAN.md', content: activePlanContent },
      { path: '.claude-instructions.md', content: claudeInstructionsContent }
    ];
    
    const createdFiles = [];
    const skippedFiles = [];
    
    for (const file of filesToCreate) {
      const fullPath = path.join(validatedPath, file.path);
      try {
        // Check if file already exists
        await fs.access(fullPath);
        skippedFiles.push(file.path);
      } catch {
        // File doesn't exist, create it
        await fs.writeFile(fullPath, file.content, 'utf-8');
        createdFiles.push(file.path);
      }
    }
    
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            project_initialized: true,
            project_path: validatedPath,
            directories_created: requiredDirs,
            files_created: createdFiles,
            files_skipped: skippedFiles,
            message: `Project documentation standard initialized for ${project_name}`
          }, null, 2)
        }
      ]
    };
  }

• src/index.ts:71-75 (schema)

  Zod input schema validation for init_project_docs tool parameters: directory_path (required), project_name (required), project_type (optional)

  const InitProjectDocsArgsSchema = z.object({
    directory_path: z.string().describe("Path to project directory to initialize with documentation standard"),
    project_name: z.string().describe("Name of the project for templates"),
    project_type: z.string().optional().describe("Type of project (e.g., 'web-app', 'api', 'library')")
  });

• src/index.ts:1331-1334 (registration)

  MCP tool registration entry for 'document_organizer__init_project_docs' (init_project_docs), with description and schema reference

    name: "document_organizer__init_project_docs",
    description: "📋 INITIALIZE PROJECT DOCUMENTATION - Create Universal Project Documentation Standard structure with required files (CURRENT_STATUS.md, ACTIVE_PLAN.md, .claude-instructions.md) and directory structure. Generates templates customized for the specific project type and creates docs/plans/archived, docs/progress directories for proper documentation management.",
    inputSchema: zodToJsonSchema(InitProjectDocsArgsSchema) as ToolInput,
  },

• src/index.ts:899-932 (helper)

  Helper function generating content template for CURRENT_STATUS.md file used by the tool handler

  function generateCurrentStatusTemplate(projectName: string, projectType?: string): string {
    const currentDate = new Date().toISOString().split('T')[0];
    return `# ${projectName} - Current Project Status
  **Last Updated:** ${currentDate}  
  **Active Plan:** [ACTIVE_PLAN.md](./ACTIVE_PLAN.md)  
  **Current Branch:** main  
  **Project Focus:** ${projectType || 'Development project'}  
  
  ## What's Actually Done ✅
  - [ ] Initial project setup
  
  ## In Progress 🟡
  - [ ] Document project requirements
  - [ ] Set up development environment
  
  ## Blocked/Issues ❌
  - [ ] No current blockers identified
  
  ## Next Priority Actions
  1. Define project scope and requirements
  2. Set up development environment
  3. Create initial architecture
  
  ## Component/Feature Status Matrix
  | Component | Design | Backend | Frontend | Testing | Status |
  |-----------|--------|---------|----------|---------|--------|
  | Core Setup | 🟡 | ❌ | ❌ | ❌ | 25% Complete |
  
  ## Recent Key Decisions
  - **${currentDate}:** Implemented Universal Project Documentation Standard
  
  ## Development Environment Status
  - **Development Setup:** 🟡 In Progress
  `;

• src/index.ts:935-990 (helper)

  Helper function generating content template for ACTIVE_PLAN.md file used by the tool handler

  function generateActivePlanTemplate(projectName: string): string {
    const currentDate = new Date().toISOString().split('T')[0];
    return `# ${projectName} Active Development Plan
  **Status:** ACTIVE  
  **Created:** ${currentDate}  
  **Last Updated:** ${currentDate}  
  **Supersedes:** N/A (Initial plan)  
  
  ## Current Focus: Initial Project Setup
  
  ## Immediate Priorities (Next 1-2 Weeks)
  
  ### 1. Project Foundation (High Priority)
  **Status:** 0% Complete  
  **Remaining Work:**
  - [ ] Define project scope and objectives
  - [ ] Set up development environment
  - [ ] Create initial architecture documentation
  - [ ] Establish development workflow
  
  **Files to Work On:**
  - \`README.md\` - Project overview and setup instructions
  - \`.gitignore\` - Version control configuration
  - \`package.json\` or equivalent - Project dependencies
  
  ### 2. Documentation Setup (Medium Priority)
  **Status:** 50% Complete  
  **Remaining Work:**
  - [ ] Complete project documentation structure
  - [ ] Create development guidelines
  - [ ] Set up automated documentation
  
  ## Success Criteria
  - [ ] Development environment is fully functional
  - [ ] Project structure is established
  - [ ] Initial documentation is complete
  - [ ] Development workflow is defined
  
  ## Weekly Milestones
  ### Week 1 (${currentDate})
  - [ ] Complete project setup
  - [ ] Establish documentation standard
  - [ ] Define initial architecture
  
  ## Risk Mitigation
  ### High-Risk Items
  1. **Scope Creep:** Project requirements may expand
     - *Mitigation:* Define clear boundaries and priorities
     - *Fallback:* Phase development approach
  
  ## Contact Points
  ### Immediate Next Actions (This Week)
  1. **Priority 1:** Define project scope and requirements
  2. **Priority 2:** Set up development environment
  3. **Priority 3:** Create initial architecture documentation
  `;