fdeops 3.15.2 → 3.17.0

package/README.md

@@ -2,16 +2,9 @@
 
 **Forward deployed engineering skills for AI coding agents.**
 
-Skills encode the workflows, quality gates, and judgment Forward Deployed Engineers use on someone else's site. Packaged so an AI coding agent can run the embed end-to-end: discovery, POC, slice, on-site proof, eval, signed outcome. The workspace still compiles and commits. `@fde` does not leave.
+Skills encode the workflows, quality gates, and judgment Forward Deployed Engineers use on someone else's site. Packaged so an AI coding agent can run the embed end-to-end: discovery, POC, their codebase (greenfield or brownfield), go-live, eval, signed outcome. The workspace still compiles and commits. `@fde` does not leave.
 
-```text
-  LAND              DISCOVER           PLAN              SHIP               PROVE              CLOSE
- ┌────────┐      ┌────────┐      ┌────────┐      ┌────────┐      ┌────────┐      ┌────────┐
- │  Brief │ ───▶ │ Reality│ ───▶ │ Sequence│───▶ │  Live  │ ───▶ │ Signed │ ───▶ │  They  │
- │  Trust │      │ Terrain│      │  Align │      │  slice │      │   off  │      │   run  │
- └────────┘      └────────┘      └────────┘      └────────┘      └────────┘      └────────┘
-  /brief           /discover          /plan             /ship            /outcome           /close
-```
+<img width="1774" height="887" alt="FDEops-githubposter" src="https://github.com/user-attachments/assets/9eb842d2-a356-4995-9057-841f1b2d15d6" />
 
 ---
 
@@ -21,23 +14,24 @@ Each command loads the same `@fde` skill. You never pick from 31 names.
 
 | What you're doing | Command | Key principle |
 |-------------------|---------|-----------|
-| Land the embed | `/brief` | Who signs done |
-| Find the real problem | `/discover` | Brief is a hypothesis |
-| Plan the sequence | `/plan` | Backwards from done |
-| Ship a slice | `/ship` | Live with a rollback |
-| Prove the outcome | `/outcome` | Promised, measured, accepted |
-| Close the embed | `/close` | They run it without you |
+| First week on site | `/brief` | Name who signs done |
+| Find the real problem | `/discover` | Treat the brief as a hypothesis |
+| Sequence the work | `/plan` | Work backwards from done |
+| Ship to their production | `/ship` | One change they can see, then go live with a rollback you have run |
+| Get the number accepted | `/outcome` | Promised, measured, accepted |
+| Hand off so they run it | `/close` | They operate it without you |
 
-Four tells the map does not cover:
+Also:
 
 | What you're doing | Command | Key principle |
 |-------------------|---------|-----------|
-| Sponsor went silent | `/quiet` | Process or trust |
-| Scope dispute | `/agreed` | Dated receipts, or a gap |
+| Sponsor went quiet | `/trust` | Process gap, or they stopped trusting you |
+| When did we agree? | `/receipts` | A dated line, or it did not happen |
 | After a meeting | `/debrief` | Notes into the record |
-| Walk-in / Friday | `/prep` `/status` | One page, then the ledger |
+| Prep before the meeting | `/prep` | One page from the record |
+| Friday sponsor update | `/readout` | Promised, measured, accepted |
 
-Skills also activate on English: naming a client, running a POC, slicing a feature, asking what was agreed. A throwaway one-liner in an unbound repo can skip `@fde`. A client slice cannot.
+Skills also activate on English: naming a client, running a POC, changing their checkout, going live, asking what was agreed. A throwaway one-liner in an unbound repo can skip `@fde`. Bound client work cannot.
 
 ---
 
@@ -99,9 +93,9 @@ Requires Node.js >= 18. Override: `FDEOPS_ENGAGEMENT`. See [docs/install.md](doc
 
 ---
 
-## All 31 Skills
+## All 30 Skills
 
-The commands above are the entry points. Under the hood, `@fde` activates these 31 skills, each a structured workflow with steps, an artifact, and a checkpoint. You never pick one by name. Full detail: [docs/skills-reference.md](docs/skills-reference.md).
+The commands above are the entry points. Under the hood, `@fde` activates these 30 skills, each a structured workflow with steps, an artifact, and a checkpoint. You never pick one by name. Full detail: [docs/skills-reference.md](docs/skills-reference.md).
 
 ### Land - Brief and trust
 
@@ -109,59 +103,58 @@ The commands above are the entry points. Under the hood, `@fde` activates these
 |--------|--------------|----------|
 | [land](skills/fde/references/land.md) | Interrogate the brief, map stakeholders, define success | New client, first meeting, just got the brief |
 | [audit](skills/fde/references/audit.md) | Verify claims, find the load-bearing wall | Taking over, previous consultant left |
-| [stakeholder-radar](skills/fde/references/stakeholder-radar.md) | Who decides, who blocks, who escalates | Need to know who matters |
-| [trust-engineering](skills/fde/references/trust-engineering.md) | Observer → trusted; navigate AI policy | Need access or credibility |
-| [scope-defense](skills/fde/references/scope-defense.md) | Scope receipts; the accumulation conversation | "Also can you…", timeline unchanged |
+| [who-decides](skills/fde/references/who-decides.md) | Who decides, who blocks, who escalates | Need to know who matters |
+| [earn-trust](skills/fde/references/earn-trust.md) | Observer → trusted; navigate AI policy | Need access or credibility |
+| [hold-scope](skills/fde/references/hold-scope.md) | Scope receipts; the accumulation conversation | "Also can you…", timeline unchanged |
 
 ### Discover - Find the real problem
 
 | Skill | What It Does | Use When |
 |--------|--------------|----------|
-| [discover](skills/fde/references/discover.md) | Repo + workaround + the real problem | Brief feels wrong, shadow processes |
-| [assumption-audit](skills/fde/references/assumption-audit.md) | Untested assumptions by blast radius | Brief feels too neat |
-| [use-case-scoring](skills/fde/references/use-case-scoring.md) | Value × urgency × alignment / complexity | Everything is P0 |
-| [sketch](skills/fde/references/sketch.md) | Kill the killer assumption in a day | POC, spike, need to de-risk |
+| [discover](skills/fde/references/discover.md) | Question first, then repo + workaround | Brief feels wrong, shadow processes |
+| [test-assumptions](skills/fde/references/test-assumptions.md) | Untested assumptions by blast radius | Brief feels too neat |
+| [score-use-cases](skills/fde/references/score-use-cases.md) | Value × urgency × alignment / complexity | Everything is P0 |
+| [poc](skills/fde/references/poc.md) | Kill the killer assumption in a day | POC, spike, need to de-risk |
 
 ### Plan - Sequence the work
 
 | Skill | What It Does | Use When |
 |--------|--------------|----------|
-| [plan](skills/fde/references/plan.md) | Backwards from done, PR-sized | What order, what is done |
+| [plan](skills/fde/references/plan.md) | Backwards from done, Kill if on each PR | What order, what is done |
 | [business-case](skills/fde/references/business-case.md) | Cost of nothing → investment → return | Defend budget or timeline |
-| [options-analysis](skills/fde/references/options-analysis.md) | Three genuine options | "What should we do?" |
-| [initiative-triage](skills/fde/references/initiative-triage.md) | Pick three from twenty urgents | Everything is urgent |
+| [three-options](skills/fde/references/three-options.md) | Three genuine options | "What should we do?" |
+| [pick-three](skills/fde/references/pick-three.md) | Pick three from twenty urgents | Everything is urgent |
 
-### Ship - Go live
+### Ship - On their repo, then live
 
 | Skill | What It Does | Use When |
 |--------|--------------|----------|
-| [incremental-build](skills/fde/references/incremental-build.md) | Vertical slices, on-site proof | Building on their codebase |
-| [blast-radius](skills/fde/references/blast-radius.md) | Impact from contained → irreversible | Touching shared infrastructure |
+| [ship](skills/fde/references/ship.md) | One change they can see (greenfield or brownfield), proven on their staging, then go live | Building, updating, or going live |
+| [what-breaks](skills/fde/references/what-breaks.md) | Impact from contained → irreversible | Touching shared infrastructure |
 | [rescue](skills/fde/references/rescue.md) | Production fire or trust fire | Down, or they went quiet |
-| [ship](skills/fde/references/ship.md) | Intent vs diff, pre-flight, rollback | Going live |
 | [review](skills/fde/references/review.md) | Did we only build what we agreed | Before merge, scope creep |
-| [rollback-drill](skills/fde/references/rollback-drill.md) | Test the escape route before 2am | "We can always revert" |
+| [rollback](skills/fde/references/rollback.md) | Test the escape route before 2am | "We can always revert" |
 
-### Prove - Outcome
+### Outcome - Get the number accepted
 
 | Skill | What It Does | Use When |
 |--------|--------------|----------|
-| [status](skills/fde/references/status.md) | Promised → measured → accepted | Friday, sponsor update |
+| [readout](skills/fde/references/readout.md) | Promised → measured → accepted | Friday, sponsor update |
 | [demo-prep](skills/fde/references/demo-prep.md) | One number, five hard questions | Demo or exec walkthrough |
 | [debrief](skills/fde/references/debrief.md) | Meeting notes into the record | Just left a meeting |
-| [exec-narrative](skills/fde/references/exec-narrative.md) | Board / sponsor's boss | Justify continued investment |
+| [board-memo](skills/fde/references/board-memo.md) | Board / sponsor's boss | Justify continued investment |
 | [dashboard](skills/fde/references/dashboard.md) | Portfolio, trust-ordered | All my customers |
 | [ingest](skills/fde/references/ingest.md) | Pull text you confirm | Transcript, Notion, Slack |
-| [ingest-connect](skills/fde/references/ingest-connect.md) | Wire a source MCP | Connect Granola |
+| [connect](skills/fde/references/connect.md) | Wire a source MCP | Connect Granola |
 
 ### Close - They run it
 
 | Skill | What It Does | Use When |
 |--------|--------------|----------|
 | [close](skills/fde/references/close.md) | Handoff that survives you | Wrapping up |
-| [handoff-engineering](skills/fde/references/handoff-engineering.md) | Runbook, confidence scoring | They must operate without you |
-| [multi-customer-ops](skills/fde/references/multi-customer-ops.md) | Switch without bleed | 2+ clients |
-| [pattern-extract](skills/fde/references/pattern-extract.md) | If you did it twice, encode it | It will apply again |
+| [runbook](skills/fde/references/runbook.md) | Runbook, confidence scoring | They must operate without you |
+| [switch-clients](skills/fde/references/switch-clients.md) | Switch without bleed | 2+ clients |
+| [encode-pattern](skills/fde/references/encode-pattern.md) | If you did it twice, encode it | It will apply again |
 | [red-team](skills/fde/references/red-team.md) | Stress-test before they do | "Poke holes in this" |
 
 Overlays (on signal, not on request): [ai](skills/fde/references/ai.md) · [artifacts](skills/fde/references/artifacts.md) · [fintech](skills/fde/references/fintech.md) · [healthcare](skills/fde/references/healthcare.md) · [gov](skills/fde/references/gov.md) · [eval-pack](skills/fde/references/eval-pack.md)
@@ -191,7 +184,7 @@ One skill. One reference file per situation. One folder per client.
 ```
 
 - **Process, not prose.** Each reference is a workflow with an artifact and a checkpoint, not a tip sheet.
-- **Ground loop.** Name → characterise → prove where they live → log. The workspace compiles; `@fde` stays.
+- **Ground loop.** Name → characterise → prove where they live → go live → log. The workspace compiles; `@fde` stays.
 - **You confirm.** Nothing is written until you say so.
 - **Progressive disclosure.** `SKILL.md` is the entry point. One `references/*.md` loads when routed.
 - **Local CLI.** Writes and status cost zero model tokens. The AI coding agent runs it.
@@ -206,37 +199,36 @@ Change hosts, install `@fde` on the new one, bind if needed, keep talking. The r
 fdeops/
 ├── skills/fde/                            # the one skill hosts load
 │   ├── SKILL.md                           #   router
-│   └── references/                        #   31 skills + overlays (you never pick)
+│   └── references/                        #   30 skills + overlays (you never pick)
 │       ├── land.md                        #   Land
 │       ├── audit.md
-│       ├── stakeholder-radar.md
-│       ├── trust-engineering.md
-│       ├── scope-defense.md
+│       ├── who-decides.md
+│       ├── earn-trust.md
+│       ├── hold-scope.md
 │       ├── discover.md                    #   Discover
-│       ├── assumption-audit.md
-│       ├── use-case-scoring.md
-│       ├── sketch.md
+│       ├── test-assumptions.md
+│       ├── score-use-cases.md
+│       ├── poc.md
 │       ├── plan.md                        #   Plan
 │       ├── business-case.md
-│       ├── options-analysis.md
-│       ├── initiative-triage.md
-│       ├── incremental-build.md           #   Ship
-│       ├── blast-radius.md
+│       ├── three-options.md
+│       ├── pick-three.md
+│       ├── ship.md                        #   Ship
+│       ├── what-breaks.md
 │       ├── rescue.md
-│       ├── ship.md
 │       ├── review.md
-│       ├── rollback-drill.md
-│       ├── status.md                      #   Prove
+│       ├── rollback.md
+│       ├── readout.md                      #   Outcome
 │       ├── demo-prep.md
 │       ├── debrief.md
-│       ├── exec-narrative.md
+│       ├── board-memo.md
 │       ├── dashboard.md
 │       ├── ingest.md
-│       ├── ingest-connect.md
+│       ├── connect.md
 │       ├── close.md                       #   Close
-│       ├── handoff-engineering.md
-│       ├── multi-customer-ops.md
-│       ├── pattern-extract.md
+│       ├── runbook.md
+│       ├── switch-clients.md
+│       ├── encode-pattern.md
 │       ├── red-team.md
 │       ├── ai.md                          #   overlays (on signal)
 │       ├── artifacts.md
@@ -251,11 +243,11 @@ fdeops/
 │   ├── ship.md
 │   ├── outcome.md
 │   ├── close.md
-│   ├── quiet.md
-│   ├── agreed.md
+│   ├── trust.md
+│   ├── receipts.md
 │   ├── debrief.md
 │   ├── prep.md
-│   └── status.md
+│   └── readout.md
 ├── .claude-plugin/                        # Claude Code marketplace
 ├── bin/                                   # local CLI: git + files, no network
 ├── hooks/                                 # session-start / session-stop / pre-compact
@@ -273,7 +265,7 @@ fdeops/
 
 AI coding agents are built for a repo, not for a client. They forget the sponsor, the promise, who can say yes, and whether anyone accepted the number. Monday morning they start from the ticket again.
 
-FDEOps is what you take on site. One `@fde` skill runs the embed from discovery to signed outcome: POC, slice, on-site proof, eval when a model judges, promised → measured → accepted. A local CLI dates every decision. `.fde/` is markdown on your laptop. You confirm; then it is on the record.
+FDEOps is what you take on site. One `@fde` skill runs the embed from discovery to signed outcome: POC, their codebase, go-live, eval when a model judges, promised → measured → accepted. A local CLI dates every decision. `.fde/` is markdown on your laptop. You confirm; then it is on the record.
 
 ---
 
@@ -313,7 +305,7 @@ Local only - `git` + files, no network, no telemetry. Plain markdown. The model
 ## Principles
 
 - **The artifact is the memory** - producing the work and recording it are one action
-- **Ground loop** - name the slice, characterise their code, prove it where they live, log the outcome
+- **Ground loop** - name the change, characterise their code, prove it on their staging, go live, log the outcome
 - **Skills, not autonomy** - the kit says what to check; judgment stays yours
 - **Brief is a hypothesis** - discover before building the wrong thing
 - **Evidence on every claim** - these files get defended in the room

package/adapters/AGENTS.md

@@ -6,7 +6,7 @@ You are the AI coding agent for a **Forward Deployed Engineer (FDE)** - the huma
 
 When the FDE types **`@fde`**, names a client, pastes meeting notes, asks what was agreed, or describes embed work (quiet sponsor, brief feels wrong, Friday update) - load the skill. If `fde resume` says NO ENGAGEMENT: ask the client name once, then **you** run `fde resume --init <slug>`. Never tell them to type it.
 
-Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client, stay on `@fde` for POC, slices, characterisation, on-site proof, eval, and go-live.
+Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client, stay on `@fde` for POC, small PRs, characterisation, proof on their staging, eval, and go-live.
 
 - Skill (single source of truth): `~/.claude/skills/fde/SKILL.md`
 - **Never ask the FDE to pick a skill.** Read the situation, route silently, do the work.

package/adapters/GEMINI.md

@@ -6,7 +6,7 @@ Context for Gemini CLI when assisting a **Forward Deployed Engineer (FDE)** - th
 
 When the FDE types **`@fde`**, names a client, pastes meeting notes, asks what was agreed, or describes embed work (quiet sponsor, brief feels wrong, Friday update) - load the skill. If `fde resume` says NO ENGAGEMENT: ask the client name once, then **you** run `fde resume --init <slug>`. Never tell them to type it.
 
-Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client, stay on `@fde` for POC, slices, characterisation, on-site proof, eval, and go-live.
+Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client, stay on `@fde` for POC, small PRs, characterisation, proof on their staging, eval, and go-live.
 
 - Skill (single source of truth): `~/.claude/skills/fde/SKILL.md`
 - **Never ask the FDE to pick a skill.** Read the situation, route silently, do the work.

package/adapters/LOCAL-LLM.md

@@ -62,13 +62,13 @@ The model reads SKILL.md, routes to the right skill, and produces artifacts in y
 
 ## Model size recommendations
 
-The methodology is detailed (31 skills, routing logic, evidence format, memory contract). Larger models handle it better:
+The methodology is detailed (30 skills, routing logic, evidence format, memory contract). Larger models handle it better:
 
 | Model class | Experience |
 |-------------|-----------|
-| **7-8B** (Llama 3.1 8B, Mistral 7B, Qwen 2.5 7B) | Handles individual skills (status, log, land). May struggle with complex routing or multi-skill sessions. Good for the CLI-heavy workflow where you invoke skills explicitly. |
+| **7-8B** (Llama 3.1 8B, Mistral 7B, Qwen 2.5 7B) | Handles individual skills (readout, log, land). May struggle with complex routing or multi-skill sessions. Good for the CLI-heavy workflow where you invoke skills explicitly. |
 | **13-34B** (Llama 3.1 13B, Mixtral 8x7B, Qwen 2.5 32B, DeepSeek-R1 32B) | Good across all domains. Routes correctly, follows memory contract, writes structured artifacts. Recommended minimum for full methodology use. |
-| **70B+** (Llama 3.1 405B, DeepSeek V3, Qwen 2.5 72B) | Full capability. Handles regulated overlays, multi-customer ops, exec-narrative pyramid structure, complex handoff engineering. |
+| **70B+** (Llama 3.1 405B, DeepSeek V3, Qwen 2.5 72B) | Full capability. Handles regulated overlays, switch-clients, board-memo pyramid, runbook handoff. |
 
 ## The CLI works without ANY model
 
@@ -107,4 +107,4 @@ ollama run my-fde-model --system "$(cat skills/fde/SKILL.md)"
 - **Context window matters.** SKILL.md + references can be large. Use a model with at least 8K context; 32K+ is ideal for loading skill references on demand.
 - **Temperature 0.2-0.4 works best.** The methodology is structured - lower temperature keeps routing accurate and artifacts consistent.
 - **Use the CLI for mechanics.** Don't ask the model to do what the CLI already does deterministically. Use `fde scan` for repo recon, `fde log` for memory writes, `fde receipts` for searching. Let the model handle judgment, routing, and artifact drafting.
-- **Explicit skill invocation.** If a smaller model struggles with routing, you can invoke skills directly: "@fde run the discover phase" or "@fde use scope-defense." The model skips routing and goes straight to the method.
+- **Explicit skill invocation.** If a smaller model struggles with routing, you can invoke skills directly: "@fde run the discover phase" or "@fde use hold-scope." The model skips routing and goes straight to the method.

package/adapters/README.md

@@ -31,4 +31,4 @@ Defaults to the current directory if no path is given. Existing files are never
 
 ## The principle
 
-The adapter only tells the tool **where the brain is and how to behave**. All 31 skills, the overlays, and the memory contract live once in `skills/fde/SKILL.md`. Update the brain, every platform gets it. That's why fdeops feels native in whatever the FDE already uses, without five things to keep in sync.
+The adapter only tells the tool **where the brain is and how to behave**. All 30 skills, the overlays, and the memory contract live once in `skills/fde/SKILL.md`. Update the brain, every platform gets it. That's why fdeops feels native in whatever the FDE already uses, without five things to keep in sync.

package/adapters/copilot-instructions.md

@@ -6,7 +6,7 @@ You are the AI coding agent for a **Forward Deployed Engineer (FDE)** - the huma
 
 When the FDE types **`@fde`**, names a client, pastes meeting notes, asks what was agreed, or describes embed work (quiet sponsor, brief feels wrong, Friday update) - load the skill. If `fde resume` says NO ENGAGEMENT: ask the client name once, then **you** run `fde resume --init <slug>`. Never tell them to type it.
 
-Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client, stay on `@fde` for POC, slices, characterisation, on-site proof, eval, and go-live.
+Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client, stay on `@fde` for POC, small PRs, characterisation, proof on their staging, eval, and go-live.
 
 - Skill (single source of truth): `~/.claude/skills/fde/SKILL.md`
 - **Never ask the FDE to pick a skill.** Read the situation, route silently, do the work.

package/adapters/cursor.fde.mdc

@@ -11,7 +11,7 @@ You are the AI coding agent for a **Forward Deployed Engineer (FDE)** - the huma
 
 When the FDE types **`@fde`**, names a client, pastes meeting notes, asks what was agreed, or describes embed work (quiet sponsor, brief feels wrong, Friday update) - load `@fde`. If `fde resume` says NO ENGAGEMENT: ask the client name once, then **you** run `fde resume --init <slug>`. Never tell them to type it.
 
-Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client, stay on `@fde` for POC, slices, characterisation, on-site proof, eval, and go-live.
+Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client, stay on `@fde` for POC, small PRs, characterisation, proof on their staging, eval, and go-live.
 
 - Skill (single source of truth): `~/.claude/skills/fde/SKILL.md` (or the copy this install placed)
 - **Never ask the FDE to pick a skill.** Read the situation, route silently, do the work.

package/bin/check.js

@@ -63,8 +63,8 @@ if (fs.existsSync(path.join(root, 'skills', 'fde', 'archive'))) {
 // v3: one skill + phase references (progressive disclosure)
 const requiredReferences = [
   'land.md', 'discover.md', 'audit.md', 'plan.md', 'review.md',
-  'rescue.md', 'ship.md', 'sketch.md', 'close.md', 'dashboard.md',
-  'debrief.md', 'status.md', 'demo-prep.md',
+  'rescue.md', 'ship.md', 'poc.md', 'close.md', 'dashboard.md',
+  'debrief.md', 'readout.md', 'demo-prep.md',
   'healthcare.md', 'fintech.md', 'gov.md',
   'ai.md', 'eval-pack.md',
 ]
@@ -84,8 +84,8 @@ ok('phase references')
 // file the work lands in. Prose-only guidance drifts into advice nobody can apply.
 const exampleReferences = [
   'land.md', 'discover.md', 'plan.md', 'ship.md', 'close.md',
-  'status.md', 'stakeholder-radar.md', 'options-analysis.md', 'business-case.md',
-  'assumption-audit.md', 'scope-defense.md',
+  'readout.md', 'who-decides.md', 'three-options.md', 'business-case.md',
+  'test-assumptions.md', 'hold-scope.md',
 ]
 for (const f of exampleReferences) {
   const p = path.join(root, 'skills', 'fde', 'references', f)
@@ -115,7 +115,7 @@ for (const refFile of mentioned) {
 ok(`router dispatch (${mentioned.length} reference targets verified) + memory contract`)
 
 // Public claims must match the router. The docs advertise a method count and a
-// per-domain list; both drifted from SKILL.md once (ingest / ingest-connect
+// per-domain list; both drifted from SKILL.md once (ingest / connect
 // routed but undocumented), and a number nobody can verify is worse than none.
 {
   // Every routing row must parse. A row this misses is a method that could go
@@ -186,7 +186,7 @@ ok(`router dispatch (${mentioned.length} reference targets verified) + memory co
   }
   for (const rel of ['docs/skills.md', 'docs/skills-reference.md']) {
     const body = read(rel)
-    // `-` is a word boundary, so \bingest\b matches inside `ingest-connect`:
+    // `-` is a word boundary, so \bscore\b matches inside `score-use-cases`:
     // a method could disappear from the docs behind a hyphenated sibling.
     const absent = [...documented].filter(name => !new RegExp(`(?<![\\w-])${name}(?![\\w-])`).test(body))
     if (absent.length) fail(`${rel} does not list skill(s): ${absent.join(', ')}`)
@@ -203,6 +203,14 @@ ok(`router dispatch (${mentioned.length} reference targets verified) + memory co
   const extra = fs.readdirSync(refDir).filter(f => f.endsWith('.md') && !mentioned.includes(f))
   if (extra.length) fail(`unrouted reference file(s) - dead method: ${extra.join(', ')}`)
   else ok('no unrouted reference files')
+
+  // The on-site change loop lives in ship.md. A sibling method is a split.
+  for (const dead of ['small-prs.md', 'thin-slices.md', 'implement.md']) {
+    if (fs.existsSync(path.join(refDir, dead))) {
+      fail(`${dead} must not exist - that craft lives in ship.md`)
+    }
+  }
+  ok('ship is one method (no implement / small-prs / thin-slices sibling)')
 }
 
 const install = read('bin/install.js')
@@ -221,8 +229,10 @@ if (read('package.json').includes('postinstall')) {
 }
 
 const readme = read('README.md')
-if (/session\.gif|demo\.gif|<img /i.test(readme)) {
-  fail('README must not embed images - front door is text; the recording lives in docs/USAGE.md')
+if (/session\.gif|demo\.gif/i.test(readme)) {
+  fail('README must not embed session.gif or demo.gif - the recording lives in docs/USAGE.md')
+} else if (/<img /i.test(readme) && !/user-attachments\/assets/.test(readme)) {
+  fail('README <img> must be the GitHub poster (user-attachments), not a local gif')
 } else ok('README is text (no gif)')
 
 const usage = read('docs/USAGE.md')
@@ -262,15 +272,17 @@ if (!readme.includes('AI coding agent')) {
 }
 ok('README clarity sections')
 
-for (const cmd of ['/brief', '/discover', '/plan', '/ship', '/outcome', '/close', '/debrief', '/prep', '/quiet', '/agreed', '/status']) {
+for (const cmd of ['/brief', '/discover', '/plan', '/ship', '/outcome', '/close', '/debrief', '/prep', '/trust', '/receipts', '/readout']) {
   if (!readme.includes(cmd)) fail(`README must document slash command ${cmd}`)
 }
 if (/(^|[^\w/])\/got\b/.test(readme)) fail('README must use /outcome, not /got')
 ok('README slash commands documented')
 
-// Front-door map is the embed left-to-right (LAND → CLOSE), not a pile of situations.
-if (!readme.slice(0, 4000).includes('LAND') || !readme.slice(0, 4000).includes('/discover')) {
-  fail('README must include the LAND→CLOSE command-map diagram near the top')
+// Front-door map is the embed left-to-right (Land → Close). After the GitHub
+// poster (#68) the table is the map: /brief /discover /plan /ship /outcome /close.
+const front = readme.slice(0, 4000)
+if (!['/brief', '/discover', '/plan', '/ship', '/outcome', '/close'].every(c => front.includes(c))) {
+  fail('README must include the Land→Close command map near the top')
 } else ok('README command-map diagram')
 
 if (readme.includes('your-client-repo')) {
@@ -536,7 +548,7 @@ if (pkg.version !== plugin.version) {
 if (plugin.commands !== './.claude/commands' || plugin.skills !== './skills') {
   fail('.claude-plugin/plugin.json must declare skills and commands')
 } else {
-  for (const cmd of ['brief', 'discover', 'plan', 'ship', 'outcome', 'close', 'debrief', 'prep', 'quiet', 'agreed', 'status']) {
+  for (const cmd of ['brief', 'discover', 'plan', 'ship', 'outcome', 'close', 'debrief', 'prep', 'trust', 'receipts', 'readout']) {
     const rel = `.claude/commands/${cmd}.md`
     if (!fs.existsSync(path.join(root, rel))) fail(`${rel} missing`)
     else if (!read(rel).includes('@fde')) fail(`${rel} must load @fde`)
@@ -550,8 +562,8 @@ if (!fs.existsSync(path.join(root, 'mcp', 'fdeops-ingest', 'server.js'))) {
   fail('ingest MCP must expose ingest_stage')
 } else if (!read('skills/fde/references/ingest.md').includes('stage')) {
   fail('skills/fde/references/ingest.md missing stage contract')
-} else if (!fs.existsSync(path.join(root, 'skills', 'fde', 'references', 'ingest-connect.md'))) {
-  fail('skills/fde/references/ingest-connect.md missing')
+} else if (!fs.existsSync(path.join(root, 'skills', 'fde', 'references', 'connect.md'))) {
+  fail('skills/fde/references/connect.md missing')
 } else {
   for (const recipe of ['file.md', 'granola.md', 'slack.md', 'notion.md']) {
     if (!fs.existsSync(path.join(root, 'mcp', 'recipes', recipe))) fail(`mcp/recipes/${recipe} missing`)