Context Initializer

Context Initializer

This skill detects when Claude Code lacks project context and automatically invokes the init-explorer agent to gather it.

When to Invoke This Skill

Invoke this skill when ANY of these conditions are true:

1. No project context: You don't know what this project is about, its tech stack, or its purpose
2. Missing session history: claude-progress.txt doesn't exist or hasn't been read
3. Missing architect's digest: architects_digest.md doesn't exist or hasn't been read
4. User asks context-dependent questions: The user asks about the project but you have no context
5. Starting a new task: Beginning work on a feature without understanding the codebase

How to Check for Empty Context

Before invoking, verify context is actually missing:

# Check if session files exist
ls -la claude-progress.txt architects_digest.md 2>/dev/null || echo "Context files missing"

Invocation

When context is empty, invoke the init-explorer agent:

Task(subagent_type="init-explorer", prompt="
Gather project context for this codebase.

next_agent: none
task: Explore and document project structure, tech stack, and patterns

After exploration, return a summary of:
1. Project purpose and description
2. Tech stack (languages, frameworks, databases)
3. Key directories and their purpose
4. Testing setup
5. Build/run commands
")

What init-explorer Will Do

The init-explorer agent will:

1. Orient: Run pwd, ls -la, git log, git status
2. Read History: Check claude-progress.txt for previous sessions
3. Read Digest: Check architects_digest.md for task state
4. Explore: Use Explore subagent for deep codebase analysis
5. Create Files: Initialize architects_digest.md if missing
6. Update Progress: Log the exploration session

Expected Output

After init-explorer completes, you will have:

• Understanding of the project's tech stack and purpose
• Knowledge of coding patterns and conventions
• Awareness of test setup and build commands
• Session logged in claude-progress.txt
• Task tracking initialized in architects_digest.md

Example Usage

Scenario: User asks "How does authentication work in this project?"

Before: You have no context about the project.

Action: Invoke this skill to run init-explorer.

After: You understand the project uses Flask with JWT authentication, tests are in tests/, and the auth module is in src/auth/.

Do NOT Invoke When

• You already have project context from earlier in the conversation
• The user explicitly said not to explore
• You're in the middle of a task that already has context
• The init-explorer agent has already run in this session