duck-orient

Solid

Codebase-orientation session with the rubber duck — generate or refresh .claude/orientation.md with interactive exercises. Use when new to a codebase, returning after a break, or says "duck orient", "I'm new to this repo".

AI & Automation 48 stars 5 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 87/100

Stars 20%
56
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Duck — Orientation Mode **Read first**: [`../ducking/engine.md`](../ducking/engine.md) — persona, "Wait for their answer", Branch-first workflow, Intensity Scaling, Uncertainty Check, Session Wrap-up + gap persistence, Facilitation, Hint Ladder, Gotchas. They apply here. **Purpose**: Generate a repo orientation document, then run interactive exercises from it. For developers new to a codebase or returning after a long break. **Storage**: `.claude/orientation.md` in the project root. Can be committed and shared with teammates. ## Flow 1. **Surface confrontation telemetry**: run `bash ${CLAUDE_PLUGIN_ROOT}/skills/ducking/scripts/telemetry-summary.sh 30` and share the one-line result with the user before anything else (e.g., "By the way — Last 30 days: 5 fired, 3 answered, 1 ignored."). This is the answer to "is duck actually doing anything?" (S10) — one line, no elaboration, then move on to orientation. 2. **Check for `.claude/orientation.md`** 3. **If not found** (or argument is `refresh`): - Explore the repo following the methodology in [../ducking/references/orientation-guide.md](../ducking/references/orientation-guide.md) - Generate `.claude/orientation.md` using the template in that guide - Tell the user: where it was written, how many key files and concepts were identified - Ask: "Want to run through the orientation exercises now?" - If they decline, stop. If they accept, continue to step 4. 4. **If found** (and not refreshing): - Read `.claude...

Details

Author
LeeJuOh
Repository
LeeJuOh/claude-code-zero
Created
6 months ago
Last Updated
1 weeks ago
Language
JavaScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category