chore: add Session Bootstrap section to AGENTS.md template and self-AGENTS.md

Every project scaffolded or upgraded via specsmith will now include a
Session Bootstrap section instructing agents to run four steps before
any work:
  1. pip install --pre --upgrade specsmith  (keep current)
  2. specsmith migrate-project             (apply scaffold migrations)
  3. specsmith audit                       (verify governance health)
  4. specsmith sync                        (confirm YAML / JSON in sync)

specsmith's own AGENTS.md gets a tailored variant (runs from editable
source, no pip install step; uses py -m specsmith).

The template change propagates to all governed projects via:
  specsmith upgrade --full

Co-Authored-By: Oz <oz-agent@warp.dev>

Author: tbitcs

AGENTS.md

@@ -2,6 +2,27 @@
 
 This project is governed by **specsmith**.
 
+## Session Bootstrap
+
+Run these steps at the start of **every** session before touching any code:
+
+```bash
+# specsmith runs from editable source — no pip install needed here.
+# For all other projects, use: pip install --pre --upgrade specsmith
+
+# 1. Verify governance health
+py -m specsmith audit
+
+# 2. Confirm machine state matches governance YAML
+py -m specsmith sync
+
+# 3. Check for pending migrations
+py -m specsmith migrate list
+```
+
+Only proceed with the requested task once all three steps complete without errors.
+If `audit` reports failures, surface them to the user before starting work.
+
 ## For AI Agents
 
 All governance rules, session state, requirements, and epistemic constraints

src/specsmith/templates/agents.md.j2

@@ -2,6 +2,27 @@
 
 This project is governed by **specsmith**.
 
+## Session Bootstrap
+
+Run these four steps at the start of **every** session before touching any code:
+
+```bash
+# 1. Update specsmith to latest dev
+pip install --pre --upgrade specsmith
+
+# 2. Migrate project scaffold if behind installed version
+specsmith migrate-project --project-dir .
+
+# 3. Verify governance health
+specsmith audit --project-dir .
+
+# 4. Confirm machine state matches governance YAML
+specsmith sync --project-dir .
+```
+
+Only proceed with the requested task once all four steps complete without errors.
+If `audit` reports failures, surface them to the user before starting work.
+
 ## For AI Agents
 
 All governance rules, session state, requirements, and epistemic constraints