atlas.overview

SourceAtlas: Project Overview (Stage 0 Fingerprint)

Constitution: This command operates under ANALYSIS_CONSTITUTION.md v1.0

Key principles enforced:

• Article I: High-entropy priority, scan ratio limits
• Article II: Mandatory directory exclusions
• Article III: Hypothesis count limits, required elements
• Article IV: Evidence format requirements

Context

Arguments: ${ARGUMENTS:-.}

Save Mode: Check if --save is in arguments. If present:

• Remove --save from path argument
• After analysis, save YAML to .sourceatlas/overview.yaml
• Create .sourceatlas/ directory if needed

Analysis Target: Parse from arguments (default: current directory)

Goal: Generate a comprehensive project fingerprint by scanning <5% of files to achieve 70-80% understanding in 10-15 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 argument (e.g., src/api): .sourceatlas/overview-src-api.yaml (slashes to -)

2. Check if cache exists:

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

3. If cache exists:

   • Read modification date from ls output
   • Calculate days since modification
   • Use Read tool to read cache content
   • Output:

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

   • If over 30 days, also show:

     ⚠️ Cache is over 30 days old, recommend re-analysis
     

   • Then output:

     ---
     [cache content]
     

   • End, do not execute subsequent analysis

4. If cache does not exist: Continue with the analysis flow below

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

---

Your Task

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