fdeops 5.1.8 → 5.1.10

package/README.md

@@ -52,8 +52,13 @@ Separate decisions, requests and open questions. Return a draft only.
 
 No customer record is needed for this draft. Each task includes its required instructions; you do not need to install `fde` or another pack.
 
+<details>
+<summary>Installation requirements and alternatives</summary>
+
 These installation commands use Node.js and Git; the optional record CLI requires Node.js 18+. See [installation and upgrades](docs/install.md) for host-specific invocation, the full pack and alternatives. Installing `fde` includes all underlying instructions, but does not add the 35 separate task names to your agent's menu.
 
+</details>
+
 **Try it with fictional data:** `npx fdeops demo` runs sample notes through review and creates a fieldbook without calling an AI model. It requires Node.js 18+ and Git, may download the package, and creates or resets only its separate `.demo` workspace. [Five-minute walkthrough](docs/USAGE.md#new-here-5-minutes).
 
 ## Three things it helps with
@@ -67,6 +72,15 @@ A repository tells you where the code lives. It may not tell you why the custome
 
 For an ongoing engagement, FDEOps keeps a separate plain-Markdown record at `~/fde-engagements/<customer>/.fde/`. The coordinator retrieves a bounded summary and looks up details when needed. A saved implementation checkpoint points back to the current task record; the agent checks it before continuing.
 
+For example, the fictional demo's `fde resume` output includes these next actions (excerpt):
+
+```text
+next: get the reconciliation runbook from Tom before touching anything. [source: meeting 2026-09-10]
+do first: Ask the acceptance owner to review the reported result and its evidence (delivery.md: 1 reported result awaiting acceptance)
+```
+
+The next session can pick up the work while keeping acceptance pending.
+
 Use [debrief](skills/debrief/SKILL.md) after a meeting and [switch-clients](skills/switch-clients/SKILL.md) when changing customers. [How records work](docs/USAGE.md).
 
 ### 2. Keeping a request from becoming an agreement
@@ -94,6 +108,16 @@ This is a draft, not a saved agreement. Use [who-decides](skills/who-decides/SKI
 
 A local test, a deployed change and a customer-accepted result answer different questions.
 
+| Claim | Evidence it needs |
+|---|---|
+| Implemented | The change exists in the identified revision |
+| Verified | Applicable checks passed under stated conditions |
+| Deployed | The intended environment is running the change |
+| Measured | A result was observed against the agreed measure |
+| Accepted | The agreed owner or mechanism accepted the outcome |
+
+These are separate claims, not five automatic dashboard states.
+
 FDEOps carries the agreed checks into implementation and binds verification to the relevant revision and environment. Release guidance asks for operating limits, recovery evidence and an owner. Missing access or evidence stays visible; a passing local test does not fill that gap.
 
 Use [build](skills/build/SKILL.md), [integrate](skills/integrate/SKILL.md), [review](skills/review/SKILL.md), [ship](skills/ship/SKILL.md) and [handoff](skills/handoff/SKILL.md) as needed. [See the tests and their limits](docs/verification.md).

package/adapters/AGENTS.md

@@ -16,7 +16,7 @@ Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client
 
 Read and write engagement files under the workspace's bound engagement: follow the skill’s entry rule to resolve it (binding created once with `fde resume --init <name>`; default `~/fde-engagements/<name>/.fde/`). `FDEOPS_ENGAGEMENT` (expand `~`) overrides when set. Use `./.fde/` only when the engagement approves it and it is gitignored.
 
-Follow **First-use preferences** and **Entry (every session)** in `skills/fde/SKILL.md` for setup, context reuse and refresh. Use the CLI for deterministic work - `fde scan | log | receipts | status | dashboard` - instead of improvising shell.
+Follow **Entry (every session)** in `skills/fde/SKILL.md` for setup, context reuse and refresh. Use the CLI for deterministic work - `fde scan | log | receipts | status | dashboard` - instead of improvising shell.
 
 ## Voice
 

package/adapters/GEMINI.md

@@ -16,7 +16,7 @@ Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client
 
 Read and write engagement files under the workspace's bound engagement: follow the skill’s entry rule to resolve it (binding created once with `fde resume --init <name>`; default `~/fde-engagements/<name>/.fde/`). `FDEOPS_ENGAGEMENT` (expand `~`) overrides when set. Use `./.fde/` only when the engagement approves it and it is gitignored.
 
-Follow **First-use preferences** and **Entry (every session)** in `skills/fde/SKILL.md` for setup, context reuse and refresh. Use the CLI for deterministic work - `fde scan | log | receipts | status | dashboard` - instead of improvising shell.
+Follow **Entry (every session)** in `skills/fde/SKILL.md` for setup, context reuse and refresh. Use the CLI for deterministic work - `fde scan | log | receipts | status | dashboard` - instead of improvising shell.
 
 ## Voice
 

package/adapters/LOCAL-LLM.md

@@ -7,7 +7,7 @@ The FDEOps CLI and offline dashboard need Node.js and Git, not a model. AI-assis
 1. Download FDEOps, your agent host and your model while online. After that, the CLI operates offline. Model/provider configuration belongs to the host; FDEOps does not start or configure an inference server.
 2. From the client workspace, run `node /path/to/fdeops/bin/fde.js resume --init my-client` to create and bind a local record.
 3. Make `skills/fde/SKILL.md` and its references available to the host. Use the host's documented skill/file mechanism. Give it the FDEOps CLI path and permission to read the bound record and execute the requested commands.
-4. Follow **First-use preferences** and **Entry (every session)** in `skills/fde/SKILL.md`, then ask for the next action. Inspect the tool calls, cited records and any proposed writes before trusting the workflow.
+4. Follow **Entry (every session)** in `skills/fde/SKILL.md`, then ask for the next action. Inspect the tool calls, cited records and any proposed writes before trusting the workflow.
 
 Use `fde recall <topic>` for relevant evidence. `resume` and `recall` default to a 16 KiB output ceiling; `--max-bytes 4096` requests a smaller allowance. This limits FDEOps output, not the host's entire context window. Keep unrelated transcripts and tools out of the active context. Private blocks must stay out of direct file reads as well as prompts.
 

package/adapters/README.md

@@ -13,7 +13,7 @@
 | Gemini CLI | `GEMINI.md` | `GEMINI.md` |
 | Cursor | `.cursor/rules/fde.mdc` | `cursor.fde.mdc` |
 | GitHub Copilot | `.github/copilot-instructions.md` | `copilot-instructions.md` |
-| Local LLMs (Ollama, LM Studio, llama.cpp, vLLM) | Load `SKILL.md` as system prompt | [`LOCAL-LLM.md`](LOCAL-LLM.md) (guide) |
+| Local LLMs (Ollama, LM Studio, llama.cpp, vLLM) | Capable agent host with `SKILL.md`, its references, and approved CLI access | [`LOCAL-LLM.md`](LOCAL-LLM.md) (guide) |
 
 `AGENTS.md` is the emerging cross-tool standard - many agents read it, so it doubles as the universal fallback. For local/self-hosted models, see [`LOCAL-LLM.md`](LOCAL-LLM.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 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.
+The adapter only tells the tool **where the brain is and how to behave**. The 35 task methods and supporting guidance live in `skills/fde/references/`; `skills/fde/SKILL.md` coordinates them and the memory contract. 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

@@ -16,7 +16,7 @@ Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client
 
 Read and write engagement files under the workspace's bound engagement: follow the skill’s entry rule to resolve it (binding created once with `fde resume --init <name>`; default `~/fde-engagements/<name>/.fde/`). `FDEOPS_ENGAGEMENT` (expand `~`) overrides when set. Use `./.fde/` only when the engagement approves it and it is gitignored.
 
-Follow **First-use preferences** and **Entry (every session)** in `skills/fde/SKILL.md` for setup, context reuse and refresh. Use the CLI for deterministic work - `fde scan | log | receipts | status | dashboard` - instead of improvising shell.
+Follow **Entry (every session)** in `skills/fde/SKILL.md` for setup, context reuse and refresh. Use the CLI for deterministic work - `fde scan | log | receipts | status | dashboard` - instead of improvising shell.
 
 ## Voice
 

package/adapters/cursor.fde.mdc

@@ -21,7 +21,7 @@ Do **not** load `@fde` for a one-line typo in an unbound repo. On a bound client
 
 Read and write engagement files under the workspace's bound engagement: follow the skill’s entry rule to resolve it (binding created once with `fde resume --init <name>`; default `~/fde-engagements/<name>/.fde/`). `FDEOPS_ENGAGEMENT` (expand `~`) overrides when set. Use `./.fde/` only when the engagement approves it and it is gitignored.
 
-Follow **First-use preferences** and **Entry (every session)** in `skills/fde/SKILL.md` for setup, context reuse and refresh. The entry packet includes TRIAGE; use it for trust, phase, open risks and next action. Do not invent stakeholders or status.
+Follow **Entry (every session)** in `skills/fde/SKILL.md` for setup, context reuse and refresh. The entry packet includes TRIAGE; use it for trust, phase, open risks and next action. Do not invent stakeholders or status.
 
 You run the CLI for deterministic work - `fde scan | log | debrief | prep | doctor | receipts | status | dashboard` - instead of improvising shell or handing commands to the human.
 

package/bin/generate-skills.js

@@ -4,6 +4,7 @@ const fs = require('node:fs')
 const path = require('node:path')
 const { createHash } = require('node:crypto')
 const catalog = require('./skill-catalog')
+const { interfaceYaml } = require('./skill-ui')
 const root = path.resolve(__dirname, '..')
 const source = path.join(root, 'skills/fde/references')
 
@@ -44,6 +45,8 @@ function entrypoint(item) {
 }
 function expectedFiles(item, referenceRoot = source) {
   const files = new Map([['SKILL.md', entrypoint(item)]])
+  const ui = interfaceYaml(item.name, item.ui)
+  if (ui) files.set('agents/openai.yaml', ui)
   for (const ref of referencesFor(item.method, referenceRoot)) files.set(`references/${ref}`, fs.readFileSync(path.join(referenceRoot, ref), 'utf8'))
   return files
 }
@@ -59,7 +62,7 @@ function walk(dir, prefix = '') {
     const rel = prefix + e.name
     if (e.isSymbolicLink() || (!e.isDirectory() && !e.isFile()) || (e.isFile() && fs.lstatSync(path.join(dir, e.name)).nlink > 1)) throw new Error(`Unsafe generated path: ${path.join(dir, e.name)}`)
     if (e.isDirectory()) {
-      if (rel !== 'references') throw new Error(`Unowned generated directory: ${path.join(dir, e.name)}`)
+      if (rel !== 'references' && rel !== 'agents') throw new Error(`Unowned generated directory: ${path.join(dir, e.name)}`)
       entries.push(...walk(path.join(dir, e.name), rel + '/'))
     } else entries.push(rel)
   }
@@ -103,7 +106,7 @@ function generate(check = false, options = {}) {
         if (manifest.generator !== 'bin/generate-skills.js' || manifest.version !== 1 || !manifest.files || Array.isArray(manifest.files) || typeof manifest.files !== 'object') throw new Error(`Invalid ownership manifest: ${name}`)
         owned = manifest.files
         for (const [rel, hash] of Object.entries(owned)) {
-          if (!/^(?:SKILL\.md|references\/[a-z][a-z-]*\.md)$/.test(rel) || !/^[a-f0-9]{64}$/.test(hash)) throw new Error(`Invalid ownership entry: ${name}/${rel}`)
+          if (!/^(?:SKILL\.md|agents\/openai\.yaml|references\/[a-z][a-z-]*\.md)$/.test(rel) || !/^[a-f0-9]{64}$/.test(hash)) throw new Error(`Invalid ownership entry: ${name}/${rel}`)
         }
       } else {
         // Migrate 4.1.0 packages conservatively: only the marked entry and exact
@@ -138,11 +141,11 @@ function generate(check = false, options = {}) {
       fs.mkdirSync(path.dirname(path.join(dest, rel)), { recursive: true })
       fs.writeFileSync(path.join(dest, rel), body)
     }
-    if (!output.size) {
-      const refs = path.join(dest, 'references')
-      if (stat(refs)) fs.rmdirSync(refs)
-      fs.rmdirSync(dest)
+    for (const directory of ['references', 'agents']) {
+      const target = path.join(dest, directory)
+      if (stat(target)?.isDirectory() && fs.readdirSync(target).length === 0) fs.rmdirSync(target)
     }
+    if (!output.size) fs.rmdirSync(dest)
   }
 }
 module.exports = { referencesFor, expectedFiles, generate }

package/bin/skill-catalog.js

@@ -116,7 +116,7 @@ module.exports = [
   {
     "name": "build",
     "method": "build",
-    "description": "Implement a scoped customer-facing software change in the existing repository and verify its behavior. Use for delivery work with an understood outcome, not incident response.",
+    "description": "Implement a scoped software change for a customer and verify its behavior. Use for delivery work with an understood outcome, not incident response.",
     "group": "Build and verify",
     "result": "An implemented change with verification evidence.",
     "inputMode": "context"
@@ -132,7 +132,7 @@ module.exports = [
   {
     "name": "debug",
     "method": "debug",
-    "description": "Investigate and repair a reproducible failure in a customer integration or application. Use for diagnosis and regression prevention; follow incident authority for live mitigation.",
+    "description": "Investigate a failure, regression or incorrect result in an integration or application, even before it can be reproduced. Use for diagnosis and repair; follow incident authority for live mitigation.",
     "group": "Build and verify",
     "result": "A diagnosed failure, repair and regression evidence.",
     "inputMode": "context"

package/bin/skill-ui.js

@@ -0,0 +1,47 @@
+// Optional host UI metadata. Task routing and methods live in skill-catalog.js.
+const entries = {
+  brief: ['Customer Brief', 'Clarify the outcome, constraints, and evidence', 'clarify this customer brief and its open questions'],
+  audit: ['Engagement Audit', 'Check inherited claims against delivery evidence', 'audit this inherited engagement and its risks'],
+  'who-decides': ['Who Decides', 'Map stakeholders and decision ownership', 'map the stakeholders and decision rights for this work'],
+  'earn-trust': ['Earn Trust', 'Plan credible next steps and appropriate access', 'plan how to earn trust and appropriate customer access'],
+  discover: ['Discover', 'Trace the workflow and identify the real problem', 'trace this customer workflow and identify evidence gaps'],
+  'test-assumptions': ['Test Assumptions', 'Find consequential assumptions and test them', 'identify and test the assumptions behind this proposal'],
+  'score-use-cases': ['Score Use Cases', 'Compare customer use cases and their trade-offs', 'compare these customer use cases using the available evidence'],
+  poc: ['Proof of Concept', 'Test a delivery uncertainty with a bounded pilot', 'design a bounded proof of concept for this uncertainty'],
+  scope: ['Scope', 'Assess new requests against agreed commitments', 'assess this request against the agreed scope'],
+  options: ['Delivery Options', 'Compare feasible approaches to a customer problem', 'compare feasible approaches and recommend a delivery path'],
+  plan: ['Delivery Plan', 'Sequence delivery into verifiable increments', 'turn this agreed outcome into a sequenced delivery plan'],
+  'business-case': ['Business Case', 'Connect investment decisions to costs and evidence', 'develop a business case with explicit assumptions'],
+  prioritize: ['Prioritize', 'Choose immediate priorities and explicit deferrals', 'choose the immediate priorities from this competing work'],
+  'red-team': ['Red Team', 'Challenge a plan with evidence and failure modes', 'stress-test this plan and identify corrective actions'],
+  build: ['Build', 'Implement and verify an agreed software change', 'implement this scoped change and verify the agreed behavior'],
+  integrate: ['Integrate', 'Prove system connections and failure handling', 'implement this integration and verify its downstream result'],
+  debug: ['Debug', 'Investigate failures and verify the repair', 'investigate this failure using the available evidence'],
+  review: ['Code Review', 'Review a change for delivery and operational risks', 'review this change against its outcome and operational risks'],
+  evaluate: ['Evaluate AI', 'Measure AI workflow behavior and failure modes', 'evaluate this AI workflow using representative cases'],
+  qa: ['Journey QA', 'Verify the real customer journey and its results', 'exercise the changed customer journey and report evidence'],
+  'what-breaks': ['What Breaks', 'Assess the blast radius before changing a system', 'assess the impact of this change on dependent systems'],
+  rollback: ['Rollback', 'Rehearse recovery and expose remaining gaps', 'prepare a recovery drill within the permitted environment'],
+  ship: ['Ship', 'Prepare a controlled release with recovery evidence', 'prepare this increment for an authorized release'],
+  readout: ['Sponsor Readout', 'Separate promises, measured results, and acceptance', 'prepare a sponsor readout from the delivery evidence'],
+  'demo-prep': ['Demo Prep', 'Rehearse an evidenced demo with a fallback', 'prepare a customer demo and its failure fallback'],
+  debrief: ['Meeting Debrief', 'Extract sourced decisions and next actions', 'turn these meeting notes into sourced decisions and actions'],
+  'board-memo': ['Board Memo', 'Draft an executive account of outcomes and risks', 'draft an executive memo from the engagement evidence'],
+  rescue: ['Rescue', 'Triage urgent delivery and engagement failures', 'triage this failing engagement and identify recovery steps'],
+  dashboard: ['Engagement Dashboard', 'Review status across existing engagement records', 'review the portfolio using available engagement records'],
+  'switch-clients': ['Switch Clients', 'Refresh customer context and triage competing needs', 'switch to the requested engagement and refresh its context'],
+  runbook: ['Operating Runbook', 'Document verified operations and recovery steps', 'draft an operating runbook from these verified procedures'],
+  handoff: ['Handoff', 'Transfer operation with evidence and clear ownership', 'prepare an operating handoff with evidence and ownership'],
+  feedback: ['Field Feedback', 'Assess field lessons for safe and useful reuse', 'assess this field lesson for reuse or product feedback'],
+  connect: ['Connect a Source', 'Check source setup and available host capabilities', 'check the requested source connection and available capabilities'],
+  ingest: ['Ingest Notes', 'Prepare sourced engagement updates for review', 'prepare sourced engagement updates from this requested material'],
+}
+
+function interfaceYaml(name, fields = entries[name]) {
+  if (!fields) return null
+  const [displayName, shortDescription, prompt] = fields
+  if (typeof displayName !== 'string' || !displayName.trim() || typeof shortDescription !== 'string' || shortDescription.length < 25 || shortDescription.length > 64 || typeof prompt !== 'string' || !prompt.trim()) throw new Error(`Invalid skill UI metadata: ${name}`)
+  // JSON string literals are also YAML double-quoted scalars; no parser dependency.
+  return `interface:\n  display_name: ${JSON.stringify(displayName)}\n  short_description: ${JSON.stringify(shortDescription)}\n  default_prompt: ${JSON.stringify(`Use $${name} to ${prompt}.`)}\n`
+}
+module.exports = { entries, interfaceYaml }

package/mcp/fdeops-ingest/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fdeops-ingest-mcp",
-  "version": "5.1.8",
+  "version": "5.1.10",
   "private": true,
   "description": "Thin stdio MCP sink for FDEOps ingest (stage \u2192 propose \u2192 apply). Zero runtime dependencies.",
   "bin": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fdeops",
-  "version": "5.1.8",
+  "version": "5.1.10",
   "description": "Forward deployed engineering skills for AI coding agents. Use focused task skills or @fde for discovery, implementation, verification and handoff, with local engagement records.",
   "bin": {
     "fdeops": "bin/install.js",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "fdeops",
-  "version": "5.1.8",
+  "version": "5.1.10",
   "description": "Forward deployed engineering skills for AI coding agents. Use focused task skills or @fde for discovery, implementation, verification and handoff, with local engagement records.",
   "author": {
     "name": "Subash Natarajan",

package/skills/audit/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "b0dee139ba4f681a61eb0c3d8c802f06857502fd479843edb8e3b8cb27229ae5",
+    "agents/openai.yaml": "3b08e2e6a4149545da08238463955501bc60b7bf628cf4e344e893330590bbde",
     "references/audit.md": "ed32ea78cbccb100742dd838e8cf4cd4b6f33ad44b3de7424fc624670d571dbc",
     "references/discover.md": "f65aa11a539b4dbbed70cfaa94ec2a35595aa9a2d0282790510b933ac9c721ce",
     "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"

package/skills/audit/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Engagement Audit"
+  short_description: "Check inherited claims against delivery evidence"
+  default_prompt: "Use $audit to audit this inherited engagement and its risks."

package/skills/board-memo/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "5782488d9878335cdc1db68c08eccd613486370164284ff11d93422eced6423a",
+    "agents/openai.yaml": "a3ce2dc79d3732da6c9aa2d45d09541c09c8f7bdf44f34c6603b5dbaf8624095",
     "references/board-memo.md": "44eb3c27f164da63af694591025b3fc96bb23d149c29de400997c1653e3322f8",
     "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25",
     "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"

package/skills/board-memo/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Board Memo"
+  short_description: "Draft an executive account of outcomes and risks"
+  default_prompt: "Use $board-memo to draft an executive memo from the engagement evidence."

package/skills/brief/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "5d88b9818951f8a8a44c39ad2b36ccdca74fef5e6ed31e67788b50d3ca1bb006",
+    "agents/openai.yaml": "8dc0b43545004419bad49e1d50cd3beb968bbcc24baacdaf7fb7304a5fd03bba",
     "references/land.md": "7a82ac999d23b51b602cd815777a853c4879ca8be40dc6c84c66f154d1f77951",
     "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
   }

package/skills/brief/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Customer Brief"
+  short_description: "Clarify the outcome, constraints, and evidence"
+  default_prompt: "Use $brief to clarify this customer brief and its open questions."

package/skills/build/.fde-generated.json

@@ -2,7 +2,8 @@
   "generator": "bin/generate-skills.js",
   "version": 1,
   "files": {
-    "SKILL.md": "245c53b404549ed73fd6ef532e48c002de7d20a6a93eaca6c0714c4e4d14ba92",
+    "SKILL.md": "77570e69b8d708d60cd6ab1dcc79c95a75824ab668f60a83a0dedbe668de2a70",
+    "agents/openai.yaml": "abd0a33ab4efa25ea038932d37eae2faa2527baa96ebae8732ea90f1ebc3865e",
     "references/build.md": "03c52eda90642c62053b53ef1e85c97b4e647600f454aee9da0e415c9d98903e",
     "references/debug.md": "3273a921a98522431ae821a283814897270c719cbfab83d14b99175537d869e5",
     "references/eval-pack.md": "0590b85d3cae0903c6b1274540c92eaa2a4373047e8a0548d6942516ef0bb9e1",

package/skills/build/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: build
-description: Implement a scoped customer-facing software change in the existing repository and verify its behavior. Use for delivery work with an understood outcome, not incident response.
+description: Implement a scoped software change for a customer and verify its behavior. Use for delivery work with an understood outcome, not incident response.
 ---
 
 # build
@@ -9,7 +9,7 @@ description: Implement a scoped customer-facing software change in the existing
 
 ## Purpose
 
-Implement a scoped customer-facing software change in the existing repository and verify its behavior. Use for delivery work with an understood outcome, not incident response.
+Implement a scoped software change for a customer and verify its behavior. Use for delivery work with an understood outcome, not incident response.
 
 Before investigating or acting:
 1. Read [the task context contract](references/task-context.md).

package/skills/build/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Build"
+  short_description: "Implement and verify an agreed software change"
+  default_prompt: "Use $build to implement this scoped change and verify the agreed behavior."

package/skills/business-case/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "1105f7e78b5e73e54aafb8150e03be8c3ccd3443bc3ae667555763a839c1abe4",
+    "agents/openai.yaml": "dd2676346caea1b53ae2bee6662aea064eea74c8ca6edf721382526f5fc42ef5",
     "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25",
     "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
   }

package/skills/business-case/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Business Case"
+  short_description: "Connect investment decisions to costs and evidence"
+  default_prompt: "Use $business-case to develop a business case with explicit assumptions."

package/skills/connect/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "1bfb43ee4b7d5633d8ce996d4ce3c12a75df09e9bb8457ab35597f48f85b2beb",
+    "agents/openai.yaml": "6be7812fcf2f56c9fc52b3fd0f0899e3a93a7ee482a901c48b6422e71f326fed",
     "references/connect.md": "37ad703ece7fe3596be4d5d3697cc4ba5e6062615f9576733c20d055fc3e4927",
     "references/debrief.md": "2d2db9a177f5341a9a2721a9d6ea32a6d07e7e982e621429ca408a38bc5617c1",
     "references/ingest.md": "24880bc3d95cda09ec6c2f5edebd17fba99deb912f93e15c8b715a287283da84",

package/skills/connect/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Connect a Source"
+  short_description: "Check source setup and available host capabilities"
+  default_prompt: "Use $connect to check the requested source connection and available capabilities."

package/skills/dashboard/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "e06df3f2da2586c14e12f2599091231083c0a2f43af70b427c0ab307641610a3",
+    "agents/openai.yaml": "abbfc923f66cea302d6fb06b02ff5d2a9f9faa24f30904344785abab1e627999",
     "references/dashboard.md": "dd842c17a2689a6017fecf34a6a24ee5cd40f504af4397eaeb2493ef4ffceda0",
     "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
   }

package/skills/dashboard/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Engagement Dashboard"
+  short_description: "Review status across existing engagement records"
+  default_prompt: "Use $dashboard to review the portfolio using available engagement records."

package/skills/debrief/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "f17036d3f4494abf5505a408d23d2b6fb5e7b34e2bc1217eb5f3603fcef1e5e5",
+    "agents/openai.yaml": "b56f5462c41c09ff1ff3022ed13ebf43749bee3c0578e32d5853d2580998939c",
     "references/connect.md": "37ad703ece7fe3596be4d5d3697cc4ba5e6062615f9576733c20d055fc3e4927",
     "references/debrief.md": "2d2db9a177f5341a9a2721a9d6ea32a6d07e7e982e621429ca408a38bc5617c1",
     "references/ingest.md": "24880bc3d95cda09ec6c2f5edebd17fba99deb912f93e15c8b715a287283da84",

package/skills/debrief/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Meeting Debrief"
+  short_description: "Extract sourced decisions and next actions"
+  default_prompt: "Use $debrief to turn these meeting notes into sourced decisions and actions."

package/skills/debug/.fde-generated.json

@@ -2,7 +2,8 @@
   "generator": "bin/generate-skills.js",
   "version": 1,
   "files": {
-    "SKILL.md": "4a5cb9e98910f043bd8f4482540fd68387b45878946379514d4d581cc813c61f",
+    "SKILL.md": "00b6f8c7c56be7a665f9401c58319fc4cd344e1c865d88021c116d94149a4a35",
+    "agents/openai.yaml": "f9178e65a1e2e9ee27f2f5917a36a50e3ebe64bd6e331b43379efcf1c7d5aac3",
     "references/build.md": "03c52eda90642c62053b53ef1e85c97b4e647600f454aee9da0e415c9d98903e",
     "references/debug.md": "3273a921a98522431ae821a283814897270c719cbfab83d14b99175537d869e5",
     "references/eval-pack.md": "0590b85d3cae0903c6b1274540c92eaa2a4373047e8a0548d6942516ef0bb9e1",

package/skills/debug/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: debug
-description: Investigate and repair a reproducible failure in a customer integration or application. Use for diagnosis and regression prevention; follow incident authority for live mitigation.
+description: Investigate a failure, regression or incorrect result in an integration or application, even before it can be reproduced. Use for diagnosis and repair; follow incident authority for live mitigation.
 ---
 
 # debug
@@ -9,7 +9,7 @@ description: Investigate and repair a reproducible failure in a customer integra
 
 ## Purpose
 
-Investigate and repair a reproducible failure in a customer integration or application. Use for diagnosis and regression prevention; follow incident authority for live mitigation.
+Investigate a failure, regression or incorrect result in an integration or application, even before it can be reproduced. Use for diagnosis and repair; follow incident authority for live mitigation.
 
 Before investigating or acting:
 1. Read [the task context contract](references/task-context.md).

package/skills/debug/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Debug"
+  short_description: "Investigate failures and verify the repair"
+  default_prompt: "Use $debug to investigate this failure using the available evidence."

package/skills/demo-prep/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "a9c477a1f2f2d44ba1893ea1299c3b30f07c772064b8c28d5bb31d87f032ef67",
+    "agents/openai.yaml": "14df03f4ac1652773b277fbe8e9c501f253dbe550b29f4df1ec0e15a9b6eb6aa",
     "references/demo-prep.md": "2166d4104c8da995ea1dbdf27e36fe288a83c6e18ff1de2650fb0eec769ec84f",
     "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
   }

package/skills/demo-prep/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Demo Prep"
+  short_description: "Rehearse an evidenced demo with a fallback"
+  default_prompt: "Use $demo-prep to prepare a customer demo and its failure fallback."

package/skills/discover/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "bed4347f467126b6aafd035b2e91c05f37ae3fe5ef6dc9fc2b1a313fce4ccd8d",
+    "agents/openai.yaml": "77306e5aa72884b8c06afe91ae4991910bf3ad38a72375c2fc5251fc7744789a",
     "references/audit.md": "ed32ea78cbccb100742dd838e8cf4cd4b6f33ad44b3de7424fc624670d571dbc",
     "references/discover.md": "f65aa11a539b4dbbed70cfaa94ec2a35595aa9a2d0282790510b933ac9c721ce",
     "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"

package/skills/discover/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Discover"
+  short_description: "Trace the workflow and identify the real problem"
+  default_prompt: "Use $discover to trace this customer workflow and identify evidence gaps."

package/skills/earn-trust/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "a739454cd58e6beba57877e8b1c0d888d1068617b63959014c7b142fd12d68c3",
+    "agents/openai.yaml": "3157721445a01f3f840106c23f775305155946669cf44d056e5eb4641f47a84d",
     "references/earn-trust.md": "ec31c339a39d9a7f3855ff77478684bc1d6cae473362489456f0c17b64c33399",
     "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
   }

package/skills/earn-trust/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Earn Trust"
+  short_description: "Plan credible next steps and appropriate access"
+  default_prompt: "Use $earn-trust to plan how to earn trust and appropriate customer access."

package/skills/evaluate/.fde-generated.json

@@ -3,6 +3,7 @@
   "version": 1,
   "files": {
     "SKILL.md": "396110a1cb9a555b4096ef77bf45e531b60d78b18bd617c654f19c8e07506ce1",
+    "agents/openai.yaml": "731f3c81d46444af542369f0aa27736d24530d00fc1aa717436ddefe3f3bdef7",
     "references/build.md": "03c52eda90642c62053b53ef1e85c97b4e647600f454aee9da0e415c9d98903e",
     "references/debug.md": "3273a921a98522431ae821a283814897270c719cbfab83d14b99175537d869e5",
     "references/eval-pack.md": "0590b85d3cae0903c6b1274540c92eaa2a4373047e8a0548d6942516ef0bb9e1",

package/skills/evaluate/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Evaluate AI"
+  short_description: "Measure AI workflow behavior and failure modes"
+  default_prompt: "Use $evaluate to evaluate this AI workflow using representative cases."

package/skills/fde/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "FDE Engagement Coordinator"
+  short_description: "Guide customer delivery with evidence and memory"
+  default_prompt: "Use $fde to identify the next useful step in this customer engagement."