auto-repo-setup

1# Auto Repo Setup
2 
3Make the repository usable without changing the user's normal way of working.
4Treat setup as an evidence-driven repository task, not as a special interface for
5people with a particular job title.
6 
7## Entry router
8 
9Classify the request before changing anything. Do not combine modes merely because
10they all contain the word "setup".
11 
12| User outcome | Mode | First action |
13|---|---|---|
14| "It won't run", missing dependency, new machine | Environment repair | Read project instructions and detect the actual stack |
15| "Sync before we work", "pull the latest", or a status question during repository maintenance | Session routine | Determine sync authority from the ongoing task and project instructions, then use Workflow B |
16| Repeated or unexpected hook output | Hook diagnosis | Count registrations and firing sessions before editing configuration |
17| A teammate needs a repeatable handoff | Repository handoff | Audit existing onboarding and fill only the missing operational contract |
18| Commit, push, conflict, leaked secret/history | Git safety | Read [references/git_safety.md](references/git_safety.md) before mutation |
19| Behavior must happen before the first prompt | Startup automation | Read [references/startup_automation.md](references/startup_automation.md) and pass its hook gate |
20 
21## Operating principles
22 
231. **Do not infer competence from role.** Match the user's demonstrated altitude.
24…