overview

SourceAtlas: Project Overview (Stage 0 Fingerprint)

Constitution: ANALYSIS_CONSTITUTION.md v1.0

Context

Arguments: ${ARGUMENTS:-.}

Goal: Generate project fingerprint by scanning <5% of files to achieve 70-80% understanding in 10-15 minutes.

Auto-Save: Results automatically saved to .sourceatlas/overview.yaml (or subdirectory-specific path)

Time Limit: 10-15 minutes (typically 0-5 minutes)

---

Cache Check (Highest Priority)

If --force is NOT in arguments, check cache first:

1. Calculate cache path:

   • No path argument or .: .sourceatlas/overview.yaml
   • With path (e.g., src/api): .sourceatlas/overview-src-api.yaml

2. Check if cache exists:

   ls -la .sourceatlas/overview.yaml 2>/dev/null
   

3. If cache exists:

   • Calculate days since modification
   • Use Read tool to read cache
   • Output:

     📁 Loading cache: .sourceatlas/overview.yaml (N days ago)
     💡 Add --force to re-analyze
     

   • If over 30 days: Show warning
   • Output cache content
   • End, do not execute analysis

4. If cache does not exist: Continue with analysis

If --force is in arguments: Skip cache, execute analysis

---

Your Task

Execute Stage 0 Analysis Only - generate project fingerprint using information theory principles.

Information Theory Approach:

• High-entropy files contain disproportionate information
• Scan priority: Documentation → Configuration → Models → Entry Points → Tests
• Scale-aware: TINY/SMALL/MEDIUM/LARGE/VERY_LARGE projects need different approaches

---

Core Workflow

Execute these phases in order. See workflow.md for complete details.

Phase 1: Project Detection & Scale-Aware Planning (2-3 minutes)

Purpose: Detect project type, count files, determine scale, set scan limits.

Execute detection:

# Try helper script first (recommended)
if [ -f ~/.claude/scripts/atlas/detect-project.sh ]; then
    bash ~/.claude/scripts/atlas/detect-project.sh ${ARGUMENTS:-.}
elif [ -f scripts/atlas/detect-project.sh ]; then
    bash scripts/atlas/detect-project.sh ${ARGUMENTS:-.}
else
    echo "Warning: detect-project.sh not found, using manual detection"
fi