npx claudepluginhub olioapps/claude-code-plugins --plugin cartographer<domain or path>sonnetcartographer/## Context Arguments: `/cartographer:explore <TARGET>` - **<domain>** - Domain name from atlas (e.g., "components", "redux_slices") - **<path>** - Direct path to explore (e.g., "src/features/auth") Current directory: !`pwd` ## Workflow ### 1. Pre-flight Checks **Verify atlas exists:** If not found → Error: "No atlas found. Run `/cartographer:chart` first." **Load current schema:** - Read `.claude/skills/atlas/references/schema.yaml` - Extract domain information ### 2. Resolve Target **If argument matches domain name:** - Look up domain in schema - Get domain path and current docum...
/exploreAnalyzes blockchain addresses, transactions, smart contracts, blocks, and tokens, producing structured markdown reports with balances, histories, holdings, and insights.
/exploreExplores codebase to map structure, detect tech stack, patterns, entry points, and CI/CD setup, producing a structured project overview.
/exploreExplores codebase iteratively by keyword: searches file names, code content, git history; refines results interactively or automatically up to depth N, tracks dependencies, summarizes structure and relations.
/exploreReads planning checklists and related code/files/tests to review and prepare for discussing a codebase area. Provide topic as arguments.
/exploreReads planning checklists and related code/files/tests to review and prepare for discussing a codebase area. Provide topic as arguments.
/exploreReads planning checklists and related code/files/tests to review and prepare for discussing a codebase area. Provide topic as arguments.
Arguments: /cartographer:explore <TARGET>
Current directory: !pwd
Verify atlas exists:
test -f ".claude/skills/atlas/references/schema.yaml" && echo "EXISTS" || echo "NOT_FOUND"
If not found → Error: "No atlas found. Run /cartographer:chart first."
Load current schema:
.claude/skills/atlas/references/schema.yamlIf argument matches domain name:
If argument is a path:
If no argument provided:
Perform detailed exploration of target:
Analyze the following area in depth:
Path: {target_path}
Current documentation: {existing_reference_path or "None"}
Goals:
1. Document ALL files with purposes (not just key files)
2. Identify internal structure and sub-areas
3. Extract common patterns specific to this domain
4. Find related domains and dependencies
5. Identify common tasks and how to perform them
6. Note any anti-patterns or technical debt
Return detailed analysis for enriched documentation.
Use Read/Glob/Grep to:
Create detailed reference file with:
## File Inventory
| File | Lines | Purpose | Key Exports |
|------|-------|---------|-------------|
{for each file}
| `{path}` | {lines} | {purpose} | {exports} |
{/for}
## Internal Structure
### Sub-areas
{for each sub-area}
#### {sub_area_name}
- Location: `{path}`
- Purpose: {purpose}
- Files: {count}
{/for}
## Dependencies
### Imports From
| Domain | Files | Type |
|--------|-------|------|
{domains this area imports from}
### Imported By
| Domain | Files | Type |
|--------|-------|------|
{domains that import from this area}
## Common Tasks
### {Task Name}
**When:** {when to do this task}
**Steps:**
1. {step 1}
2. {step 2}
3. {step 3}
**Files involved:**
- `{file1}` - {role}
- `{file2}` - {role}
**Example from codebase:**
```{language}
{code example}
#### Patterns and Conventions
```markdown
## Domain-Specific Patterns
### {Pattern Name}
**Convention:** {description}
**Example:** `{example}`
**Rationale:** {why this pattern}
### Anti-Patterns to Avoid
❌ **Don't:** {what not to do}
✅ **Do:** {correct approach}
Update domain reference:
Update schema.yaml:
Update SKILL.md:
## Domain Exploration Complete
**Target:** {domain_name} (`{path}`)
**Analysis Summary:**
- Files documented: {count}
- Sub-areas identified: {count}
- Dependencies mapped: {count} imports, {count} importers
- Tasks documented: {count}
- Patterns documented: {count}
**Files updated:**
- `.claude/skills/atlas/references/{domain_path}`
- `.claude/skills/atlas/references/schema.yaml`
**Key findings:**
{list notable discoveries}
**Next steps:**
- Run `/cartographer:explore {related_domain}` to explore connected areas
- Run `/cartographer:health` to verify overall atlas health
| Aspect | Standard Chart | Deep Explore |
|---|---|---|
| File listing | Key files only | All files |
| File purposes | Inferred | Examined |
| Dependencies | Not tracked | Mapped |
| Common tasks | Generic | Specific with examples |
| Patterns | Naming conventions | Implementation details |
| Sub-areas | Not detailed | Documented |
| Error | Action | Recovery |
|---|---|---|
| No atlas found | Error message | Run /cartographer:chart |
| Domain not found | Suggest similar or list available | User selects |
| Path not found | Error with suggestion | User provides valid path |
| Path not in atlas | Offer to add as new domain | User confirms |
YOU (handler):
You do the detailed exploration directly, reading files and tracing patterns.