How does this improve Claude's performance?

By providing a pre-parsed map of exports and imports, Claude can navigate the project structure instantly and understand module dependencies without having to manually read every file in the repo.

When should I run the map command?

You should invoke the mapper when starting work on a new project, after significant architectural changes, or when adding many new modules to ensure the AI's context remains accurate.

Which languages does phi-mapper support?

It currently supports TypeScript/JavaScript (.ts, .js, .tsx, .jsx, .mts, .mjs), Python (.py), and Solidity (.sol).

What is the benefit of the S-expression format used by this skill?

S-expressions provide a compositional, human-readable structure that is easy for AI agents and tools like LIPS to parse and query efficiently compared to flat text.

Does this skill modify my source code?

No, phi-mapper is low-risk. It only creates or updates files within the .phi/ directory and does not alter your actual source files.

Phi Project Mapper

Name: Phi Project Mapper
Author: adimov-eth

byadimov-eth

Developer Tools

Generates deterministic structural maps of codebases via AST extraction to provide Claude with deep architectural awareness.

About

Phi Project Mapper automates the creation of PROJECT-MAP.auto.scm files by parsing source files in TypeScript, JavaScript, Python, and Solidity. By extracting named exports, imports, and module relationships into a structured S-expression format, it enables AI agents to understand complex repository architectures without re-parsing every file. This skill is essential for bootstrapping new projects, managing large-scale refactors, and maintaining cross-session structural memory within the Claude Code environment, ensuring that the AI has a clear 'mental map' of the entire project structure.

Key Features

0 GitHub stars
Multi-language AST extraction for TypeScript, Python, and Solidity
Automatic project structure discovery and directory initialization
Detailed module mapping including exports, imports, and line counts
Deterministic output optimized for Git-friendly diffs and AI queries
Generates human-readable S-expression maps for compositional analysis

Use Cases

Providing high-level context to AI agents for complex cross-module tasks
Bootstrapping structural awareness in a new or unfamiliar codebase
Refreshing architectural maps after significant file changes or refactoring

About

Key Features

0 GitHub stars
Multi-language AST extraction for TypeScript, Python, and Solidity
Automatic project structure discovery and directory initialization
Detailed module mapping including exports, imports, and line counts
Deterministic output optimized for Git-friendly diffs and AI queries
Generates human-readable S-expression maps for compositional analysis

Use Cases

Providing high-level context to AI agents for complex cross-module tasks
Bootstrapping structural awareness in a new or unfamiliar codebase
Refreshing architectural maps after significant file changes or refactoring