compass

move executables to bin/ folder; rn summarize->skim.

commit 037b7fe1d539c6eed00ddb80a05ec65457d1ecbb · parent 9920325da1 · browse this tree
Eric Myhre, 2026-06-24 17:30:44 UTC

diff --git a/README.md b/README.md
index 3547a7a..e15fb51 100644
--- a/README.md
+++ b/README.md
@@ -26,8 +26,8 @@ or compose into larger summaries (e.g. an agent's system prompt).
 - `orient-git`         -- describes the surrounding git repo, if any.
 - `orient-project`     -- inlines root orientation docs and detects a meta repo.
 - `skim-makefile`      -- summarizes a Makefile's targets as a bullet list.
-- `summarize-md-toc`   -- emits a markdown file's heading structure as a bullet list.
+- `skim-md-toc`        -- emits a markdown file's heading structure as a bullet list.
 
-Scripts share verb-prefix conventions (`orient-*`, `summarize-*`, ...)
+Scripts share verb-prefix conventions (`orient-*`, `skim-*`, ...)
 so they tab-complete as groups
 when you remember the kind of thing you want but not the specific name.
diff --git a/find-project-root b/bin/find-project-root
similarity index 100%
rename from find-project-root
rename to bin/find-project-root
diff --git a/orient-contextdocs b/bin/orient-contextdocs
similarity index 97%
rename from orient-contextdocs
rename to bin/orient-contextdocs
index aab8a2f..d1650a8 100755
--- a/orient-contextdocs
+++ b/bin/orient-contextdocs
@@ -11,7 +11,7 @@
 #   README, CONTRIBUTING, HACKME, AGENTS, CLAUDE (any case, common extensions),
 #   and `.editorconfig`.
 #
-# Markdown docs are summarized as a heading-only TOC (via `summarize-md-toc`)
+# Markdown docs are summarized as a heading-only TOC (via `skim-md-toc`)
 # rather than inlined in full: context docs can be large, and the headings are
 # usually enough to know whether to open them.
 #
@@ -41,7 +41,7 @@ set -euo pipefail
 
 self_dir=$(cd "$(dirname "$(readlink -f "$0")")" && pwd)
 find_root="$self_dir/find-project-root"
-summarize="$self_dir/summarize-md-toc"
+summarize="$self_dir/skim-md-toc"
 
 skip_root=0
 while [ $# -gt 0 ]; do
diff --git a/orient-cwd b/bin/orient-cwd
similarity index 100%
rename from orient-cwd
rename to bin/orient-cwd
diff --git a/orient-entrypoints b/bin/orient-entrypoints
similarity index 100%
rename from orient-entrypoints
rename to bin/orient-entrypoints
diff --git a/orient-files b/bin/orient-files
similarity index 100%
rename from orient-files
rename to bin/orient-files
diff --git a/orient-git b/bin/orient-git
similarity index 100%
rename from orient-git
rename to bin/orient-git
diff --git a/orient-project b/bin/orient-project
similarity index 100%
rename from orient-project
rename to bin/orient-project
diff --git a/skim-makefile b/bin/skim-makefile
similarity index 100%
rename from skim-makefile
rename to bin/skim-makefile
diff --git a/summarize-md-toc b/bin/skim-md-toc
similarity index 97%
rename from summarize-md-toc
rename to bin/skim-md-toc
index a89f84b..4b259d5 100755
--- a/summarize-md-toc
+++ b/bin/skim-md-toc
@@ -1,7 +1,7 @@
 #!/bin/bash
 # Extracts headings from a markdown file as an indented bullet list.
 #
-# Usage: summarize-md-toc PATH
+# Usage: skim-md-toc PATH
 #
 # Output: one bullet per heading, indented by level, with the hash prefix
 # included so the level reads clearly without counting indents.  Example:
@@ -28,12 +28,12 @@
 set -euo pipefail
 
 if [ $# -lt 1 ]; then
-	echo "usage: summarize-md-toc PATH" >&2
+	echo "usage: skim-md-toc PATH" >&2
 	exit 2
 fi
 file="$1"
 if [ ! -f "$file" ]; then
-	echo "summarize-md-toc: not a file: $file" >&2
+	echo "skim-md-toc: not a file: $file" >&2
 	exit 2
 fi