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