Update cartography prompt

[alvinunreal]

Summary

Changes

[greptile-apps]

Greptile Overview

Greptile Summary

This PR updates the cartography skill documentation and generates comprehensive repository documentation (codemaps) for the entire codebase. The changes include:

• Updated src/skills/cartography/SKILL.md to use relative paths (./) instead of absolute paths (/path/to/repo) in command examples
• Added Step 4 documentation for creating root-level repository atlas with aggregated directory maps
• Enhanced codemap content guidelines to emphasize precise technical terminology and design patterns
• Removed .slim/ from .gitignore to commit the cartography state tracking file
• Generated .slim/cartography.json containing MD5 hashes of 70 TypeScript files and 15 folders for change detection
• Created 19 codemap.md files documenting architecture, design patterns, data flow, and integration points across all major modules

The generated codemaps provide detailed architectural documentation covering agents, background task management, CLI installer, configuration system, hooks, MCP connectors, tools (AST-grep, ripgrep, LSP, quota), and utilities. Each codemap follows a consistent structure with Responsibility, Design, Flow, and Integration sections.

Confidence Score: 4/5

• Safe to merge after fixing the hardcoded absolute path in cartography.json
• The PR primarily adds documentation files and configuration state. The only critical issue is the hardcoded absolute path in .slim/cartography.json that needs to be changed to a relative path. Once fixed, the changes are purely additive documentation that improves codebase understanding without affecting runtime behavior.
• .slim/cartography.json requires fixing the hardcoded absolute path on line 5

Important Files Changed

Filename	Overview
.gitignore	Removed .slim/ from gitignore to commit cartography state files
.slim/cartography.json	Added cartography state with file/folder hashes; contains hardcoded absolute path that needs fixing
codemap.md	Root repository atlas providing project overview and directory map with navigation links
src/codemap.md	Main plugin architecture overview showing integration of agents, tools, hooks, and background managers
src/skills/cartography/SKILL.md	Updated cartography skill with relative paths and expanded documentation on root codemap creation

Sequence Diagram

sequenceDiagram
    participant User
    participant Orchestrator
    participant CartographySkill
    participant CartographerScript
    participant Explorer
    participant FileSystem

    User->>Orchestrator: Request to map repository
    Orchestrator->>CartographySkill: Activate cartography skill
    
    CartographySkill->>FileSystem: Check for .slim/cartography.json
    alt State file exists
        CartographySkill->>CartographerScript: Run changes command
        CartographerScript->>FileSystem: Read .slim/cartography.json
        CartographerScript->>FileSystem: Compute current file hashes
        CartographerScript-->>CartographySkill: Return changed files/folders
        CartographySkill->>Explorer: Spawn explorers for affected folders
    else State file does not exist
        CartographySkill->>FileSystem: Analyze repository structure
        CartographySkill->>CartographerScript: Run init command with patterns
        CartographerScript->>FileSystem: Create .slim/cartography.json
        CartographerScript->>FileSystem: Create empty codemap.md files
        CartographerScript-->>CartographySkill: Initialization complete
        CartographySkill->>Explorer: Spawn explorers for all folders
    end
    
    loop For each folder
        Explorer->>FileSystem: Read source files
        Explorer->>FileSystem: Write codemap.md with architecture details
        Explorer-->>CartographySkill: Folder documentation complete
    end
    
    CartographySkill->>CartographerScript: Run update command
    CartographerScript->>FileSystem: Update .slim/cartography.json hashes
    CartographerScript-->>CartographySkill: State saved
    
    CartographySkill->>Orchestrator: Create root codemap.md
    Orchestrator->>FileSystem: Write repository atlas
    Orchestrator-->>User: Repository mapping complete

Loading

[greptile-apps]

_{1 file reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

Hardcoded absolute path /Users/xp/repos/oh-my-opencode-slim should use a relative path or be removed. This path is specific to the developer's machine and will break for other users.

Suggested change

	"root": "/Users/xp/repos/oh-my-opencode-slim",
	"root": "./",

Prompt To Fix With AI

This is a comment left during a code review.
Path: .slim/cartography.json
Line: 5:5

Comment:
Hardcoded absolute path `/Users/xp/repos/oh-my-opencode-slim` should use a relative path or be removed. This path is specific to the developer's machine and will break for other users.

```suggestion
    "root": "./",
```

How can I resolve this? If you propose a fix, please make it concise.