Programming · Research
ditz-map
/ditz-map
Use when you need to understand an unfamiliar codebase fast.
For whom
- Author
- tongkoljaafar-gif ↗
- Repository
- ditzzzai ↗
- Licence
- MIT
- Last repository change
- 29.10.2026
Assessment and security
96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability21 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
Deprecation
No signals detected. Repository changed on 29.10.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when you need to understand an unfamiliar codebase fast.
Original author description
Use when you need to understand an unfamiliar codebase fast.
How it works
- When to Use
- Proses (cepat, hemat token)
- Jangan
Original SKILL.md headings · 46 lines, 289 words
SKILL.md preview
---
name: ditz-map
description: Use when you need to understand an unfamiliar codebase fast.
version: 1.0.0
license: MIT
metadata:
hermes:
tags: [codebase, onboarding, architecture-map]
related_skills: [codebase-inspection, ditz-arch]
---
# ditz-map - Peta Codebase Asing
## When to Use
- Masuk repo baru, harus ngubah sesuatu.
- User nanya "ini repo apa, jalan dari mana?".
- Repo besar dan kamu bingung mulai dari mana.
## Proses (cepat, hemat token)
**1. Fakta permukaan (tanpa baca isi file)**
```bash
ls -la; cat README.md 2>/dev/null | head -60
cat package.json pyproject.toml go.mod Cargo.toml 2>/dev/null | head -60
find . -maxdepth 2 -name "*.json" -o -maxdepth 2 -name "*.toml" -o -maxdepth 2 -name "*.yaml" | grep -v node_modules | head -20
git log --oneline -10
```
Catat: bahasa, framework, package manager, entry point, cara jalan (`npm run dev` / `uvicorn ...` / `go run .`), test runner.
**2. Struktur**
```bash
find . -type d -name node_modules -prune -o -type d -name .git -prune -o -type d -print | head -40
find . -name "*" -type f -not -path "*/node_modules/*" -not -path "*/.git/*" | wc -l
```
**3. Entry point → jalur utama**
Ikuti satu alur dari pintu masuk: route/handler → service → data. Itu ngasih 80% pemahaman.
**4. Bikin peta (simpel, tanpa diagram kalau nggak perlu)**
```
Stack: <framework + db + deploy>
Jalan: <command>
Test: <command>
Pintu masuk: <file>
Alur utama: <route> → <service> → <table>
Config: <env var yang wajib>
Hotspot: <file yang paling sering berubah: git log --format= --name-only | sort | uniq -c | sort -rn | head>
```
**5. Simpan** di `.ditz-map.md` di root repo kalau user bakal sering balik ke sini. Kalau sekali pakai, cukup lapor di chat.
## Jangan
- Baca semua file "biar paham" - itu boros dan nggak perlu.
- Tebak arsitektur dari nama folder doang; verifikasi di satu alur nyata.
- Nulis dokumen panjang; peta 15 baris lebih berguna dari 3 halaman.
Versions
The database has no other skills named ditz-map.
Database snapshot: 13.11.2026 · package version 9f7d81adbfe2 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 86ditz-router
Use to pick which ditz-* engineering skill fits the task. - 86ditz-code
Use when writing or changing code - clean code gates. - 90repo-map
Use when the task is to understand an unfamiliar codebase, locate key entry points, or summarize architecture before editing. - 100codebase-analysis
Use when exploring an unfamiliar codebase, onboarding to a project, or needing to understand module structure before making changes - 100x-ray
Deep codebase exploration using semantic search and relationship mapping. Use when you need to understand the current codebase. - 100understand-chat
Use when you need to ask questions about a codebase or understand code using a knowledge graph