Files

T

claude 389ac2e460 style(no-slop): remove every em-dash + banned words across all modules + capstone

Apply the no-ai-slop standard (now binding in AGENTS.md): the em-dash character is
banned outright (restructured, not blind-replaced), plus the banned word/phrase
list (delve, leverage, robust, seamless, truly, unlock, etc.). 0 em-dashes remain
in modules + capstone; the only "robust" left is the planted M10 ai-change.patch
trap. Module H1 titles use a colon separator.

All deliberate teaching devices preserved; labs compile/parse (py/sh/yaml/json);
no junk. AGENTS.md updated with the hard no-slop rules.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TfzV5QvtPDz8LJS3Pu5VLT

2026-06-22 23:21:09 -04:00

1.8 KiB

Raw Blame History

Skill: Map this repo

A navigation playbook (a Module 21 skill) for orienting in a codebase you didn't write. Point Claude Code (or sub your own agent) at this file as a skill, or paste it in as instructions. The goal is a read-only mental model; no edits happen here.

When to use

At the start of any session on an unfamiliar repo, before any change is discussed.

Rules

Read only. Do not edit, create, or delete files while mapping. No exceptions.
Cite real paths. Every claim about the code must point to a file and, ideally, a line range. If you can't cite it, say "unverified" instead of guessing.
Breadth before depth. Establish the whole shape before going deep on any one area.
No conclusions from file names alone. A file called auth.py may not be where auth lives.

Steps

Read the orientation pack (from orient.py), the README, and any CONTRIBUTING, ARCHITECTURE, or committed AI-instructions file. Treat these as claims to verify, not truth.
Identify the entry points: how does this thing start? (CLI main, web server, library exports.) Name the exact file(s).
Trace one representative request/command end to end, from entry point to where it does its real work and back. List the files it passes through, in order.
Produce an architecture summary (max ~1 page):
- One paragraph: what this project does and how it's structured.
- A "where things live" table: concern -> directory/file.
- The build/test/run commands, confirmed against the README or CI config.
- 3-5 things that surprised you or look risky to touch.
List open questions you could not resolve from the code. Do not paper over them.

Output

A single Markdown summary. End with: "Verified against: ."

1.8 KiB Raw Blame History