codebase-analysislisted
Install: claude install-skill sequenzia/agent-alchemy
# Codebase Analysis Workflow
Execute a structured 3-phase codebase analysis workflow to gather insights.
## Phase Overview
1. **Deep Analysis** — Explore and synthesize codebase findings via the deep-analysis skill
2. **Reporting** — Present structured analysis to the user
3. **Post-Analysis Actions** — Save, document, or retain analysis insights
---
## Phase 1: Deep Analysis
**Goal:** Explore the codebase and synthesize findings.
1. **Determine analysis context:**
- If arguments are provided, use them as the analysis context
- If no arguments, set context to "general codebase understanding"
2. **Check for cached results:**
- Check if `.agents/sessions/exploration-cache/manifest.md` exists
- If found, read the manifest and verify: `codebase_path` matches the current working directory, and `timestamp` is within the configured cache TTL (default 24 hours)
- **If cache is valid**, prompt the user:
- **Use cached results** (show the formatted cache date) — Read cached synthesis from `.agents/sessions/exploration-cache/synthesis.md` and recon from `recon_summary.md`. Set `CACHE_HIT = true` and `CACHE_TIMESTAMP` to the cache's timestamp. Skip step 3 and proceed directly to step 4.
- **Run fresh analysis** — Remove the cache manifest file, set `CACHE_HIT = false`, and proceed to step 3
- **If no valid cache**: set `CACHE_HIT = false` and proceed to step 3
3. **Run deep-analysis workflow:**
- Refer to the **deep-analysis** skill and follow its