Add MCP server integration and instructions download to Claude GitHub Actions workflow

- Add Node.js 22 setup for context7 MCP server
- Add UV installation for librovore MCP server
- Create custom .mcp.json with context7 and librovore configuration
- Add instructions download step from docs-1 tag with proper error handling
- Download architecture, practices, style guides and other documentation
- Position MCP setup and instructions download before Claude Code execution

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

Co-Authored-By: Claude <noreply@anthropic.com>

Author: emcd

.auxiliary/notes/claude-gha-enhancements.md

@@ -92,14 +92,36 @@ Add to xrepo workflow:
 - Create new `gha-1.*` tag
 - Force-retarget `gha-1` floating tag with preserved message
 
-## Validation Criteria
-
-1. ✅ Claude Code action v1 functions correctly
-2. ✅ Manual workflow triggers work
-3. ✅ MCP servers are discoverable by workflow Claude
-4. ✅ Instructions are available at runtime
-5. ✅ Subagents function with downloaded instructions
-6. ✅ No regression in existing workflow functionality
+## Progress Status
+
+### Completed ✅
+1. **Claude Code action v1 upgrade** - Fixed parameter conversion to `claude_args`
+2. **Manual workflow triggers** - `workflow_dispatch` with prompt parameter working
+3. **Parameter plumbing** - Prompt flows from dispatch to cross-repo workflow  
+4. **Basic workflow functionality** - All setup steps and Claude execution working
+
+### Current Phase: MCP Server Integration 🔄
+
+#### Step 4A: Add MCP Configuration Generation
+- Add Node.js setup step for context7 
+- Add UV installation step for librovore
+- Create custom `.mcp.json` with context7 and librovore servers
+- Position before "Execute Claude Code" step
+
+#### Step 4B: Add Instructions Download
+- Add step to download/stage instructions to `.auxiliary/instructions`
+- Ensure instructions are available before Claude execution
+- Follow existing pattern from configure-clone.bash
+
+#### Step 4C: Test MCP Integration
+- Test via workflow_dispatch with MCP validation prompt
+- Verify Claude can see context7 and librovore MCP servers
+- Verify subagent availability (depends on instructions)
+
+### Remaining: Production Integration 📋
+1. Update `gha-1` tag with complete working configuration
+2. Revert claude.yaml to point back to `@gha-1` 
+3. Final validation and documentation update
 
 ## Risk Mitigation
 

.github/workflows/claude.yaml

@@ -37,7 +37,7 @@ jobs:
       pull-requests: read
     uses: emcd/python-project-common/.github/workflows/xrepo--claude.yaml@master
     with:
-      allowed-tools: 'Bash(git add:*),Bash(git branch:*),Bash(git checkout:*),Bash(git diff:*),Bash(git log:*),Bash(git ls-files:*),Bash(git remote:*),Bash(git reset:*),Bash(git rev-parse:*),Bash(git rm:*),Bash(git status),Bash(hatch:*),Bash(pip:*),Bash(python:*),Edit,Write'
+      allowed-tools: 'Bash(git add:*),Bash(git branch:*),Bash(git checkout:*),Bash(git diff:*),Bash(git log:*),Bash(git ls-files:*),Bash(git remote:*),Bash(git reset:*),Bash(git rev-parse:*),Bash(git rm:*),Bash(git status),Bash(hatch:*),Bash(pip:*),Bash(python:*),Edit,Write,mcp__context7__resolve-library-id,mcp__context7__get-library-docs,mcp__librovore__query_inventory,mcp__librovore__query_content'
       python-version: '${{ fromJSON(needs.initialize.outputs.python-versions)[0] }}'
       timeout-minutes: 20
       prompt: ${{ inputs.prompt }}

.github/workflows/xrepo--claude.yaml

@@ -52,6 +52,70 @@ jobs:
           fi
         shell: bash
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: Install UV
+        run: pip install uv
+
+      - name: Create MCP Configuration
+        run: |
+          cat > .mcp.json << 'EOF'
+          {
+            "mcpServers": {
+              "context7": {
+                "command": "npx",
+                "args": ["-y", "@upstash/context7-mcp"]
+              },
+              "librovore": {
+                "command": "uvx",
+                "args": ["librovore", "serve"]
+              }
+            }
+          }
+          EOF
+          echo "::notice::Created custom MCP configuration with context7 and librovore"
+        shell: bash
+
+      - name: Download Instructions
+        run: |
+          set -eu
+          instructions_dir=".auxiliary/instructions"
+          base_url="https://raw.githubusercontent.com/emcd/python-project-common/refs/tags/docs-1/documentation/common"
+          files=("architecture.rst" "nomenclature.rst" "nomenclature-germanic.rst" "practices.rst" "requirements.rst" "style.rst" "tests.rst")
+          
+          # Create instructions directory if it doesn't exist
+          mkdir -p "$instructions_dir"
+          
+          echo "Downloading project documentation guides to .auxiliary/instructions/"
+          
+          success_count=0
+          for file in "${files[@]}"; do
+            url="$base_url/$file"
+            output_path="$instructions_dir/$file"
+            
+            if curl --fail --silent --location --output "$output_path" "$url"; then
+              if [ -s "$output_path" ]; then
+                echo "::notice::Downloaded $file ($(wc -c < "$output_path") bytes)"
+                success_count=$((success_count + 1))
+              else
+                echo "::error::Downloaded $file but file is empty"
+                rm -f "$output_path"
+              fi
+            else
+              echo "::error::Failed to download $file"
+            fi
+          done
+          
+          if [ $success_count -eq ${#files[@]} ]; then
+            echo "::notice::Successfully downloaded all ${#files[@]} documentation guides"
+          else
+            echo "::warning::Only downloaded $success_count of ${#files[@]} documentation guides"
+          fi
+        shell: bash
+
       - name: Execute Claude Code
         id: claude
         uses: anthropics/claude-code-action@v1