Skip to content
Skills Library
Programming · Research

ditz-map

/ditz-map

Use when you need to understand an unfamiliar codebase fast.

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

  1. When to Use
  2. Proses (cepat, hemat token)
  3. 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

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.