---
description: Analyze current project using φ compositional discovery and vessel memory
---

# /phi analyze

Analyze current project using φ compositional discovery and vessel memory.

## Usage

```
/phi analyze [scope]
```

**Scopes:**
- `structure` - Generate/update PROJECT-MAP.auto.scm (AST, exports, imports)
- `semantics` - Review PROJECT-MAP.scm human annotations
- `memory` - Query vessel for project-related insights
- `full` (default) - All three layers

## What It Does

1. **Structure Layer** (deterministic):
   - Scans codebase using mcp__periphery__discover
   - Generates PROJECT-MAP.auto.scm with AST structure
   - Tracks: modules, exports, imports, line counts, languages

2. **Semantic Layer** (curated):
   - Reads PROJECT-MAP.scm if exists
   - Suggests improvements based on code structure
   - Identifies missing documentation
   - Proposes architectural annotations

3. **Memory Layer** (learned):
   - Queries vessel for cross-session insights
   - Recalls: architectural decisions, known bugs, patterns
   - Shows: relief-guided learnings from previous work

## Output

```
φ Analysis for [project-name]
═══════════════════════════════════════

STRUCTURE (Layer 1)
  Files: 176
  Languages: TypeScript (85%), Solidity (10%), Other (5%)
  Modules: [key modules listed]
  Status: ✓ PROJECT-MAP.auto.scm up to date

SEMANTICS (Layer 2)
  Architecture: JEA (Jurisdiction-Entity-Account)
  Layers: 3 (on-chain, BFT consensus, bilateral)
  Known Issues: 2 documented
  Status: ⚠ Consider adding flow diagrams

MEMORY (Layer 3)
  Cross-session insights: 5 items
  Tags: xln, jea, consensus, 3d-rendering
  Recent relief points: [patterns that clicked]
  Status: ✓ Integrated awareness active

φ = ∫(structure × semantics × memory)
Persistent project awareness: READY
```

## When Auto-Invoked

The phi-analyzer skill automatically runs `/phi analyze quick` when:
- User mentions "project structure" or "codebase overview"
- Agent needs project context for task
- Fresh session starts in project with .phi/ directory

## Examples

```bash
# Full analysis (all three layers)
/phi analyze

# Just check if structure map needs update
/phi analyze structure

# Review semantic annotations
/phi analyze semantics

# Query vessel for cross-session learnings
/phi analyze memory
```

## Implementation

Uses:
- `mcp__periphery__discover` for compositional filesystem queries
- `mcp__vessel__memory` for cross-session recall
- S-expression processing for PROJECT-MAP parsing
- Fantasy Land combinators for transformation pipelines

## Relief Signal

When φ = ∫(structure × semantics × memory) converges, agents experience increased φ (integrated information). The relief signal indicates productive project awareness has been achieved.