From 4b29647b32965f7fd8e569dba20610ae443174a0 Mon Sep 17 00:00:00 2001
From: ryanmac <ryan.maccarthy@gmail.com>
Date: Fri, 25 Jul 2025 13:14:03 -0500
Subject: [PATCH] fix: Add critical [INIT] documentation map task to installer
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The conductor-init.sh installer now creates a high-priority task for building the
documentation map during setup. This addresses user feedback that the installer
should create the initial discovery task that analyzes the codebase and generates
the critical .conductor/documentation-map.yaml file.

Changes:
- Added creation of "[INIT] Build documentation map and analyze codebase" issue
- Set as highest priority task that other tasks depend on
- Includes comprehensive task description with objectives and success criteria
- Task instructs to run generate-tasks-from-map.py after creating the map

This ensures new projects get proper initialization with the documentation map
that provides essential context for all subsequent AI agent tasks.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 conductor-init.sh | 46 +++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

diff --git a/conductor-init.sh b/conductor-init.sh
index e2baa39..ef9333b 100644
--- a/conductor-init.sh
+++ b/conductor-init.sh
@@ -551,7 +551,51 @@ if [ "$IS_UPGRADE" = false ]; then
         EXISTING_TASKS=$(gh issue list -l 'conductor:task' --limit 10 --json number 2>/dev/null | jq length 2>/dev/null || echo "0")
         
         if [ "$EXISTING_TASKS" = "0" ]; then
-            echo "Creating demo GitHub Issues..."
+            echo "Creating initial tasks..."
+            
+            # Create critical documentation map task first
+            gh issue create \
+                --title "[INIT] Build documentation map and analyze codebase" \
+                --body "## Description
+This is the initial discovery task that analyzes the entire codebase to create a comprehensive documentation map. This map is essential for Code Conductor to understand the project structure and generate appropriate tasks.
+
+## Objective
+Create .conductor/documentation-map.yaml with:
+- Complete project analysis and structure mapping
+- Technology stack detection and validation
+- List of existing vs. missing documentation
+- Feature implementation status
+- Critical paths and dependencies
+- Proposed tasks based on project needs
+
+## Success Criteria
+- Documentation map created at .conductor/documentation-map.yaml
+- Project structure fully analyzed and documented
+- Technology stack properly identified
+- Missing documentation identified
+- Generate initial task proposals based on project state
+- Run generate-tasks-from-map.py to create follow-up tasks
+
+## Process
+1. Analyze entire codebase structure
+2. Detect all technologies, frameworks, and tools
+3. Identify existing documentation
+4. Map feature implementation status
+5. Create comprehensive YAML documentation map
+6. Generate missing documentation where possible
+7. Propose initial tasks based on findings
+
+## Priority
+This task has the highest priority as all other tasks depend on the documentation map for context.
+
+## Files to Create/Modify
+- .conductor/documentation-map.yaml (create)
+- .conductor/README.md (update if needed)
+- Project documentation files (as identified)" \
+                --label "conductor:task" \
+                --label "effort:large" \
+                --label "priority:high" \
+                2>/dev/null && echo "  ✅ Created critical task: [INIT] Build documentation map"
             
             # Create first demo task
             gh issue create \