repo-native-alignment: Skill for Claude Code

/teach-oh

Setup that gathers project context and saves it to AGENTS.md (the cross-agent standard). Run when starting on a project or when strategy/aims have shifted.

When to Use

Invoke /teach-oh when:

• Starting on a new project - Before diving into work
• Context keeps getting lost - AI assistants don't "get" your project
• Onboarding a new AI tool - Establish shared understanding upfront
• After major strategic shifts - When aims or constraints have changed

Do not use when: You're mid-task. This is setup, not execution.

The Process

Step 0: Check for RNA MCP (Repo-Native Alignment)

Before exploring, check if RNA is available — it makes everything that follows richer.

Detection (in order):

1. Check if RNA's search, repo_map, list_roots, or outcome_progress tools are available in the current session
2. Check if repo-native-alignment is on PATH: which repo-native-alignment
3. Check if .mcp.json references repo-native-alignment or rna-server

If RNA is available: Proceed to Step 1. Use repo_map for orientation and search for symbols, artifacts, neighbors, and impact instead of Grep/Read.

If RNA is NOT available: Offer to install it:

"I can set up Repo-Native Alignment (RNA) — it gives me semantic code search, graph traversal, and business context awareness across your codebase. Takes ~1 minute. Want me to install it?"

If accepted:

1. Detect platform and chip:

   OS=$(uname -s)
   ARCH=$(uname -m)
   CHIP=$(sysctl -n machdep.cpu.brand_string 2>/dev/null || echo "")
   

   • macOS ARM M4+: Darwin + arm64 + brand_string contains "M4" → use darwin-arm64-m4
   • macOS ARM (other): Darwin + arm64 → use darwin-arm64
   • Linux x86_64: Linux + x86_64 → use linux-x86_64

2. Invoke the repo-local /rna-mcp:setup skill. It owns installation, selects a successful CI release artifact for an immutable commit, verifies the artifact, and configures the client. Never download a mutable latest artifact or use a locally compiled binary as a shipped build.