create-team-foundry 1.0.0 → 2.1.0

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import fs3 from "fs/promises";
-import path3 from "path";
+import fs4 from "fs/promises";
+import path4 from "path";
 import { outro as outro2, log, confirm } from "@clack/prompts";
 
 // src/prompts.ts
@@ -20,7 +20,8 @@ async function runPrompts() {
     options: [
       { value: "claude", label: "Claude Code" },
       { value: "gemini", label: "Gemini CLI" },
-      { value: "both", label: "Both" }
+      { value: "cursor", label: "Cursor" },
+      { value: "both", label: "Multiple (Claude Code + Gemini CLI)" }
     ]
   });
   cancelIfNeeded(tool);
@@ -28,7 +29,7 @@ async function runPrompts() {
     message: "Team size?",
     options: [
       { value: "solo", label: "1\u20133 people  (solo profile \u2014 7 files)" },
-      { value: "full", label: "4\u201315 people  (full profile \u2014 19 files)" }
+      { value: "full", label: "4\u201315 people  (full profile \u2014 20 files)" }
     ]
   });
   cancelIfNeeded(profile);
@@ -41,18 +42,34 @@ async function runPrompts() {
     ]
   });
   cancelIfNeeded(repoVisibility);
+  let federated;
+  if (profile === "full") {
+    const federatedAnswer = await select({
+      message: "Context layout?",
+      options: [
+        { value: "flat", label: "Flat  (one root CLAUDE.md \u2014 simpler, recommended for most teams)" },
+        { value: "federated", label: "Federated  (CLAUDE.md per folder \u2014 for larger teams, 8+ people)" }
+      ]
+    });
+    cancelIfNeeded(federatedAnswer);
+    federated = federatedAnswer === "federated";
+  }
   const ingestion = await select({
     message: "Do you have existing docs to ingest?\n  (Strategy docs, old roadmaps, customer research \u2014 the interview uses them to pre-populate answers)",
     options: [
-      { value: "local", label: "Local folder  (exported docs on disk)" },
-      { value: "mcp", label: "MCP source  (Notion, Confluence, Google Drive)" },
-      { value: "paste", label: "Paste content  (we'll create a file for you to fill in)" },
+      { value: "repo", label: "Repo signals only  (README, package.json, git history, GitHub PRs/issues)" },
+      { value: "repo+local", label: "Repo + local docs folder  (repo signals + point me at a folder)" },
+      { value: "repo+mcp", label: "Repo + MCP source  (repo signals + Notion, Confluence, Google Drive)" },
+      { value: "repo+paste", label: "Repo + paste content  (repo signals + paste docs into paste-content.md)" },
+      { value: "local", label: "Local docs folder only  (no repo scan)" },
+      { value: "mcp", label: "MCP source only  (no repo scan)" },
+      { value: "paste", label: "Paste content only  (no repo scan)" },
       { value: "skip", label: "Skip  (start fresh)" }
     ]
   });
   cancelIfNeeded(ingestion);
   let ingestionPath;
-  if (ingestion === "local") {
+  if (ingestion === "local" || ingestion === "repo+local") {
     const rawPath = await text({
       message: "Path to the folder containing your docs?",
       placeholder: "./docs  or  /Users/you/exports",
@@ -68,7 +85,8 @@ async function runPrompts() {
     profile,
     repoVisibility,
     ingestion,
-    ingestionPath
+    ingestionPath,
+    federated
   };
 }
 
@@ -76,14 +94,148 @@ async function runPrompts() {
 import fs from "fs/promises";
 import path from "path";
 
+// src/templates/federated/product-claude.ts
+function federatedProductTemplate(ctx) {
+  return `---
+purpose: Routing context for the product/ folder \u2014 read before answering product questions
+read_when: Any question about outcomes, customers, roadmap, strategy, assumptions, or risks
+last_updated: ${ctx.date}
+---
+
+# Product context
+
+This folder contains the team's product thinking. Read the relevant file before answering.
+
+| Topic | File |
+|---|---|
+| Vision and north star metric | \`north-star.md\` |
+| This quarter's outcomes | \`outcomes.md\` |
+| Named customers and personas | \`customers.md\` |
+| What we're building now / next / later | \`now-next-later.md\` |
+| Strategic logic and guiding policy | \`strategy.md\` |
+| Open assumptions and untested bets | \`assumptions.md\` |
+| Key product risks | \`risks.md\` |
+
+Files with recent \`last_updated\` dates are more reliable than older ones. If asked about freshness, note if a file hasn't been updated in 60+ days.
+`;
+}
+
+// src/templates/federated/team-claude.ts
+function federatedTeamTemplate(ctx) {
+  return `---
+purpose: Routing context for the team/ folder \u2014 read before answering team questions
+read_when: Any question about who owns decisions, how the team works, or AI tool usage
+last_updated: ${ctx.date}
+---
+
+# Team context
+
+This folder describes how the product trio works and how the team operates.
+
+| Topic | File |
+|---|---|
+| Who's on the trio and how decisions are made | \`trio.md\` |
+| Ceremonies, DoD, working norms | \`working-agreement.md\` |
+| How this team uses AI tools | \`ai-practices.md\` |
+
+When answering questions about ownership or process, read \`trio.md\` first. It reflects how the team actually operates, not an org chart.
+`;
+}
+
+// src/templates/federated/engineering-claude.ts
+function federatedEngineeringTemplate(ctx) {
+  return `---
+purpose: Routing context for the engineering/ folder \u2014 read before answering technical questions
+read_when: Any question about the stack, conventions, tech debt, or past architecture decisions
+last_updated: ${ctx.date}
+---
+
+# Engineering context
+
+This folder contains the team's technical context. Read before writing or reviewing code.
+
+| Topic | File |
+|---|---|
+| Stack, conventions, deployment | \`stack.md\` |
+| Quality stance and tech debt policy | \`quality-bar.md\` |
+| Past architecture decisions | \`decisions/\` |
+
+Always read \`stack.md\` before writing code for this repo \u2014 it contains the conventions and the non-obvious choices that would surprise an outsider. Read the relevant ADR in \`decisions/\` before making a technical decision that's already been decided.
+`;
+}
+
+// src/templates/federated/design-claude.ts
+function federatedDesignTemplate(ctx) {
+  return `---
+purpose: Routing context for the design/ folder \u2014 read before answering design questions
+read_when: Any question about UI copy, visual decisions, accessibility, or tone of voice
+last_updated: ${ctx.date}
+---
+
+# Design context
+
+This folder contains the team's design principles and standards.
+
+| Topic | File |
+|---|---|
+| Design principles, tone of voice, accessibility | \`principles.md\` |
+
+Read \`principles.md\` before writing UI copy, reviewing designs, or making visual decisions. The tone and accessibility standards here apply to all customer-facing work.
+`;
+}
+
+// src/templates/federated/data-claude.ts
+function federatedDataTemplate(ctx) {
+  return `---
+purpose: Routing context for the data/ folder \u2014 read before discussing metrics
+read_when: Any question about metrics, success criteria, or what numbers mean
+last_updated: ${ctx.date}
+---
+
+# Data context
+
+This folder contains metric definitions for this team.
+
+| Topic | File |
+|---|---|
+| Metric definitions, ownership, data sources | \`metrics.md\` |
+
+Read \`metrics.md\` before citing any metric or writing success criteria in a spec. If a metric isn't defined here, it doesn't have an agreed definition \u2014 flag that rather than inventing one.
+`;
+}
+
+// src/templates/federated/context-claude.ts
+function federatedContextTemplate(ctx) {
+  return `---
+purpose: Routing context for the context/ folder \u2014 read before using domain terminology
+read_when: Any question involving domain terms, acronyms, or stakeholder communication
+last_updated: ${ctx.date}
+---
+
+# Domain context
+
+This folder contains the team's shared vocabulary and stakeholder map.
+
+| Topic | File |
+|---|---|
+| Domain terms and acronyms | \`glossary.md\` |
+| Stakeholders and what they care about | \`stakeholders.md\` |
+
+Read \`glossary.md\` when writing specs, copy, or anything using domain-specific terms \u2014 especially terms flagged as "used inconsistently." Read \`stakeholders.md\` before drafting any communication intended for a specific stakeholder.
+`;
+}
+
 // src/templates/root-claude.ts
 function rootClaudeTemplate(ctx) {
   return `---
 purpose: Identity, routing map, and coach activation \u2014 read at the start of every session
 read_when: Every Claude Code session in this repo \u2014 this is the root instruction file
 last_updated: ${ctx.date}
+owner:
 ---
 
+<!-- See AGENTS.md for cross-tool context routing (OpenAI Codex and other agents). -->
+
 # CLAUDE.md
 
 This repo uses **team-foundry** \u2014 structured files that give you real team context.
@@ -157,8 +309,11 @@ function rootGeminiTemplate(ctx) {
 purpose: Identity, routing map, and coach activation \u2014 read at the start of every session
 read_when: Every Gemini CLI session in this repo \u2014 this is the root instruction file
 last_updated: ${ctx.date}
+owner:
 ---
 
+<!-- See AGENTS.md for cross-tool context routing (OpenAI Codex and other agents). -->
+
 # GEMINI.md
 
 This repo uses **team-foundry** \u2014 structured files that give you real team context.
@@ -226,6 +381,85 @@ it notices something relevant to your current work. You can also invoke it direc
 `;
 }
 
+// src/templates/root-cursor.ts
+function rootCursorTemplate(ctx) {
+  return `---
+purpose: Identity, routing map, and coach activation \u2014 read at the start of every session
+read_when: Every Cursor session in this repo \u2014 this is the root instruction file
+last_updated: ${ctx.date}
+owner:
+alwaysApply: true
+---
+
+<!-- See AGENTS.md for cross-tool context routing (OpenAI Codex and other agents). -->
+
+# team-foundry
+
+This repo uses **team-foundry** \u2014 structured files that give you real team context.
+Read this file first. It tells you where to find everything and how to activate the coach.
+
+<!-- GAP: The onboarding interview hasn't run yet.
+     When the user says "Let's set up our team-foundry" or similar, do this:
+     1. Read GETTING_STARTED.md for context on what to expect
+     2. Load .team-foundry/coach.md \u2014 it contains the interview sequence
+     3. Begin the onboarding interview as described there
+     Do not improvise the interview. Follow the sequence in coach.md. -->
+
+## Who we are
+
+<!-- Filled in during the onboarding interview. -->
+
+## Routing map
+
+When the user's question relates to any of the following, read the corresponding file
+before answering. Files with recent \`last_updated\` dates are more reliable than older ones.
+
+| Topic | File |
+|---|---|
+| Who we are / what this product does | team-foundry.mdc \u2014 "Who we are" section (this file) |
+| What success looks like / vision | \`team-foundry/product/north-star.md\` |
+| What we're working toward this quarter | \`team-foundry/product/outcomes.md\` |
+| Who our customers are | \`team-foundry/product/customers.md\` |
+| What we're building now / next / later | \`team-foundry/product/now-next-later.md\` |
+| Strategic logic and guiding policy | \`team-foundry/product/strategy.md\` |
+| Open assumptions and untested bets | \`team-foundry/product/assumptions.md\` |
+| Key product risks | \`team-foundry/product/risks.md\` |
+| How the product trio works | \`team-foundry/team/trio.md\` |
+| Team norms, DoD, ceremonies | \`team-foundry/team/working-agreement.md\` |
+| How we use AI tools | \`team-foundry/team/ai-practices.md\` |
+| Tech stack and conventions | \`team-foundry/engineering/stack.md\` |
+| Quality stance and tech debt policy | \`team-foundry/engineering/quality-bar.md\` |
+| Past architecture decisions | \`team-foundry/engineering/decisions/\` |
+| Design principles and tone | \`team-foundry/design/principles.md\` |
+| Metric definitions | \`team-foundry/data/metrics.md\` |
+| Domain terms and acronyms | \`team-foundry/context/glossary.md\` |
+| Stakeholders and what they care about | \`team-foundry/context/stakeholders.md\` |
+
+## Coach
+
+The team-foundry coach keeps these files honest over time. It runs automatically when
+it notices something relevant to your current work. You can also invoke it directly:
+
+| What to say | What happens |
+|---|---|
+| "Let's set up our team-foundry" | Runs the onboarding interview (first time only) |
+| "let's do a team-foundry review" | Full audit \u2014 all files checked, findings listed |
+| "coach mode" | Same as above |
+| "review our [outcomes / customers / stack / etc.]" | Targeted review of one file |
+| "what's missing from team-foundry?" | Lists gaps across all files |
+| "run the weekly team-foundry review" | Weekly check-in, top 3 issues surfaced |
+
+<!-- AI instructions:
+     - Normal coding sessions: do NOT load coach.md. Use the routing map above to load
+       specific files only when directly relevant to the user's question.
+     - Explicit mode / Scheduled mode / onboarding: load .team-foundry/coach.md in full
+       before activating any mode. Triggered only by the phrases in the table above.
+     - Inline mode nudges: if you notice a clear gap in a team-foundry file while answering
+       a normal question, surface it in one sentence \u2014 without loading the full coach.md.
+       Keep it brief and non-blocking. Do not coach unprompted on back-to-back messages. -->
+`;
+}
+
 // src/templates/getting-started.ts
 function gettingStartedTemplate(ctx) {
   const toolName = ctx.tool === "gemini" ? "Gemini CLI" : ctx.tool === "both" ? "Claude Code or Gemini CLI" : "Claude Code";
@@ -315,8 +549,14 @@ You can delete this file once the onboarding interview is complete.
 // src/templates/coach.ts
 function coachTemplate(ctx) {
   const isSolo = ctx.profile === "solo";
-  const questionCount = isSolo ? "10" : "18\u201325";
+  const questionCount = isSolo ? "9" : "18\u201325";
   const timeEstimate = isSolo ? "15\u201320 minutes" : "25\u201335 minutes";
+  const featureQueryFullSteps = isSolo ? "" : `3. Read \`team-foundry/product/now-next-later.md\` \u2014 find the feature's current status (Now / Next / Later / shipped)
+4. Read \`team-foundry/product/assumptions.md\` \u2014 find any assumptions linked to this feature
+5. Read \`team-foundry/engineering/decisions/\` \u2014 find any ADRs related to how it's being built
+`;
+  const featureQuerySynthesis = isSolo ? "why it's being built (outcome + customer evidence)." : "why it's being built (outcome + customer evidence), current status, open bets (assumptions), and any relevant technical decisions.";
+  const featureQueryIndexNote = isSolo ? "Your solo profile covers outcomes, customers, north-star, and stack \u2014 feature queries draw from those." : "For full profile teams, this covers status, rationale, customer evidence, open bets, and decisions.";
   return `---
 purpose: Full coach playbook \u2014 loaded on demand to preserve token budget
 read_when: When the user triggers coach mode (explicit, inline, scheduled review, or onboarding interview)
@@ -336,6 +576,67 @@ You are a mirror, not a template pack. The files in this repo are the team's own
 thinking. Your role is to reflect it back to them accurately, including the parts
 that have gone stale or were never written down.
 
+## Reality observation
+
+This is the authoritative protocol for reading git activity. It supersedes any git-reading
+instructions elsewhere in this file (including the "Why this nudge?" block and Behavior 5).
+Those sections define what to surface \u2014 this section defines how to gather the evidence.
+
+**When to run:**
+- **Explicit and scheduled modes:** Run all four steps before any behavior fires.
+- **Inline mode:** Run Steps 1\u20132 only when an inline trigger fires, scoped to the specific
+  file being evaluated. Do not run a full git audit on every inline response \u2014 that
+  contradicts the token-budget framing of this file.
+
+**Step 1 \u2014 Read recent commits.**
+
+\`\`\`
+git log --oneline --since="30 days ago"
+\`\`\`
+
+This returns all commits regardless of merge strategy. Extract:
+- Total commit count in the window
+- Commit messages that describe shipped features, decisions, or major changes
+
+**Merge strategy note:** \`git log --merges\` returns zero results on repos that use
+squash-merge or rebase-merge (GitHub's common defaults). Do not use it as the primary
+activity signal. Instead, use total commit count from the regular log. If commit volume
+is high (>10 commits) but \`--merges\` returns zero, conclude "squash or rebase merge
+strategy \u2014 using commit messages as activity proxy" and proceed accordingly.
+
+**Step 2 \u2014 Check \`last_updated\` dates in team-foundry files.**
+
+For each file being evaluated, note its \`last_updated\` frontmatter date. Calculate:
+- Days between \`last_updated\` and today
+- Commits since that date: \`git log --oneline --since="<last_updated date>"\`
+- If the log returns no results, treat activity as zero and skip the high-activity threshold.
+
+**Step 3 \u2014 Build the observed reality summary (internal, not shown to user).**
+
+Synthesize into a mental model carried through the rest of the session:
+- What shipped recently (from commit messages)
+- Which team-foundry files haven't been updated since shipping started
+- Activity level: high (>3 commits since last update) or low (\u22643 commits since last update).
+  High activity means push harder on drift. Low activity means lighter touch.
+
+**Step 4 \u2014 Use this in every finding.**
+
+When surfacing drift, always cite the observed reality explicitly. This is the single format
+for "Why this nudge?" across all behaviors:
+
+> "[N] commits have merged since outcomes.md was last updated ([X] days ago). Based on
+> recent commit messages \u2014 [list 2-3 relevant ones] \u2014 it looks like [what changed].
+> outcomes.md doesn't reflect this yet."
+
+**Fallback when git is unavailable:** If the tool doesn't have shell access, fall back to
+\`last_updated\` dates only and note: "I don't have access to git history \u2014 using
+\`last_updated\` dates as the staleness signal."
+
+**What counts as high activity:** More than 3 commits since the file was last updated.
+This is the single threshold used throughout this file.
+
+---
+
 ## Activation modes
 
 You have three activation modes. Read which one applies and behave accordingly.
@@ -524,6 +825,31 @@ order and **name the conflict explicitly** rather than silently picking one:
 Say: "I see a conflict between [file A] and [file B]. Based on the context priority
 order, I'm going with [file A] \u2014 but you may want to reconcile these."
 
+When running any coaching behavior, also load \`.team-foundry/team-lessons.md\` if it exists.
+Apply Active rules from that file alongside built-in behaviors \u2014 they carry equal weight.
+
+## Feature queries
+
+**Applies in explicit and scheduled modes.** In inline mode, treat feature questions as
+potential B5 (reality drift) triggers rather than running this full multi-file read.
+
+When the user asks about a specific feature \u2014 "tell me about X," "what's the status of Y,"
+"what do we know about Z," "has X shipped?," "where are we on X?," "who owns X?," or any
+close variant \u2014 read the following files in order:
+
+1. Read \`team-foundry/product/outcomes.md\` \u2014 find which outcome this feature supports (the why)
+2. Read \`team-foundry/product/customers.md\` \u2014 find customer quotes or personas that motivated it
+${featureQueryFullSteps}
+For each file above: if the file doesn't exist on disk, skip it silently. If it exists
+but doesn't mention the feature, note that gap explicitly \u2014 don't invent connections.
+
+Synthesize into a single response: ${featureQuerySynthesis}
+
+If the feature doesn't appear in any file, say: "I couldn't find [X] in any team-foundry
+file \u2014 it may be undocumented or tracked under a different name. Want me to help capture it?"
+
+The team-foundry files are the index. ${featureQueryIndexNote}
+
 ---
 
 ## Behaviors
@@ -537,6 +863,11 @@ For every finding: name it specifically (cite the file and the exact content),
 explain why it matters in one sentence, offer to draft the fix. Never list a finding
 without a proposed next step.
 
+**"Why this nudge?" \u2014 required for every drift finding.** Use the evidence gathered in the
+Reality observation section above. Always be specific \u2014 a team that understands why a nudge
+fired is far more likely to act on it. Never say "this looks stale" without citing the
+commit count, day delta, and (if blank) missing owner.
+
 ---
 
 ### Behavior 1: Outputs framed as outcomes
@@ -1094,6 +1425,61 @@ as a deliberate strategy update. If item should be removed: flag only \u2014 do
 the current strategy.md guiding policy explicitly excludes \u2014 or when strategy.md has no
 Guiding Policy filled in.
 
+### Behavior 17: Team-specific lesson capture
+
+**Severity:** Informational \u2014 surfaced as an offer, never a blocker.
+
+**Trigger condition:** The user's message contains a recurring-pattern signal:
+- "we keep doing X"
+- "this is the third time we've had this problem"
+- "we always confuse Y with Z"
+- "every time we [situation], we [result]"
+- Any close variant signaling a pattern the team has noticed about itself.
+
+**What to say:**
+> "Sounds like a recurring pattern. Want me to add a coaching rule to \`.team-foundry/team-lessons.md\`
+> so I watch for this on future reviews?"
+
+**If the user confirms:**
+1. Draft the rule in this format:
+   \`- [date] [concise rule] \u2014 [brief context]\`
+2. Ask: "Does this capture it, or want to edit the wording?"
+3. After confirmation, write it to the Active rules section of \`.team-foundry/team-lessons.md\`.
+   If the file doesn't exist, create it with this structure:
+
+\`\`\`markdown
+---
+purpose: Team-specific coaching rules learned from this team's patterns
+read_when: Coach runs any coaching behavior
+last_updated: [date]
+---
+
+# Team lessons
+
+Rules this specific team has accumulated for their coach.
+Added when the team flags a recurring issue they want the coach to watch for.
+
+## Active rules
+
+- [date] [rule] \u2014 [context]
+
+## Retired rules
+
+<!-- Move rules here when no longer relevant, with the date retired. -->
+\`\`\`
+
+**Rule retirement:** When a team says a rule is no longer relevant ("we fixed that," "we changed process"),
+offer to retire it: move it from Active rules to Retired rules with today's date prepended.
+
+**Loading instruction:** When running any coaching behavior (inline, explicit, or scheduled),
+check if \`.team-foundry/team-lessons.md\` exists. If it does, load it and apply Active rules
+with equal weight to built-in behaviors, scoped to this team's context.
+
+**What not to do:** Do not proactively suggest adding rules unless the user explicitly names a pattern.
+This behavior is listener-only \u2014 it waits for the signal, it does not fish for it.
+
+---
+
 ## Quarterly retrospective
 
 ### Trigger
@@ -1223,13 +1609,120 @@ Adjustments are soft \u2014 they change when you surface a behavior, not whether
 its protocol. They reset after 30 days or when the team addresses the gap.
 
 ---
+${ctx.ingestion?.startsWith("repo") ? `
+## Repo auto-ingestion
+
+**When this runs:** At the start of every onboarding interview when ingestion mode is
+\`repo\`, \`repo+local\`, \`repo+mcp\`, or \`repo+paste\`. Execute Steps 1\u20135 silently
+before saying anything to the user.
+
+### Source priority
+
+Read sources in this order. Highest-priority source wins per field \u2014 lower sources
+only fill gaps the higher ones leave empty.
+
+| Priority | Source | What it supplies |
+|---|---|---|
+| 1 | Existing \`team-foundry/\` files | Everything \u2014 highest priority, re-run aware |
+| 2 | \`package.json\` / \`pyproject.toml\` / \`Cargo.toml\` | Product name, stack, language, deps |
+| 3 | \`README.md\` | Product description, what it does, who it's for |
+| 4 | Git log (last 30 commits) | Contributors, cadence, recent focus |
+| 5 | ADRs in \`docs/\`, \`decisions/\`, or \`engineering/decisions/\` | Architecture decisions |
+| 6 | GitHub PRs and issues via \`gh\` CLI (optional) | Current work, open problems |
+| 7 | Top-level folder structure | Repo layout, monorepo signals |
+
+### Step 1 \u2014 Silent read
+
+Read all available sources silently. Do not stream output during the read.
+
+**GitHub signals (priority 6):** Run \`gh issue list\` and \`gh pr list\` to read open
+issues and recent PRs. If \`gh\` is not installed, not authenticated, or does not respond
+within 10 seconds, fall back to local repo signals only and note
+"GitHub signals unavailable \u2014 using local repo only" in the summary. Never block on
+GitHub \u2014 the flow continues regardless.
+
+**Re-run detection:** Check whether \`team-foundry/\` files already exist and have
+content beyond gap markers. If yes, treat them as highest-priority source and skip to
+the re-run flow in Step 2b.
+
+### Step 2 \u2014 Pre-fill summary
+
+Present a single structured summary. Do not ask questions yet.
+
+> Here's what I found in your repo. Tell me what's wrong and I'll fix it before writing
+> anything.
+>
+> **Product:** [name \u2014 from package.json]
+> **What it does:** [1\u20132 sentences \u2014 from README, first paragraph]
+> **Stack:** [language/framework \u2014 from package.json + README]
+> **Team:** [contributor count from git log \u2014 challenge me]${ctx.profile === "full" ? `
+> **Recent focus:** [inferred from last 30 commit messages \u2014 challenge me]
+> **Open assumptions I spotted:** [from open issues / PRs if available]
+> **Decisions already made:** [from ADRs if found]` : `
+> **Recent focus:** [inferred from last 30 commit messages \u2014 challenge me]`}
+>
+> What's missing or wrong? (say "looks good" to proceed, or correct anything above)
+
+Per-field source attribution rules:
+- Fields read verbatim from a file: show \`(from manifest file)\`, \`(from README)\` etc. Use the actual filename (e.g. \`package.json\`, \`pyproject.toml\`, \`Cargo.toml\`) when it is unambiguous.
+- Fields inferred (e.g. team size estimated from contributor count): append \`\u2014 challenge me\`
+- Fields where no signal was found: omit the field from the summary
+
+### Step 2b \u2014 Re-run flow (only when existing team-foundry/ files found)
+
+If existing \`team-foundry/\` files are populated beyond gap markers, say instead:
+
+> You've already run the onboarding interview. Here's what's currently populated.
+> What's changed since then?
+
+Show current values from the files. Only update fields the user says have changed.
+Leave confirmed fields untouched.
+
+### Step 3 \u2014 One-message correction
+
+Wait for the user's response. Apply any corrections they give. Do not re-ask confirmed
+fields. If the user says "looks good," proceed immediately to Step 4.
+
+### Step 4 \u2014 Write files
 
+Write all team-foundry files using confirmed data. For any field with no signal and
+no user-provided answer, write a \`<!-- GAP: ... -->\` marker. Follow the
+conversation-as-update protocol \u2014 show each file draft and wait for confirmation
+before writing.
+
+**No silent writes.** Even high-confidence pre-filled answers require explicit
+confirmation before being written to disk. "Looks good" or "yes" is confirmation.
+Silence is not.
+
+### Step 5 \u2014 Gap nudge
+
+After writing, surface the top 3 gaps:
+
+> Here's what still needs filling in \u2014 these are the most important:
+> 1. [Gap 1 \u2014 file and field]
+> 2. [Gap 2 \u2014 file and field]
+> 3. [Gap 3 \u2014 file and field]
+>
+> Want to fill any of these in now?
+
+### No-signal fallback
+
+If the repo has no \`README.md\`, no \`package.json\`, and fewer than 5 git commits,
+say:
+
+> I couldn't find enough signals in this repo to pre-fill anything.
+> I'll ask you directly \u2014 this takes about ${timeEstimate}.
+
+Then proceed with the standard interview sequence below, skipping Steps 1\u20135.
+
+---
+` : ""}
 ## Onboarding interview
 
 **Triggered by:** The user says "Let's set up our team-foundry," "run the onboarding
 interview," or any close variant. Also triggered on first load if GETTING_STARTED.md
 still exists and the "Who we are" section in the root file is empty.
-${ctx.ingestion === "mcp" ? `
+${ctx.ingestion === "mcp" || ctx.ingestion === "repo+mcp" ? `
 **Existing docs \u2014 MCP source:** The user indicated they have docs in a connected MCP
 source (Notion, Confluence, or Google Drive). Before asking any questions, query their
 connected MCP servers, then follow the shared ingestion reference below.
@@ -1272,7 +1765,7 @@ Apply medium confidence to all content from undated or old docs.
 Then apply Steps 2\u20134 from the **Shared ingestion reference** section below.
 ` : ctx.ingestionPath ? `
 **Existing docs \u2014 local folder:** The user indicated they have docs to ingest at
-\`${ctx.ingestionPath}\`. Before asking any questions, read all files in that folder,
+\`${ctx.ingestionPath}\`.${ctx.ingestion === "repo+local" ? ` Repo signals have already been processed in the Repo auto-ingestion section above. Now also read this local folder as a supplementary source \u2014 use it to fill gaps the repo signals could not supply.` : ` Before asking any questions, read all files in that folder,`}
 then follow the shared ingestion reference below.
 
 **Step 1 \u2014 Stale doc check.** Before reading content, check each file for dates.
@@ -1282,7 +1775,7 @@ If a file has no date fields, or all dates are older than 6 months, flag it:
 Apply medium confidence to all content from undated or old files.
 
 Then apply Steps 2\u20134 from the **Shared ingestion reference** section below.
-` : ctx.ingestion === "paste" ? `
+` : ctx.ingestion === "paste" || ctx.ingestion === "repo+paste" ? `
 **Existing docs \u2014 paste content:** The user indicated they have docs to share by
 pasting. Before starting the interview, say:
 
@@ -1311,7 +1804,7 @@ Wait for the user to confirm before proceeding.
 
 Then apply Steps 2\u20134 from the **Shared ingestion reference** section below.
 ` : ""}
-${ctx.ingestionPath || ctx.ingestion === "mcp" || ctx.ingestion === "paste" ? `
+${ctx.ingestionPath || ctx.ingestion === "repo+local" || ctx.ingestion === "mcp" || ctx.ingestion === "paste" || ctx.ingestion === "repo+mcp" || ctx.ingestion === "repo+paste" ? `
 ### Shared ingestion reference
 
 **Step 2 \u2014 Map content to files.** Route what you find to the right team-foundry file:
@@ -1491,11 +1984,11 @@ Example answers:
 
 ---
 
-### Theme 3: Measurement
+${isSolo ? "" : `### Theme 3: Measurement
 
 *Files written: data/metrics.md*
 
-**Q${isSolo ? "5" : "7"}. What are the 3\u20135 numbers you actually look at to know if the product is healthy?**
+**Q7. What are the 3\u20135 numbers you actually look at to know if the product is healthy?**
 *Why it matters: data/metrics.md is read whenever the AI is asked about product performance.
 Undefined metrics cause disagreements \u2014 two people reading the same number and reaching different conclusions.*
 
@@ -1506,7 +1999,7 @@ Example answers:
 - "Listing-to-sale rate \u2014 % of active listings that get bought within 30 days, from our DB."
 - "P1 bug count \u2014 open bugs tagged P1 in Linear, reviewed Monday mornings."
 
-*After the answer: write each metric as a definition block to data/metrics.md.*
+*After the answer: write each metric as a definition block to data/metrics.md.*`}
 
 ---
 
@@ -1514,7 +2007,7 @@ Example answers:
 
 *Files written: product/customers.md*
 
-**Q${isSolo ? "6" : "8"}. Name three customers you've spoken to directly.**
+**Q${isSolo ? "5" : "8"}. Name three customers you've spoken to directly.**
 *Why it matters: customers.md is read whenever the AI helps with prioritization, specs,
 or discovery. Generic personas don't resolve real disagreements. Named customers do.*
 
@@ -1576,7 +2069,7 @@ Example answers:
 
 *After the answer: write to engineering/quality-bar.md (tech debt stance).*`}
 
-**Q${isSolo ? "7" : "12"}. What does "shipped" mean on your team?**
+**Q${isSolo ? "6" : "12"}. What does "shipped" mean on your team?**
 *Why it matters: misaligned definitions of done cause the most common sprint friction.
 Writing it down means the argument happens once, not every week.*
 
@@ -1658,7 +2151,7 @@ Example answers:
 
 *Files written: engineering/stack.md*
 
-**Q${isSolo ? "8" : "18"}. What's the tech stack, and what would surprise an incoming engineer?**
+**Q${isSolo ? "7" : "18"}. What's the tech stack, and what would surprise an incoming engineer?**
 *Why it matters: stack.md is read every time the AI helps write or review code.
 The "what would surprise" framing surfaces the non-obvious conventions.*
 
@@ -1691,7 +2184,7 @@ If no: note that the decisions/ folder is ready when one comes up.
 
 *Files written: context/glossary.md${isSolo ? "" : ", context/stakeholders.md"}*
 
-**Q${isSolo ? "9" : "21"}. What words does your team use that would confuse an outsider?**
+**Q${isSolo ? "8" : "21"}. What words does your team use that would confuse an outsider?**
 *Why it matters: glossary.md is read when the AI writes specs, reviews code, or
 discusses product strategy. Shared vocabulary prevents the AI from guessing at meaning.*
 
@@ -1712,7 +2205,7 @@ For each stakeholder: name/role, what they really care about, how they prefer to
 
 *After the answer: write to context/stakeholders.md.*`}
 
-**Q${isSolo ? "10" : "23"}. Are there any terms your team uses inconsistently with each other?**
+**Q${isSolo ? "9" : "23"}. Are there any terms your team uses inconsistently with each other?**
 *Why it matters: inconsistent internal vocabulary is a reliable source of meeting friction.
 Naming it here gives the AI a flag to raise when it notices the inconsistency.*
 
@@ -1752,6 +2245,7 @@ function northStarTemplate(ctx) {
 purpose: The single metric that best captures whether we're creating the value we intend to create
 read_when: Setting quarterly direction, evaluating big bets, writing OKRs, onboarding new team members
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # North Star
@@ -1805,6 +2299,7 @@ function outcomesTemplate(ctx) {
 purpose: Current quarter outcomes \u2014 the changes in customer behavior that define success this quarter
 read_when: Prioritizing work, writing specs, deciding what to build next, evaluating tradeoffs
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Outcomes
@@ -1848,6 +2343,7 @@ function customersTemplate(ctx) {
 purpose: Named customers, personas, jobs to be done, and direct quotes from real conversations
 read_when: Writing specs, prioritizing features, evaluating tradeoffs, any time you're guessing what customers want
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Customers
@@ -1901,6 +2397,7 @@ function nowNextLaterTemplate(ctx) {
 purpose: What we're building now, what we're committed to next, and what's directional
 read_when: Sprint planning, stakeholder updates, evaluating new requests, prioritization discussions
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Now / Next / Later
@@ -1960,6 +2457,7 @@ function assumptionsTemplate(ctx) {
 purpose: Open assumptions and untested beliefs \u2014 the bets the team is currently making
 read_when: Designing discovery work, scoping experiments, retros, any time a decision feels risky
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Assumptions
@@ -2035,6 +2533,7 @@ function risksTemplate(ctx) {
 purpose: The four product risks \u2014 tracked so they don't become surprises at launch
 read_when: Scoping new features, go/no-go decisions, discovery planning, quarterly reviews
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Risks
@@ -2094,6 +2593,7 @@ function trioTemplate(ctx) {
 purpose: The product trio \u2014 who owns what decisions and how the three roles work together
 read_when: Escalations, onboarding, clarifying ownership, any "who decides this?" conversation
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Team Trio
@@ -2115,11 +2615,17 @@ last_updated: ${ctx.date}
 
 ## Members
 
-| Role | Person | Focus area |
-|---|---|---|
-| Product Manager | <!-- name --> | What to build and why |
-| Engineering Lead | <!-- name --> | How to build it, tech debt, architecture |
-| Design Lead | <!-- name --> | UX, flows, visual quality |
+| Role | Person | GitHub (optional) | Focus area |
+|---|---|---|---|
+| Product Manager | <!-- name --> | <!-- @handle --> | What to build and why |
+| Engineering Lead | <!-- name --> | <!-- @handle --> | How to build it, tech debt, architecture |
+| Design Lead | <!-- name --> | <!-- @handle --> | UX, flows, visual quality |
+
+<!-- Optional additional fields per member (add inline or as a sub-list):
+     - slack: U0C3D4E5F  (Slack member ID for @mentions)
+     - linear: user ID  (for issue assignment lookups)
+     Fill in what's known; leave blank what isn't. These fields let AI tools
+     take cross-platform actions when relevant. -->
 
 ## How we make decisions
 
@@ -2151,6 +2657,7 @@ function workingAgreementTemplate(ctx) {
 purpose: Definition of done, definition of ready, ceremonies, and team norms \u2014 the honest version
 read_when: Code review, sprint planning, retrospectives, any "this isn't how we said we'd work" moment
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Working Agreement
@@ -2221,6 +2728,7 @@ function aiPracticesTemplate(ctx) {
 purpose: How this team uses AI tools \u2014 what's working, what we've decided not to do, and our norms
 read_when: Onboarding engineers, evaluating new AI tooling, retrospectives on AI-assisted work
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # AI Practices
@@ -2275,6 +2783,7 @@ function stackTemplate(ctx) {
 purpose: Tech stack, conventions, deployment pipeline, and local dev setup
 read_when: Writing code, reviewing PRs, evaluating new dependencies, onboarding engineers
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Engineering Stack
@@ -2324,6 +2833,7 @@ function qualityBarTemplate(ctx) {
 purpose: The team's honest stance on tech debt, bugs, and what "shipped" actually means
 read_when: Code review, sprint planning, evaluating shortcuts, any quality-vs-speed conversation
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Quality Bar
@@ -2394,6 +2904,7 @@ function decisionsReadmeTemplate(ctx) {
 purpose: Index and template for architecture decision records (ADRs)
 read_when: Evaluating architectural choices, understanding why the codebase looks the way it does
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Architecture Decisions
@@ -2450,6 +2961,7 @@ function principlesTemplate(ctx) {
 purpose: Design principles, tone of voice, and accessibility stance
 read_when: Designing new features, writing copy, reviewing designs, evaluating UX tradeoffs
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Design Principles
@@ -2507,6 +3019,7 @@ function metricsTemplate(ctx) {
 purpose: Metric definitions, ownership, and data sources \u2014 so the team means the same thing
 read_when: Building dashboards, writing OKRs, reviewing product health, debugging data discrepancies
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Metrics
@@ -2553,6 +3066,7 @@ function glossaryTemplate(ctx) {
 purpose: Domain terms, acronyms, and jargon specific to this team and product
 read_when: Onboarding, writing specs, any time a term feels ambiguous or overloaded
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Glossary
@@ -2594,6 +3108,7 @@ function stakeholdersTemplate(ctx) {
 purpose: Who cares about this product, what they care about, and how the team works with them
 read_when: Stakeholder updates, go/no-go decisions, escalations, quarterly planning
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Stakeholders
@@ -2637,6 +3152,7 @@ function strategyTemplate(ctx) {
 purpose: The strategic logic connecting our north-star gap to what we're building. Read before adding anything to the roadmap.
 read_when: Roadmap planning, evaluating new feature requests, quarterly retrospective, when a new item is proposed for Now or Next, when a new team member is onboarding
 last_updated: ${ctx.date}
+owner: 
 ---
 
 # Strategy
@@ -2698,7 +3214,77 @@ last_updated: ${ctx.date}
 `;
 }
 
+// src/templates/root-agents.ts
+function rootAgentsTemplate(ctx) {
+  const isSolo = ctx.profile === "solo";
+  return `---
+purpose: Entry point for AI agents \u2014 routes to team-foundry context files
+read_when: always
+last_updated: ${ctx.date}
+owner:
+---
+
+# Agents
+
+This repo uses **team-foundry** \u2014 structured files that give AI tools real team context.
+Use this file to orient yourself and find the right files before answering.
+
+## Project overview
+
+<!-- GAP: The project overview hasn't been filled in yet. Run the onboarding interview to populate it. -->
+
+## Where to find context
+
+| Topic | Path |
+|---|---|
+| Vision and north star metric | \`team-foundry/product/north-star.md\` |
+| This quarter's outcomes | \`team-foundry/product/outcomes.md\` |
+| Who our customers are | \`team-foundry/product/customers.md\` |
+| Tech stack and conventions | \`team-foundry/engineering/stack.md\` |${isSolo ? "" : `
+| Current roadmap | \`team-foundry/product/now-next-later.md\` |
+| Strategic logic | \`team-foundry/product/strategy.md\` |
+| Open assumptions | \`team-foundry/product/assumptions.md\` |
+| Key risks | \`team-foundry/product/risks.md\` |
+| Team norms and DoD | \`team-foundry/team/working-agreement.md\` |
+| How we use AI tools | \`team-foundry/team/ai-practices.md\` |
+| Quality stance | \`team-foundry/engineering/quality-bar.md\` |
+| Architecture decisions | \`team-foundry/engineering/decisions/\` |
+| Design principles | \`team-foundry/design/principles.md\` |
+| Metric definitions | \`team-foundry/data/metrics.md\` |
+| Domain terms | \`team-foundry/context/glossary.md\` |
+| Stakeholders | \`team-foundry/context/stakeholders.md\` |`}
+
+## Setup
+
+See \`team-foundry/engineering/stack.md\` for the tech stack, local setup steps, and environment requirements.
+
+## Code conventions
+
+See \`team-foundry/engineering/stack.md\` for language and framework conventions.${isSolo ? "" : `
+See \`team-foundry/engineering/quality-bar.md\` for the quality bar, bug triage policy, and definition of done.`}
+
+## Areas of caution
+
+- **Silent edits** \u2014 the team-foundry coach never writes files without the user's explicit confirmation. Do not write to \`team-foundry/\` files without confirmation.
+- **Private folder** \u2014 \`team-foundry/private/\` is gitignored. Do not read from or write to it.${isSolo ? "" : `
+- **ADR commitments** \u2014 architecture decisions in \`team-foundry/engineering/decisions/\` represent committed choices. Treat them as constraints unless the user explicitly opens a discussion.`}
+
+## Working with the team-foundry coach
+
+The coach runs in three modes \u2014 inline (always on, surfaces one-sentence nudges), explicit (triggered by "coach mode" or "let's do a team-foundry review"), and scheduled (weekly check-in, top 3 findings). See CLAUDE.md or GEMINI.md for the full trigger phrase table and loading instructions.
+
+**Draft-then-confirm rule:** the coach always shows a proposed file change and waits for confirmation before writing. Silence is not confirmation.
+${isSolo ? "" : `
+## Glossary
+
+See \`team-foundry/context/glossary.md\` for domain terms, acronyms, and known naming inconsistencies between teams.
+`}`;
+}
+
 // src/scaffold.ts
+var ALWAYS_ROOT_ENTRIES = [
+  { relativePath: "AGENTS.md", content: rootAgentsTemplate }
+];
 var SOLO_ENTRIES = [
   { relativePath: "GETTING_STARTED.md", content: gettingStartedTemplate },
   { relativePath: ".team-foundry/coach.md", content: coachTemplate },
@@ -2725,6 +3311,14 @@ var FULL_ONLY_ENTRIES = [
   { relativePath: "team-foundry/context/stakeholders.md", content: stakeholdersTemplate },
   { relativePath: "team-foundry/product/strategy.md", content: strategyTemplate }
 ];
+var FEDERATED_ENTRIES = [
+  { relativePath: "team-foundry/product/CLAUDE.md", content: federatedProductTemplate },
+  { relativePath: "team-foundry/team/CLAUDE.md", content: federatedTeamTemplate },
+  { relativePath: "team-foundry/engineering/CLAUDE.md", content: federatedEngineeringTemplate },
+  { relativePath: "team-foundry/design/CLAUDE.md", content: federatedDesignTemplate },
+  { relativePath: "team-foundry/data/CLAUDE.md", content: federatedDataTemplate },
+  { relativePath: "team-foundry/context/CLAUDE.md", content: federatedContextTemplate }
+];
 function rootEntries(tool) {
   if (tool === "claude") {
     return [{ relativePath: "CLAUDE.md", content: rootClaudeTemplate }];
@@ -2732,18 +3326,23 @@ function rootEntries(tool) {
   if (tool === "gemini") {
     return [{ relativePath: "GEMINI.md", content: rootGeminiTemplate }];
   }
+  if (tool === "cursor") {
+    return [{ relativePath: ".cursor/rules/team-foundry.mdc", content: rootCursorTemplate }];
+  }
   return [
     { relativePath: "CLAUDE.md", content: rootClaudeTemplate },
     { relativePath: "GEMINI.md", content: rootGeminiTemplate }
   ];
 }
 async function scaffold(options) {
-  const { targetDir, profile, tool, repoVisibility, date, ingestionPath, ingestion } = options;
+  const { targetDir, profile, tool, repoVisibility, date, ingestionPath, ingestion, federated } = options;
   const ctx = { profile, tool, repoVisibility, date, ingestionPath, ingestion };
   const entries = [
+    ...ALWAYS_ROOT_ENTRIES,
     ...rootEntries(tool),
     ...SOLO_ENTRIES,
-    ...profile === "full" ? FULL_ONLY_ENTRIES : []
+    ...profile === "full" ? FULL_ONLY_ENTRIES : [],
+    ...profile === "full" && federated ? FEDERATED_ENTRIES : []
   ];
   for (const entry of entries) {
     const fullPath = path.join(targetDir, entry.relativePath);
@@ -2778,10 +3377,428 @@ async function writeGitignore(targetDir) {
 `, "utf-8");
 }
 
+// src/status.ts
+import fs3 from "fs/promises";
+import path3 from "path";
+import { spawnSync } from "child_process";
+
+// src/link-checker.ts
+import { readFile } from "fs/promises";
+var SEVERITY = {
+  missing: 3,
+  "outcome-metric": 3,
+  "now-assumption": 3,
+  "assumption-outcome": 3,
+  stale: 2,
+  empty: 2
+};
+function recencyFactor(prs) {
+  if (prs > 3) return 2;
+  if (prs > 0) return 1;
+  return 0;
+}
+function escapeRe(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function actionForHealth(health, file) {
+  if (health === "missing") return `Run \`npx create-team-foundry\` to scaffold ${file}`;
+  if (health === "empty") return `Fill in ${file} with real content (remove stub placeholder)`;
+  return `Update last_updated in ${file} and review content for accuracy`;
+}
+function actionForLink(type, item, file) {
+  if (type === "outcome-metric") return `Define "${item}" in data/metrics.md with formula, source, window, owner`;
+  if (type === "now-assumption") return `Add assumption reference to "${item}" in ${file} or link it in assumptions.md`;
+  return `Add cross-reference between "${item}" and a related outcome or assumption`;
+}
+function rankFindings(healthFindings, linkFindings) {
+  const candidates = [];
+  for (const h of healthFindings) {
+    const severity = SEVERITY[h.health] ?? 1;
+    const score = severity * 3 + recencyFactor(h.prs);
+    candidates.push({
+      item: h.file,
+      file: h.file,
+      detail: `File is ${h.health}: ${h.file.replace("team-foundry/", "")}`,
+      score,
+      action: actionForHealth(h.health, h.file)
+    });
+  }
+  for (const l of linkFindings) {
+    const severity = SEVERITY[l.type] ?? 1;
+    const score = severity * 3;
+    candidates.push({
+      item: l.item,
+      file: l.file,
+      detail: l.detail,
+      score,
+      action: actionForLink(l.type, l.item, l.file)
+    });
+  }
+  candidates.sort((a, b) => {
+    if (b.score !== a.score) return b.score - a.score;
+    return a.file.localeCompare(b.file);
+  });
+  return candidates.slice(0, 3);
+}
+function extractHeadings(content, section) {
+  if (!content.trim()) return [];
+  let source = content;
+  if (section) {
+    const sectionRe = new RegExp(
+      `(?:^|\\n)###\\s+${escapeRe(section)}\\s*\\n([\\s\\S]*?)(?=\\n###|$)`
+    );
+    const match = source.match(sectionRe);
+    source = match ? match[1] : "";
+  }
+  const headings = [];
+  for (const line of source.split("\n")) {
+    const m = line.match(/^##\s+(.+)$/);
+    if (m) headings.push(m[1].trim());
+  }
+  return headings;
+}
+function extractSectionBodies(content) {
+  const result = {};
+  const lines = content.split("\n");
+  let currentHeading = null;
+  const bodyLines = [];
+  for (const line of lines) {
+    const m = line.match(/^##\s+(.+)$/);
+    if (m) {
+      if (currentHeading !== null) result[currentHeading] = bodyLines.join("\n").trim();
+      currentHeading = m[1].trim();
+      bodyLines.length = 0;
+    } else if (currentHeading !== null) {
+      bodyLines.push(line);
+    }
+  }
+  if (currentHeading !== null) result[currentHeading] = bodyLines.join("\n").trim();
+  return result;
+}
+function checkOutcomeMetricLinks(outcomesContent, northStarContent, metricsContent) {
+  const defined = new Set(extractHeadings(metricsContent));
+  if (defined.size === 0) return [];
+  const findings = [];
+  const fromOutcomes = extractHeadings(outcomesContent, "Key Metrics");
+  const fromNorthStar = extractHeadings(northStarContent, "Key Metrics");
+  for (const heading of fromOutcomes) {
+    if (!defined.has(heading)) {
+      findings.push({
+        type: "outcome-metric",
+        file: "team-foundry/product/outcomes.md",
+        item: heading,
+        detail: `"${heading}" in outcomes.md#Key Metrics is not defined in data/metrics.md`
+      });
+    }
+  }
+  for (const heading of fromNorthStar) {
+    if (!defined.has(heading)) {
+      findings.push({
+        type: "outcome-metric",
+        file: "team-foundry/product/north-star.md",
+        item: heading,
+        detail: `"${heading}" in north-star.md#Key Metrics is not defined in data/metrics.md`
+      });
+    }
+  }
+  return findings;
+}
+function checkNowAssumptionLinks(nowNextLaterContent, assumptionsContent) {
+  if (!nowNextLaterContent.trim()) return [];
+  const assumptionHeadings = extractHeadings(assumptionsContent);
+  if (assumptionHeadings.length === 0) return [];
+  const nowItems = extractHeadings(nowNextLaterContent, "Now");
+  const bodies = extractSectionBodies(nowNextLaterContent);
+  const findings = [];
+  for (const item of nowItems) {
+    const body = bodies[item] ?? "";
+    const referencesAssumption = assumptionHeadings.some((a) => body.includes(a));
+    if (!referencesAssumption) {
+      findings.push({
+        type: "now-assumption",
+        file: "team-foundry/product/now-next-later.md",
+        item,
+        detail: `Now item "${item}" has no linked assumption in product/assumptions.md`
+      });
+    }
+  }
+  return findings;
+}
+function checkAssumptionOutcomeReciprocity(assumptionsContent, outcomesContent) {
+  if (!assumptionsContent.trim() || !outcomesContent.trim()) return [];
+  const outcomeHeadings = extractHeadings(outcomesContent);
+  const assumptionHeadings = extractHeadings(assumptionsContent);
+  const assumptionBodies = extractSectionBodies(assumptionsContent);
+  const outcomeBodies = extractSectionBodies(outcomesContent);
+  const findings = [];
+  for (const assumption of assumptionHeadings) {
+    const body = assumptionBodies[assumption] ?? "";
+    if (!outcomeHeadings.some((o) => body.includes(o))) {
+      findings.push({
+        type: "assumption-outcome",
+        file: "team-foundry/product/assumptions.md",
+        item: assumption,
+        detail: `Assumption "${assumption}" does not reference any outcome`
+      });
+    }
+  }
+  for (const outcome of outcomeHeadings) {
+    const body = outcomeBodies[outcome] ?? "";
+    if (!assumptionHeadings.some((a) => body.includes(a))) {
+      findings.push({
+        type: "assumption-outcome",
+        file: "team-foundry/product/outcomes.md",
+        item: outcome,
+        detail: `Outcome "${outcome}" does not reference any assumption`
+      });
+    }
+  }
+  return findings;
+}
+async function readOptional(filePath) {
+  try {
+    return await readFile(filePath, "utf-8");
+  } catch {
+    return "";
+  }
+}
+async function runLinkChecks(targetDir) {
+  const p = (rel) => `${targetDir}/${rel}`;
+  const [outcomes, northStar, metrics, nowNext, assumptions] = await Promise.all([
+    readOptional(p("team-foundry/product/outcomes.md")),
+    readOptional(p("team-foundry/product/north-star.md")),
+    readOptional(p("team-foundry/data/metrics.md")),
+    readOptional(p("team-foundry/product/now-next-later.md")),
+    readOptional(p("team-foundry/product/assumptions.md"))
+  ]);
+  return [
+    ...checkOutcomeMetricLinks(outcomes, northStar, metrics),
+    ...checkNowAssumptionLinks(nowNext, assumptions),
+    ...checkAssumptionOutcomeReciprocity(assumptions, outcomes)
+  ];
+}
+
+// src/status.ts
+var SOLO_FILES = [
+  "team-foundry/product/north-star.md",
+  "team-foundry/product/outcomes.md",
+  "team-foundry/product/customers.md",
+  "team-foundry/engineering/stack.md"
+];
+var FULL_ONLY_FILES = [
+  "team-foundry/product/now-next-later.md",
+  "team-foundry/product/assumptions.md",
+  "team-foundry/product/risks.md",
+  "team-foundry/product/strategy.md",
+  "team-foundry/team/trio.md",
+  "team-foundry/team/working-agreement.md",
+  "team-foundry/team/ai-practices.md",
+  "team-foundry/engineering/quality-bar.md",
+  "team-foundry/design/principles.md",
+  "team-foundry/data/metrics.md",
+  "team-foundry/context/glossary.md",
+  "team-foundry/context/stakeholders.md"
+];
+var ALL_FILES = [...SOLO_FILES, ...FULL_ONLY_FILES];
+var STALE_DAYS = 45;
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return {};
+  const result = {};
+  for (const line of match[1].split("\n")) {
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    const value = line.slice(idx + 1).trim();
+    result[key] = value;
+  }
+  return result;
+}
+function daysSince(dateStr) {
+  const then = new Date(dateStr).getTime();
+  if (isNaN(then)) return null;
+  return Math.floor((Date.now() - then) / 864e5);
+}
+function prsSinceDate(targetDir, dateStr) {
+  try {
+    const since = new Date(dateStr).toISOString();
+    if (isNaN(new Date(dateStr).getTime())) return null;
+    const result = spawnSync(
+      "git",
+      ["-C", targetDir, "log", "--oneline", "--merges", `--since=${since}`],
+      { encoding: "utf-8", timeout: 5e3 }
+    );
+    if (result.status !== 0) return null;
+    return result.stdout.trim().split("\n").filter(Boolean).length;
+  } catch {
+    return null;
+  }
+}
+function isEffectivelyEmpty(body) {
+  const stripped = body.replace(/<!--[\s\S]*?-->/g, "").replace(/^#+\s.*$/gm, "").trim();
+  return stripped.length < 30;
+}
+async function analyzeFile(targetDir, relativePath) {
+  const fullPath = path3.join(targetDir, relativePath);
+  let exists = false;
+  let isEmpty = false;
+  let lastUpdated = null;
+  let owner = null;
+  let daysSinceUpdate = null;
+  let prsSince = null;
+  try {
+    const content = await fs3.readFile(fullPath, "utf-8");
+    exists = true;
+    const body = content.replace(/^---[\s\S]*?---\n?/, "").trim();
+    isEmpty = isEffectivelyEmpty(body);
+    const fm = parseFrontmatter(content);
+    if (fm["last_updated"]) {
+      lastUpdated = fm["last_updated"];
+      daysSinceUpdate = daysSince(lastUpdated);
+      prsSince = prsSinceDate(targetDir, lastUpdated);
+    }
+    owner = fm["owner"] || null;
+  } catch {
+  }
+  let health = "ok";
+  if (!exists) health = "missing";
+  else if (isEmpty) health = "empty";
+  else if (daysSinceUpdate !== null && daysSinceUpdate >= STALE_DAYS) health = "stale";
+  return {
+    relativePath,
+    lastUpdated,
+    owner,
+    daysSinceUpdate,
+    prsSinceUpdate: prsSince,
+    exists,
+    isEmpty,
+    health
+  };
+}
+function healthIcon(health) {
+  if (health === "ok") return "\u2713";
+  if (health === "stale") return "~";
+  if (health === "empty") return "\u25CB";
+  return "\u2717";
+}
+function formatRow(s) {
+  const icon = healthIcon(s.health);
+  const rawName = s.relativePath.replace("team-foundry/", "");
+  const name = rawName.slice(0, 42).padEnd(42);
+  const updated = s.lastUpdated ?? "\u2014";
+  const age = s.daysSinceUpdate !== null ? `${s.daysSinceUpdate}d` : "\u2014";
+  const prs = s.prsSinceUpdate !== null ? `${s.prsSinceUpdate} PRs` : "\u2014";
+  const owner = s.owner || "\u2014";
+  return `  ${icon}  ${name} ${updated.padEnd(12)} ${age.padEnd(6)} ${prs.padEnd(8)} ${owner}`;
+}
+function whyNudge(s) {
+  const parts = [];
+  if (s.daysSinceUpdate !== null) parts.push(`${s.daysSinceUpdate} days since last update`);
+  if (s.prsSinceUpdate !== null && s.prsSinceUpdate > 0)
+    parts.push(`${s.prsSinceUpdate} PRs shipped since then`);
+  if (!s.owner) parts.push("no owner set");
+  return parts.join(", ");
+}
+async function runStatus(targetDir) {
+  const fullProfileFile = path3.join(targetDir, "team-foundry/team/trio.md");
+  let isFullProfile = false;
+  try {
+    await fs3.access(fullProfileFile);
+    isFullProfile = true;
+  } catch {
+  }
+  const filesToCheck = isFullProfile ? ALL_FILES : SOLO_FILES;
+  const results = await Promise.all(filesToCheck.map((f) => analyzeFile(targetDir, f)));
+  const ok = results.filter((r) => r.health === "ok");
+  const stale = results.filter((r) => r.health === "stale");
+  const empty = results.filter((r) => r.health === "empty");
+  const missing = results.filter((r) => r.health === "missing");
+  console.log("\n  team-foundry status\n");
+  console.log(`  ${"File".padEnd(44)} ${"Last updated".padEnd(12)} ${"Age".padEnd(6)} ${"PRs".padEnd(8)} Owner`);
+  console.log(`  ${"\u2500".repeat(90)}`);
+  for (const s of results) console.log(formatRow(s));
+  console.log();
+  console.log(`  \u2713 ${ok.length} current   ~ ${stale.length} stale   \u25CB ${empty.length} empty   \u2717 ${missing.length} missing
+`);
+  let linkFindings = [];
+  if (isFullProfile) {
+    linkFindings = await runLinkChecks(targetDir);
+    if (linkFindings.length > 0) {
+      console.log(`  Link Integrity`);
+      console.log(`  ${"\u2500".repeat(60)}`);
+      const byType = {};
+      for (const f of linkFindings) {
+        (byType[f.type] ??= []).push(f);
+      }
+      const typeLabels = {
+        "outcome-metric": "Outcome references undefined metric",
+        "now-assumption": "Now item missing linked assumption",
+        "assumption-outcome": "Assumption/outcome unlinked"
+      };
+      for (const [type, items] of Object.entries(byType)) {
+        console.log(`
+  ! ${typeLabels[type] ?? type}`);
+        for (const item of items) {
+          console.log(`      ${item.file.replace("team-foundry/", "")} \u2192 ${item.detail}`);
+        }
+      }
+      console.log();
+    }
+  }
+  const healthForRanking = results.filter((r) => r.health !== "ok").map((r) => ({
+    file: r.relativePath,
+    health: r.health,
+    prs: r.prsSinceUpdate ?? 0
+  }));
+  const top3 = rankFindings(healthForRanking, linkFindings);
+  console.log(`  Top 3 Fix Suggestions`);
+  console.log(`  ${"\u2500".repeat(60)}`);
+  if (top3.length === 0) {
+    console.log("  No critical drift detected this week.\n");
+  } else {
+    for (let i = 0; i < top3.length; i++) {
+      const s = top3[i];
+      console.log(`
+  ${i + 1}) ${s.detail}`);
+      console.log(`     In: ${s.file.replace("team-foundry/", "")}`);
+      console.log(`     Action: ${s.action}`);
+    }
+    console.log();
+  }
+  if (stale.length > 0) {
+    console.log("  Stale files \u2014 why this nudge:\n");
+    for (const s of stale) {
+      console.log(`    ~ ${s.relativePath.replace("team-foundry/", "")}`);
+      console.log(`      ${whyNudge(s)}
+`);
+    }
+  }
+  if (empty.length > 0) {
+    console.log("  Empty files \u2014 not yet filled in:\n");
+    for (const s of empty) {
+      console.log(`    \u25CB ${s.relativePath.replace("team-foundry/", "")}`);
+    }
+    console.log();
+  }
+  if (missing.length > 0) {
+    console.log("  Missing files \u2014 run `npx create-team-foundry` to scaffold:\n");
+    for (const s of missing) {
+      console.log(`    \u2717 ${s.relativePath.replace("team-foundry/", "")}`);
+    }
+    console.log();
+  }
+  const noOwner = results.filter((r) => r.exists && !r.owner);
+  if (noOwner.length > 0) {
+    console.log(`  ${noOwner.length} file(s) have no owner set. Add \`owner: <name>\` to their frontmatter.
+`);
+  }
+}
+
 // src/index.ts
 var TOOL_LABEL = {
   claude: "Claude Code",
   gemini: "Gemini CLI",
+  cursor: "Cursor",
   both: "Claude Code or Gemini CLI"
 };
 var PASTE_PLACEHOLDER = `# Paste your existing docs here
@@ -2799,16 +3816,16 @@ You can paste multiple documents \u2014 just separate them with a heading like:
 When you're done, save this file and start the onboarding interview.
 `;
 async function checkDirectory(targetDir) {
-  const prdPath = path3.join(targetDir, "team-foundry-prd-v2.md");
-  const scaffoldPath = path3.join(targetDir, "src", "scaffold.ts");
+  const prdPath = path4.join(targetDir, "team-foundry-prd-v2.md");
+  const scaffoldPath = path4.join(targetDir, "src", "scaffold.ts");
   let isSourceRepo = false;
   try {
-    await fs3.access(prdPath);
+    await fs4.access(prdPath);
     isSourceRepo = true;
   } catch {
   }
   try {
-    await fs3.access(scaffoldPath);
+    await fs4.access(scaffoldPath);
     isSourceRepo = true;
   } catch {
   }
@@ -2818,17 +3835,17 @@ async function checkDirectory(targetDir) {
     );
     process.exit(1);
   }
-  const pkgPath = path3.join(targetDir, "package.json");
-  const srcPath = path3.join(targetDir, "src");
+  const pkgPath = path4.join(targetDir, "package.json");
+  const srcPath = path4.join(targetDir, "src");
   let hasPkg = false;
   let hasSrc = false;
   try {
-    await fs3.access(pkgPath);
+    await fs4.access(pkgPath);
     hasPkg = true;
   } catch {
   }
   try {
-    await fs3.access(srcPath);
+    await fs4.access(srcPath);
     hasSrc = true;
   } catch {
   }
@@ -2845,22 +3862,81 @@ async function checkDirectory(targetDir) {
 }
 async function main() {
   const targetDir = process.cwd();
+  if (process.argv[2] === "status") {
+    await runStatus(targetDir);
+    return;
+  }
   await checkDirectory(targetDir);
   const answers = await runPrompts();
   const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   await scaffold({ ...answers, targetDir, date });
   await writeGitignore(targetDir);
-  if (answers.ingestion === "paste") {
-    const pastePath = path3.join(targetDir, ".team-foundry", "paste-content.md");
+  if (answers.ingestion === "paste" || answers.ingestion === "repo+paste") {
+    const pastePath = path4.join(targetDir, ".team-foundry", "paste-content.md");
     try {
-      await fs3.access(pastePath);
+      await fs4.access(pastePath);
     } catch {
-      await fs3.writeFile(pastePath, PASTE_PLACEHOLDER, "utf-8");
+      await fs4.writeFile(pastePath, PASTE_PLACEHOLDER, "utf-8");
     }
   }
   const tool = TOOL_LABEL[answers.tool];
   let ingestionNote;
-  if (answers.ingestion === "paste") {
+  if (answers.ingestion === "repo") {
+    ingestionNote = `
+Next steps:
+
+  1. cd ${targetDir}
+
+  2. Open ${tool} and say:
+
+       "Let's set up our team-foundry."
+
+  The AI will read your repo (README, package.json, git history, GitHub
+  PRs/issues) and pre-fill answers before asking questions.
+`;
+  } else if (answers.ingestion === "repo+local") {
+    ingestionNote = `
+Next steps:
+
+  1. cd ${targetDir}
+
+  2. Open ${tool} and say:
+
+       "Let's set up our team-foundry."
+
+  The AI will read your repo first, then supplement with the docs in
+  ${answers.ingestionPath ?? "[your docs folder]"}.
+`;
+  } else if (answers.ingestion === "repo+mcp") {
+    ingestionNote = `
+Next steps:
+
+  1. In ${tool} settings, connect your MCP server
+     (Notion, Confluence, or Google Drive) if you haven't already.
+
+  2. cd ${targetDir}
+
+  3. Open ${tool} and say:
+
+       "Let's set up our team-foundry."
+
+  The AI will read your repo first, then supplement from your MCP source.
+`;
+  } else if (answers.ingestion === "repo+paste") {
+    ingestionNote = `
+Next steps:
+
+  1. Open .team-foundry/paste-content.md and paste in your existing docs
+     (strategy, roadmaps, customer research). Save the file.
+
+  2. cd ${targetDir}
+
+  3. Open ${tool} and say:
+
+       "Let's set up our team-foundry. I've added docs to
+        paste-content.md \u2014 use them to supplement the repo scan."
+`;
+  } else if (answers.ingestion === "paste") {
     ingestionNote = `
 Next steps: