fdeops 5.1.5 → 5.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/README.md +1 -1
  2. package/bin/fde.js +4 -1
  3. package/bin/generate-skills.js +1 -1
  4. package/bin/lib/context.js +36 -1
  5. package/mcp/fdeops-ingest/package.json +1 -1
  6. package/package.json +1 -1
  7. package/plugin.json +1 -1
  8. package/skills/audit/.fde-generated.json +2 -2
  9. package/skills/audit/SKILL.md +5 -1
  10. package/skills/audit/references/task-context.md +4 -0
  11. package/skills/board-memo/.fde-generated.json +2 -2
  12. package/skills/board-memo/SKILL.md +5 -1
  13. package/skills/board-memo/references/task-context.md +4 -0
  14. package/skills/brief/.fde-generated.json +2 -2
  15. package/skills/brief/SKILL.md +5 -1
  16. package/skills/brief/references/task-context.md +4 -0
  17. package/skills/build/.fde-generated.json +6 -6
  18. package/skills/build/SKILL.md +5 -1
  19. package/skills/build/references/build.md +3 -1
  20. package/skills/build/references/review.md +2 -0
  21. package/skills/build/references/ship.md +2 -2
  22. package/skills/build/references/task-context.md +4 -0
  23. package/skills/build/references/verification.md +13 -1
  24. package/skills/business-case/.fde-generated.json +2 -2
  25. package/skills/business-case/SKILL.md +5 -1
  26. package/skills/business-case/references/task-context.md +4 -0
  27. package/skills/connect/.fde-generated.json +2 -2
  28. package/skills/connect/SKILL.md +5 -1
  29. package/skills/connect/references/task-context.md +4 -0
  30. package/skills/dashboard/.fde-generated.json +2 -2
  31. package/skills/dashboard/SKILL.md +5 -1
  32. package/skills/dashboard/references/task-context.md +4 -0
  33. package/skills/debrief/.fde-generated.json +2 -2
  34. package/skills/debrief/SKILL.md +5 -1
  35. package/skills/debrief/references/task-context.md +4 -0
  36. package/skills/debug/.fde-generated.json +6 -6
  37. package/skills/debug/SKILL.md +5 -1
  38. package/skills/debug/references/build.md +3 -1
  39. package/skills/debug/references/review.md +2 -0
  40. package/skills/debug/references/ship.md +2 -2
  41. package/skills/debug/references/task-context.md +4 -0
  42. package/skills/debug/references/verification.md +13 -1
  43. package/skills/demo-prep/.fde-generated.json +2 -2
  44. package/skills/demo-prep/SKILL.md +5 -1
  45. package/skills/demo-prep/references/task-context.md +4 -0
  46. package/skills/discover/.fde-generated.json +2 -2
  47. package/skills/discover/SKILL.md +5 -1
  48. package/skills/discover/references/task-context.md +4 -0
  49. package/skills/earn-trust/.fde-generated.json +2 -2
  50. package/skills/earn-trust/SKILL.md +5 -1
  51. package/skills/earn-trust/references/task-context.md +4 -0
  52. package/skills/evaluate/.fde-generated.json +6 -6
  53. package/skills/evaluate/SKILL.md +5 -1
  54. package/skills/evaluate/references/build.md +3 -1
  55. package/skills/evaluate/references/review.md +2 -0
  56. package/skills/evaluate/references/ship.md +2 -2
  57. package/skills/evaluate/references/task-context.md +4 -0
  58. package/skills/evaluate/references/verification.md +13 -1
  59. package/skills/fde/SKILL.md +37 -96
  60. package/skills/fde/references/build.md +3 -1
  61. package/skills/fde/references/plan.md +3 -1
  62. package/skills/fde/references/record-setup.md +5 -0
  63. package/skills/fde/references/review.md +2 -0
  64. package/skills/fde/references/runbook.md +2 -0
  65. package/skills/fde/references/ship.md +2 -2
  66. package/skills/fde/references/task-context.md +4 -0
  67. package/skills/fde/references/verification.md +13 -1
  68. package/skills/feedback/.fde-generated.json +2 -2
  69. package/skills/feedback/SKILL.md +5 -1
  70. package/skills/feedback/references/task-context.md +4 -0
  71. package/skills/handoff/.fde-generated.json +2 -2
  72. package/skills/handoff/SKILL.md +5 -1
  73. package/skills/handoff/references/task-context.md +4 -0
  74. package/skills/ingest/.fde-generated.json +2 -2
  75. package/skills/ingest/SKILL.md +5 -1
  76. package/skills/ingest/references/task-context.md +4 -0
  77. package/skills/integrate/.fde-generated.json +6 -6
  78. package/skills/integrate/SKILL.md +5 -1
  79. package/skills/integrate/references/build.md +3 -1
  80. package/skills/integrate/references/review.md +2 -0
  81. package/skills/integrate/references/ship.md +2 -2
  82. package/skills/integrate/references/task-context.md +4 -0
  83. package/skills/integrate/references/verification.md +13 -1
  84. package/skills/options/.fde-generated.json +2 -2
  85. package/skills/options/SKILL.md +5 -1
  86. package/skills/options/references/task-context.md +4 -0
  87. package/skills/plan/.fde-generated.json +3 -3
  88. package/skills/plan/SKILL.md +5 -1
  89. package/skills/plan/references/plan.md +3 -1
  90. package/skills/plan/references/task-context.md +4 -0
  91. package/skills/poc/.fde-generated.json +7 -7
  92. package/skills/poc/SKILL.md +5 -1
  93. package/skills/poc/references/build.md +3 -1
  94. package/skills/poc/references/plan.md +3 -1
  95. package/skills/poc/references/review.md +2 -0
  96. package/skills/poc/references/ship.md +2 -2
  97. package/skills/poc/references/task-context.md +4 -0
  98. package/skills/poc/references/verification.md +13 -1
  99. package/skills/prioritize/.fde-generated.json +2 -2
  100. package/skills/prioritize/SKILL.md +5 -1
  101. package/skills/prioritize/references/task-context.md +4 -0
  102. package/skills/qa/.fde-generated.json +6 -6
  103. package/skills/qa/SKILL.md +5 -1
  104. package/skills/qa/references/build.md +3 -1
  105. package/skills/qa/references/review.md +2 -0
  106. package/skills/qa/references/ship.md +2 -2
  107. package/skills/qa/references/task-context.md +4 -0
  108. package/skills/qa/references/verification.md +13 -1
  109. package/skills/readout/.fde-generated.json +2 -2
  110. package/skills/readout/SKILL.md +5 -1
  111. package/skills/readout/references/task-context.md +4 -0
  112. package/skills/red-team/.fde-generated.json +2 -2
  113. package/skills/red-team/SKILL.md +5 -1
  114. package/skills/red-team/references/task-context.md +4 -0
  115. package/skills/rescue/.fde-generated.json +2 -2
  116. package/skills/rescue/SKILL.md +5 -1
  117. package/skills/rescue/references/task-context.md +4 -0
  118. package/skills/review/.fde-generated.json +6 -6
  119. package/skills/review/SKILL.md +5 -1
  120. package/skills/review/references/build.md +3 -1
  121. package/skills/review/references/review.md +2 -0
  122. package/skills/review/references/ship.md +2 -2
  123. package/skills/review/references/task-context.md +4 -0
  124. package/skills/review/references/verification.md +13 -1
  125. package/skills/rollback/.fde-generated.json +2 -2
  126. package/skills/rollback/SKILL.md +5 -1
  127. package/skills/rollback/references/task-context.md +4 -0
  128. package/skills/runbook/.fde-generated.json +4 -3
  129. package/skills/runbook/SKILL.md +5 -1
  130. package/skills/runbook/references/runbook.md +2 -0
  131. package/skills/runbook/references/task-context.md +4 -0
  132. package/skills/runbook/references/verification.md +45 -0
  133. package/skills/scope/.fde-generated.json +2 -2
  134. package/skills/scope/SKILL.md +5 -1
  135. package/skills/scope/references/task-context.md +4 -0
  136. package/skills/score-use-cases/.fde-generated.json +2 -2
  137. package/skills/score-use-cases/SKILL.md +5 -1
  138. package/skills/score-use-cases/references/task-context.md +4 -0
  139. package/skills/ship/.fde-generated.json +6 -6
  140. package/skills/ship/SKILL.md +5 -1
  141. package/skills/ship/references/build.md +3 -1
  142. package/skills/ship/references/review.md +2 -0
  143. package/skills/ship/references/ship.md +2 -2
  144. package/skills/ship/references/task-context.md +4 -0
  145. package/skills/ship/references/verification.md +13 -1
  146. package/skills/switch-clients/.fde-generated.json +2 -2
  147. package/skills/switch-clients/SKILL.md +5 -1
  148. package/skills/switch-clients/references/task-context.md +4 -0
  149. package/skills/test-assumptions/.fde-generated.json +2 -2
  150. package/skills/test-assumptions/SKILL.md +5 -1
  151. package/skills/test-assumptions/references/task-context.md +4 -0
  152. package/skills/what-breaks/.fde-generated.json +2 -2
  153. package/skills/what-breaks/SKILL.md +5 -1
  154. package/skills/what-breaks/references/task-context.md +4 -0
  155. package/skills/who-decides/.fde-generated.json +2 -2
  156. package/skills/who-decides/SKILL.md +5 -1
  157. package/skills/who-decides/references/task-context.md +4 -0
@@ -22,6 +22,8 @@ Trace the changed path through its consumers and failure cases:
22
22
  - **AI behavior:** outputs remain untrusted, tools enforce allowed actions, and [eval evidence](eval-pack.md) covers the changed behavior and documented authority. Preserve privacy-safe source evidence and concise rationale, never hidden reasoning.
23
23
  - **Operability:** observable failures, bounded resource use, meaningful checks, and a recovery path appropriate to the risk. Deployment readiness is assessed separately in [ship](ship.md).
24
24
 
25
+ For changes with consequential security impact, map the affected assets, actors and permissions, and trust boundaries. Trace plausible abuse paths through the changed code, identify the controls that stop them, and check those controls or record the missing evidence. Keep this assessment with the existing review receipt and proportional to the change; use a formal threat-model framework only when the project requires or benefits from it.
26
+
25
27
  ## Findings and repair
26
28
 
27
29
  For each actionable finding give the path/line or precise location, concrete trigger, observed or reasoned failure, impact, and focused correction. Distinguish proven bugs from hypotheses that need a check. Prioritize release blockers over minor concerns; avoid speculative style work.
@@ -54,6 +54,8 @@ For AI components, include relevant model and configuration versions, evaluation
54
54
 
55
55
  Select checks based on the system's actual consequences. For example, the receiving operator may demonstrate normal operation, diagnose a known failure, or recover a failed release in a permitted test environment.
56
56
 
57
+ When readiness depends on a failure signal, follow the [operator-response evidence check](verification.md#operator-response). A draft can mark it untested; configuration alone does not prove delivery or response.
58
+
57
59
  Record each critical capability separately as verified, failed or untested, with evidence. A successful walkthrough cannot compensate for an untested recovery path. Avoid an averaged confidence score that hides a critical gap.
58
60
 
59
61
  If a procedure fails, correct the guide or system within scope and repeat the affected check. If verification is unavailable, deliver the draft with its limits and propose the next check; do not claim the handoff complete or indefinitely extend the engagement yourself.
@@ -30,7 +30,7 @@ Before deployment, establish these facts from existing evidence or a necessary c
30
30
  | Acceptance | Replayable check and agreed decision-maker/mechanism; record actual acceptance separately from readiness |
31
31
  | Data and policy | Permitted data, applicable security/residency/change-window requirements, necessary approvals already recorded or obtained |
32
32
  | Recovery | Applicable tested rollback, restore, compensation, or roll-forward within agreed recovery-time/data-loss limits; explicit authority for irreversible effects |
33
- | Operations | Named release/recovery owner, runbook appropriate to risk, health and business signals, stop thresholds, observation coverage |
33
+ | Operations | Named release/recovery owner, runbook appropriate to risk, health and business signals, stop thresholds, observation coverage; applicable [failure-signal delivery evidence](verification.md#operator-response) for paths whose readiness depends on operator response |
34
34
  | AI, when applicable | Current applicable SHIP eval evidence, critical failures zero, enforced action boundary and required human review or documented bounded automation |
35
35
 
36
36
  Check migration compatibility, old/new version coexistence, delayed jobs, caches, and already-emitted side effects where relevant. A code revert does not undo data loss or external writes. Reuse drill evidence only when the mechanism and relevant conditions are unchanged, explaining applicability. If recovery is only a plan, exercise it in a permitted representative environment before release.
@@ -57,7 +57,7 @@ Before wider exposure, verify expected load/cost, data pipeline behavior, owners
57
57
 
58
58
  Keep these claims separate: implemented, verified, deployed, measured outcome, and accepted. Include the candidate, target, command/pipeline, applicable checks and unrun checks, review source, evaluation where needed, authority source, recovery evidence, observation, and next owner/action. Attribute acceptance to its actual source and scope. A staging measurement is not production value, and a commit is not deployment.
59
59
 
60
- In engagement mode, write confirmed implementation/decisions and delivery receipts under the existing record rules. Standalone work returns the same receipt or uses the repository's permitted release record. Committing, pushing, opening a PR, publishing, and notifying others are actions governed by the user's workflow, not mandatory steps imposed by this method.
60
+ In engagement mode, write confirmed implementation/decisions and delivery receipts under the existing record rules. Standalone work returns the same receipt or uses the repository's permitted release record. If substantial work remains, retain a [recoverable checkpoint](verification.md#recoverable-checkpoint) there. Committing, pushing, opening a PR, publishing, and notifying others are actions governed by the user's workflow, not mandatory steps imposed by this method.
61
61
 
62
62
  ## Worked example
63
63
 
@@ -18,3 +18,7 @@ Only locate the CLI when the selected task needs it. Check `fde` on PATH and its
18
18
  If no permitted executable is available, explain the missing capability. Continue any useful draft from supplied excerpts, but do not claim to have read, switched, staged, saved or rendered real records. Do not read raw private record files as a fallback.
19
19
 
20
20
  Apply the selected method to this context. Follow its linked supporting methods only when needed; do not restart discovery or repeat already answered questions.
21
+
22
+ ## Identifier masking
23
+
24
+ Before reading stored engagement content, run `fde privacy` to verify runtime support. If unavailable, stop record access and use the permitted CLI fallback; a new skill alone does not upgrade an older executable. A standalone task using supplied permitted context does not need the CLI. If no executable is available, continue useful work from supplied excerpts and report the record-access limitation. Use CLI context and previews for model input. They mask common email, phone, SSN-shaped, and credential patterns by default; aliases remain consistent within the local engagements root. Preserve complete alias tokens when drafting updates; the CLI resolves them locally. Never read the private `.privacy/` dictionary, sealed sidecars, raw sensitive notes, or local dashboard/vault files to recover an identity. Custom masking additionally hides the literal names or terms the user supplied locally, ignoring letter case and matching whole terms. It does not infer variants or discover names. Names, company names, addresses, and unrecognized formats are otherwise not automatically detected: keep sensitive prose in `<private>` blocks. Direct file tools, pasted chat, and upstream source MCPs bypass this boundary.
@@ -8,7 +8,7 @@ Use [task context](task-context.md). This method returns evidence directly or wr
8
8
 
9
9
  1. Translate each claim into the observation that would support or reject it. Reuse agreed acceptance criteria and required repository checks. Select focused checks for changed behavior before broadening to release requirements.
10
10
  2. Identify the actual repository commands, fixtures, runtime, and environment. Read command behavior before executing it, especially when it can write externally. Use authorized environments and avoid leaking secrets through logs or diagnostic commands.
11
- 3. Run the checks and inspect results, including exit status and relevant output. A running job, test discovery, a mocked response, and a successful real request are different evidence. Record asynchronous completion before claiming success.
11
+ 3. Run the checks and inspect results, including exit status and relevant output. A running job, test discovery, a mocked response, and a successful real request are different evidence. Record asynchronous completion before claiming success. Describe a command as executed only when its actual invocation and result are available; an inferred result is not a run.
12
12
  4. Bind evidence to the tested revision and working tree. For uncommitted changes record the base revision plus changed paths and an available diff digest or snapshot identifier. For browser/manual checks record the steps, inputs, observed result, and inspected evidence.
13
13
  5. After a change, rerun checks whose behavior or assumptions were affected. Reuse prior evidence only when the relevant code, dependencies, data, and environment remain applicable; cite the original run and reason. Never imply reused evidence was rerun.
14
14
  6. Label every required check **passed**, **failed**, **blocked**, or **not run**. Include why blocked/not run, impact, and next step. Missing evidence is unproven; it is not an observed failure or a pass.
@@ -28,6 +28,18 @@ Use one compact entry per check or a table with these fields:
28
28
 
29
29
  Keep implementation, verification, deployment, measured outcome, and customer acceptance distinct. A local pass supports the tested local behavior. An acceptance claim needs an attributed source from the agreed decision-maker or agreed acceptance mechanism. Record no raw `<private>` blocks, credentials, or hidden reasoning.
30
30
 
31
+ ## Operator response
32
+
33
+ When readiness depends on a failure signal, verify that a representative failure reaches the responsible operator through the intended route in an approved environment. Record separately whether the route is configured, the signal was delivered, and the operator acknowledged it; configuration alone proves neither delivery nor response. Use an authorized test route or an already approved drill, and identify any difference from the intended operating route. Do not page people or trigger production incidents without authorization. Reuse applicable evidence with attribution; a draft guide can mark this check untested.
34
+
35
+ ## Recoverable checkpoint
36
+
37
+ For substantial work, keep a compact checkpoint in the existing permitted customer or project task record; if none exists, include it in the returned receipt. Reuse existing task/ticket identifiers when available. Record the task and agreed outcome, repository/branch/revision and dirty state, completed work and check results, pending work and checks, current blocker or `none`, and the exact next action. Link existing evidence rather than copying it into a new tracking artifact. Follow the record's write rules; a checkpoint does not silently change agreed scope or acceptance.
38
+
39
+ In an ongoing engagement, optionally summarize that checkpoint under an unindented `## Implementation checkpoint` heading in the existing `context.md`, with the next action and task-record path/ID first. Follow the engagement confirmation and privacy rules. `fde resume` surfaces this saved summary without opening the referenced task file; retrieve that source only when permitted. Keep one current checkpoint, and clear or explicitly close it when the work ends. Do not initialize `.fde/` for standalone work or copy the whole backlog.
40
+
41
+ Update it after meaningful completed slices and before a pause or handoff. On resuming, inspect the actual working tree and relevant evidence before taking the recorded next action; stale status is not proof that work or checks are still applicable.
42
+
31
43
  ## Acceptance
32
44
 
33
45
  A completion statement cites applicable evidence for its claims and explicitly names material gaps. If required checks fail, investigate or report the blocker; never skip them, edit expectations, or relabel the scope without authority to obtain a green result.
@@ -2,8 +2,8 @@
2
2
  "generator": "bin/generate-skills.js",
3
3
  "version": 1,
4
4
  "files": {
5
- "SKILL.md": "f8666990f8b4463af5f29acdb1d1cd5e8fec68119b82a891aa2322a213f37344",
5
+ "SKILL.md": "7d49a9e89736e35c2aaf10c78b10be365bdf91af1aaf99430de6069e96069d55",
6
6
  "references/encode-pattern.md": "3be7bf9d0f69af31659423c54d6023a4af1556e2ce200fb025bf64d0757de4d8",
7
- "references/task-context.md": "3c0b0083e63a3e667d80fa7641b10eabf88ee729e877f658580cbc07031834ec"
7
+ "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
8
8
  }
9
9
  }
@@ -11,7 +11,11 @@ description: Assess a field lesson for reuse or product feedback without exposin
11
11
 
12
12
  Assess a field lesson for reuse or product feedback without exposing customer context. Use for recurring deployment lessons; distinguish a hypothesis from a validated pattern.
13
13
 
14
- Read [the task context contract](references/task-context.md), then [the method](references/encode-pattern.md). Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
14
+ Before investigating or acting:
15
+ 1. Read [the task context contract](references/task-context.md).
16
+ 2. Read [the method](references/encode-pattern.md).
17
+
18
+ Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
15
19
 
16
20
  ## Principles
17
21
 
@@ -18,3 +18,7 @@ Only locate the CLI when the selected task needs it. Check `fde` on PATH and its
18
18
  If no permitted executable is available, explain the missing capability. Continue any useful draft from supplied excerpts, but do not claim to have read, switched, staged, saved or rendered real records. Do not read raw private record files as a fallback.
19
19
 
20
20
  Apply the selected method to this context. Follow its linked supporting methods only when needed; do not restart discovery or repeat already answered questions.
21
+
22
+ ## Identifier masking
23
+
24
+ Before reading stored engagement content, run `fde privacy` to verify runtime support. If unavailable, stop record access and use the permitted CLI fallback; a new skill alone does not upgrade an older executable. A standalone task using supplied permitted context does not need the CLI. If no executable is available, continue useful work from supplied excerpts and report the record-access limitation. Use CLI context and previews for model input. They mask common email, phone, SSN-shaped, and credential patterns by default; aliases remain consistent within the local engagements root. Preserve complete alias tokens when drafting updates; the CLI resolves them locally. Never read the private `.privacy/` dictionary, sealed sidecars, raw sensitive notes, or local dashboard/vault files to recover an identity. Custom masking additionally hides the literal names or terms the user supplied locally, ignoring letter case and matching whole terms. It does not infer variants or discover names. Names, company names, addresses, and unrecognized formats are otherwise not automatically detected: keep sensitive prose in `<private>` blocks. Direct file tools, pasted chat, and upstream source MCPs bypass this boundary.
@@ -2,9 +2,9 @@
2
2
  "generator": "bin/generate-skills.js",
3
3
  "version": 1,
4
4
  "files": {
5
- "SKILL.md": "9f08605914670f2c0bd09631d3d40c079e7f63174d1a2607e60ea6eca5d54d93",
5
+ "SKILL.md": "c4ac99ee1517c0674e5324b289521116c58a9e0ac3de22c229be8da83438f4db",
6
6
  "references/close.md": "b3dbc1ecef12ee1c9d298e32a21d87ce61c9f6c88039d7a8b19970c6e3f21254",
7
7
  "references/encode-pattern.md": "3be7bf9d0f69af31659423c54d6023a4af1556e2ce200fb025bf64d0757de4d8",
8
- "references/task-context.md": "3c0b0083e63a3e667d80fa7641b10eabf88ee729e877f658580cbc07031834ec"
8
+ "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
9
9
  }
10
10
  }
@@ -11,7 +11,11 @@ description: Transfer operation of a customer deployment with ownership, evidenc
11
11
 
12
12
  Transfer operation of a customer deployment with ownership, evidence and a tested support path. Use for handoff or an engineer rotation, not merely code delivery.
13
13
 
14
- Read [the task context contract](references/task-context.md), then [the method](references/close.md). Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
14
+ Before investigating or acting:
15
+ 1. Read [the task context contract](references/task-context.md).
16
+ 2. Read [the method](references/close.md).
17
+
18
+ Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
15
19
 
16
20
  ## Principles
17
21
 
@@ -18,3 +18,7 @@ Only locate the CLI when the selected task needs it. Check `fde` on PATH and its
18
18
  If no permitted executable is available, explain the missing capability. Continue any useful draft from supplied excerpts, but do not claim to have read, switched, staged, saved or rendered real records. Do not read raw private record files as a fallback.
19
19
 
20
20
  Apply the selected method to this context. Follow its linked supporting methods only when needed; do not restart discovery or repeat already answered questions.
21
+
22
+ ## Identifier masking
23
+
24
+ Before reading stored engagement content, run `fde privacy` to verify runtime support. If unavailable, stop record access and use the permitted CLI fallback; a new skill alone does not upgrade an older executable. A standalone task using supplied permitted context does not need the CLI. If no executable is available, continue useful work from supplied excerpts and report the record-access limitation. Use CLI context and previews for model input. They mask common email, phone, SSN-shaped, and credential patterns by default; aliases remain consistent within the local engagements root. Preserve complete alias tokens when drafting updates; the CLI resolves them locally. Never read the private `.privacy/` dictionary, sealed sidecars, raw sensitive notes, or local dashboard/vault files to recover an identity. Custom masking additionally hides the literal names or terms the user supplied locally, ignoring letter case and matching whole terms. It does not infer variants or discover names. Names, company names, addresses, and unrecognized formats are otherwise not automatically detected: keep sensitive prose in `<private>` blocks. Direct file tools, pasted chat, and upstream source MCPs bypass this boundary.
@@ -2,11 +2,11 @@
2
2
  "generator": "bin/generate-skills.js",
3
3
  "version": 1,
4
4
  "files": {
5
- "SKILL.md": "4df02c561ea8d2baf66ac373d67527c8826b72d80bf7b1fedc248c45a572adf9",
5
+ "SKILL.md": "631bdeb6ec45d8844f59519f9d3cca89c24e65c51721eb0a67f32fc5cfc979a2",
6
6
  "references/connect.md": "37ad703ece7fe3596be4d5d3697cc4ba5e6062615f9576733c20d055fc3e4927",
7
7
  "references/debrief.md": "2d2db9a177f5341a9a2721a9d6ea32a6d07e7e982e621429ca408a38bc5617c1",
8
8
  "references/ingest.md": "24880bc3d95cda09ec6c2f5edebd17fba99deb912f93e15c8b715a287283da84",
9
9
  "references/source-setup.md": "a28ae7c6dbb2573a66f31b30b7abca34bc52573fe34d48fff4c7490e4dc85d3e",
10
- "references/task-context.md": "3c0b0083e63a3e667d80fa7641b10eabf88ee729e877f658580cbc07031834ec"
10
+ "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
11
11
  }
12
12
  }
@@ -11,7 +11,11 @@ description: Fetch requested source material and prepare sourced engagement upda
11
11
 
12
12
  Fetch requested source material and prepare sourced engagement updates. Use to catch up from external notes or messages; applying updates requires a bound record and confirmation.
13
13
 
14
- Read [the task context contract](references/task-context.md), then [the method](references/ingest.md). Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
14
+ Before investigating or acting:
15
+ 1. Read [the task context contract](references/task-context.md).
16
+ 2. Read [the method](references/ingest.md).
17
+
18
+ Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
15
19
 
16
20
  ## Principles
17
21
 
@@ -18,3 +18,7 @@ Only locate the CLI when the selected task needs it. Check `fde` on PATH and its
18
18
  If no permitted executable is available, explain the missing capability. Continue any useful draft from supplied excerpts, but do not claim to have read, switched, staged, saved or rendered real records. Do not read raw private record files as a fallback.
19
19
 
20
20
  Apply the selected method to this context. Follow its linked supporting methods only when needed; do not restart discovery or repeat already answered questions.
21
+
22
+ ## Identifier masking
23
+
24
+ Before reading stored engagement content, run `fde privacy` to verify runtime support. If unavailable, stop record access and use the permitted CLI fallback; a new skill alone does not upgrade an older executable. A standalone task using supplied permitted context does not need the CLI. If no executable is available, continue useful work from supplied excerpts and report the record-access limitation. Use CLI context and previews for model input. They mask common email, phone, SSN-shaped, and credential patterns by default; aliases remain consistent within the local engagements root. Preserve complete alias tokens when drafting updates; the CLI resolves them locally. Never read the private `.privacy/` dictionary, sealed sidecars, raw sensitive notes, or local dashboard/vault files to recover an identity. Custom masking additionally hides the literal names or terms the user supplied locally, ignoring letter case and matching whole terms. It does not infer variants or discover names. Names, company names, addresses, and unrecognized formats are otherwise not automatically detected: keep sensitive prose in `<private>` blocks. Direct file tools, pasted chat, and upstream source MCPs bypass this boundary.
@@ -2,15 +2,15 @@
2
2
  "generator": "bin/generate-skills.js",
3
3
  "version": 1,
4
4
  "files": {
5
- "SKILL.md": "ea74e65eff6b189e1e2fb00c3553192116ccc475785eb82bfaee49819610dfd4",
6
- "references/build.md": "3f8b5e52eb874ee4e99db5e0b70d1ccca1134f667a39279d6b4e55629832ae75",
5
+ "SKILL.md": "63cc6cef59cadd45b36a080ac97f1d0bc8e777b12f39a9a6f62b63dfb5029b2d",
6
+ "references/build.md": "7634abd02b70011b7443a65ea3aaf3cb536ed5b051312aed188f46523deea7f9",
7
7
  "references/debug.md": "c3bb344d38cc3552cb4e230c601a9be3fe173af2b2efb89aab6b7b04339f24f4",
8
8
  "references/eval-pack.md": "0590b85d3cae0903c6b1274540c92eaa2a4373047e8a0548d6942516ef0bb9e1",
9
9
  "references/integrate.md": "d0de35a783902ca8b4762e3a42a14f467766d56a928c3a5cf11adac2a6ba90ba",
10
10
  "references/qa.md": "d8f58e6d36436469a58aeb1107037f3e27fa81ff5b82d0e4df3c23eeadaf683c",
11
- "references/review.md": "63a007f78288089cc84cccc72647e8ce6721b7efa0f4f8d6774c0f0af594749d",
12
- "references/ship.md": "8cdcb2d4d6eb57e0adf3f1996bc02ae66920852ca304d2afd778fa483b7e969a",
13
- "references/task-context.md": "3c0b0083e63a3e667d80fa7641b10eabf88ee729e877f658580cbc07031834ec",
14
- "references/verification.md": "62bb4fb40d9b71c6481c57a4564bcc98c4014a8be5d4aedfe1eb3f7f90d5e1f7"
11
+ "references/review.md": "55733ca868c00fb22110bc7b3ec7bb6c6451366c795073b19a2bccd30d2764c8",
12
+ "references/ship.md": "c7fd7774d6ba1f7e9d05b4bfd89bae124bb9bab0079d49c15a025b8b3383f157",
13
+ "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5",
14
+ "references/verification.md": "18dfaa97b16e8713a99d9686e3a9fef4e0b9bde0f81c87af8fd73dae588543c2"
15
15
  }
16
16
  }
@@ -11,7 +11,11 @@ description: Build or change a customer-system integration with explicit data ma
11
11
 
12
12
  Build or change a customer-system integration with explicit data mapping, permissions, retries and reconciliation. Use for connectors, imports, write-back and upstream APIs.
13
13
 
14
- Read [the task context contract](references/task-context.md), then [the method](references/integrate.md). Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
14
+ Before investigating or acting:
15
+ 1. Read [the task context contract](references/task-context.md).
16
+ 2. Read [the method](references/integrate.md).
17
+
18
+ Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
15
19
 
16
20
  ## Principles
17
21
 
@@ -6,7 +6,7 @@ Use the permitted context and authority in [task context](task-context.md). This
6
6
 
7
7
  ## Method
8
8
 
9
- 1. Identify the repository, its instructions, working tree, relevant callers, and test commands. Inspect examples before creating abstractions. Preserve unrelated edits and state which dependencies or interfaces the change touches. Before changing an untested legacy path, capture the undocumented behavior callers depend on with targeted characterization checks; distinguish behavior to preserve from the intended change.
9
+ 1. Identify the repository, its instructions, working tree, relevant callers, and test commands. Inspect examples before creating abstractions. Follow the repository's branch policy and choose any needed checkout isolation according to that policy and overlapping work. Preserve unrelated edits and state which dependencies or interfaces the change touches. Before changing an untested legacy path, capture the undocumented behavior callers depend on with targeted characterization checks; distinguish behavior to preserve from the intended change.
10
10
  2. State the observable outcome, constraints, and acceptance checks. Reuse agreed criteria for routine fixes. If a consequential product choice is unresolved, surface that choice while continuing independent investigation; do not invent acceptance.
11
11
  3. Choose the smallest coherent path that demonstrates the outcome through the real entry point. Include the necessary storage, error handling, and interface behavior in that slice. Name the failure that stops expansion and the recovery path for stateful changes.
12
12
  4. Implement using the repository's tools and conventions. Search for existing services, fixtures, and validation before adding alternatives. Keep cleanup limited to what makes the changed path understandable; do not expand scope to repair unrelated code. When changing dependencies, inspect the package source, requested version, lockfile changes and repository install-script policy before executing package code. Use the approved package manager and bootstrap controls; do not blanket-enable scripts or apply unrelated dependency upgrades.
@@ -15,6 +15,8 @@ Use the permitted context and authority in [task context](task-context.md). This
15
15
 
16
16
  ## Deliverable and acceptance
17
17
 
18
+ For substantial work, maintain the [recoverable checkpoint](verification.md#recoverable-checkpoint) in the existing task record as slices complete or work pauses.
19
+
18
20
  Return the implemented behavior, relevant paths, evidence, remaining limitations, and any decision needed. Done means the agreed checks have applicable evidence and the change is reviewable; passing tests does not imply deployment or customer acceptance. Committing, opening a PR, merging, and publishing happen only when the requested workflow authorizes those actions.
19
21
 
20
22
  When coordinated through `@fde`, record implementation and verification in the existing decisions/delivery records under their write rules. Standalone work can return the same receipt directly or use the repository's task record.
@@ -22,6 +22,8 @@ Trace the changed path through its consumers and failure cases:
22
22
  - **AI behavior:** outputs remain untrusted, tools enforce allowed actions, and [eval evidence](eval-pack.md) covers the changed behavior and documented authority. Preserve privacy-safe source evidence and concise rationale, never hidden reasoning.
23
23
  - **Operability:** observable failures, bounded resource use, meaningful checks, and a recovery path appropriate to the risk. Deployment readiness is assessed separately in [ship](ship.md).
24
24
 
25
+ For changes with consequential security impact, map the affected assets, actors and permissions, and trust boundaries. Trace plausible abuse paths through the changed code, identify the controls that stop them, and check those controls or record the missing evidence. Keep this assessment with the existing review receipt and proportional to the change; use a formal threat-model framework only when the project requires or benefits from it.
26
+
25
27
  ## Findings and repair
26
28
 
27
29
  For each actionable finding give the path/line or precise location, concrete trigger, observed or reasoned failure, impact, and focused correction. Distinguish proven bugs from hypotheses that need a check. Prioritize release blockers over minor concerns; avoid speculative style work.
@@ -30,7 +30,7 @@ Before deployment, establish these facts from existing evidence or a necessary c
30
30
  | Acceptance | Replayable check and agreed decision-maker/mechanism; record actual acceptance separately from readiness |
31
31
  | Data and policy | Permitted data, applicable security/residency/change-window requirements, necessary approvals already recorded or obtained |
32
32
  | Recovery | Applicable tested rollback, restore, compensation, or roll-forward within agreed recovery-time/data-loss limits; explicit authority for irreversible effects |
33
- | Operations | Named release/recovery owner, runbook appropriate to risk, health and business signals, stop thresholds, observation coverage |
33
+ | Operations | Named release/recovery owner, runbook appropriate to risk, health and business signals, stop thresholds, observation coverage; applicable [failure-signal delivery evidence](verification.md#operator-response) for paths whose readiness depends on operator response |
34
34
  | AI, when applicable | Current applicable SHIP eval evidence, critical failures zero, enforced action boundary and required human review or documented bounded automation |
35
35
 
36
36
  Check migration compatibility, old/new version coexistence, delayed jobs, caches, and already-emitted side effects where relevant. A code revert does not undo data loss or external writes. Reuse drill evidence only when the mechanism and relevant conditions are unchanged, explaining applicability. If recovery is only a plan, exercise it in a permitted representative environment before release.
@@ -57,7 +57,7 @@ Before wider exposure, verify expected load/cost, data pipeline behavior, owners
57
57
 
58
58
  Keep these claims separate: implemented, verified, deployed, measured outcome, and accepted. Include the candidate, target, command/pipeline, applicable checks and unrun checks, review source, evaluation where needed, authority source, recovery evidence, observation, and next owner/action. Attribute acceptance to its actual source and scope. A staging measurement is not production value, and a commit is not deployment.
59
59
 
60
- In engagement mode, write confirmed implementation/decisions and delivery receipts under the existing record rules. Standalone work returns the same receipt or uses the repository's permitted release record. Committing, pushing, opening a PR, publishing, and notifying others are actions governed by the user's workflow, not mandatory steps imposed by this method.
60
+ In engagement mode, write confirmed implementation/decisions and delivery receipts under the existing record rules. Standalone work returns the same receipt or uses the repository's permitted release record. If substantial work remains, retain a [recoverable checkpoint](verification.md#recoverable-checkpoint) there. Committing, pushing, opening a PR, publishing, and notifying others are actions governed by the user's workflow, not mandatory steps imposed by this method.
61
61
 
62
62
  ## Worked example
63
63
 
@@ -18,3 +18,7 @@ Only locate the CLI when the selected task needs it. Check `fde` on PATH and its
18
18
  If no permitted executable is available, explain the missing capability. Continue any useful draft from supplied excerpts, but do not claim to have read, switched, staged, saved or rendered real records. Do not read raw private record files as a fallback.
19
19
 
20
20
  Apply the selected method to this context. Follow its linked supporting methods only when needed; do not restart discovery or repeat already answered questions.
21
+
22
+ ## Identifier masking
23
+
24
+ Before reading stored engagement content, run `fde privacy` to verify runtime support. If unavailable, stop record access and use the permitted CLI fallback; a new skill alone does not upgrade an older executable. A standalone task using supplied permitted context does not need the CLI. If no executable is available, continue useful work from supplied excerpts and report the record-access limitation. Use CLI context and previews for model input. They mask common email, phone, SSN-shaped, and credential patterns by default; aliases remain consistent within the local engagements root. Preserve complete alias tokens when drafting updates; the CLI resolves them locally. Never read the private `.privacy/` dictionary, sealed sidecars, raw sensitive notes, or local dashboard/vault files to recover an identity. Custom masking additionally hides the literal names or terms the user supplied locally, ignoring letter case and matching whole terms. It does not infer variants or discover names. Names, company names, addresses, and unrecognized formats are otherwise not automatically detected: keep sensitive prose in `<private>` blocks. Direct file tools, pasted chat, and upstream source MCPs bypass this boundary.
@@ -8,7 +8,7 @@ Use [task context](task-context.md). This method returns evidence directly or wr
8
8
 
9
9
  1. Translate each claim into the observation that would support or reject it. Reuse agreed acceptance criteria and required repository checks. Select focused checks for changed behavior before broadening to release requirements.
10
10
  2. Identify the actual repository commands, fixtures, runtime, and environment. Read command behavior before executing it, especially when it can write externally. Use authorized environments and avoid leaking secrets through logs or diagnostic commands.
11
- 3. Run the checks and inspect results, including exit status and relevant output. A running job, test discovery, a mocked response, and a successful real request are different evidence. Record asynchronous completion before claiming success.
11
+ 3. Run the checks and inspect results, including exit status and relevant output. A running job, test discovery, a mocked response, and a successful real request are different evidence. Record asynchronous completion before claiming success. Describe a command as executed only when its actual invocation and result are available; an inferred result is not a run.
12
12
  4. Bind evidence to the tested revision and working tree. For uncommitted changes record the base revision plus changed paths and an available diff digest or snapshot identifier. For browser/manual checks record the steps, inputs, observed result, and inspected evidence.
13
13
  5. After a change, rerun checks whose behavior or assumptions were affected. Reuse prior evidence only when the relevant code, dependencies, data, and environment remain applicable; cite the original run and reason. Never imply reused evidence was rerun.
14
14
  6. Label every required check **passed**, **failed**, **blocked**, or **not run**. Include why blocked/not run, impact, and next step. Missing evidence is unproven; it is not an observed failure or a pass.
@@ -28,6 +28,18 @@ Use one compact entry per check or a table with these fields:
28
28
 
29
29
  Keep implementation, verification, deployment, measured outcome, and customer acceptance distinct. A local pass supports the tested local behavior. An acceptance claim needs an attributed source from the agreed decision-maker or agreed acceptance mechanism. Record no raw `<private>` blocks, credentials, or hidden reasoning.
30
30
 
31
+ ## Operator response
32
+
33
+ When readiness depends on a failure signal, verify that a representative failure reaches the responsible operator through the intended route in an approved environment. Record separately whether the route is configured, the signal was delivered, and the operator acknowledged it; configuration alone proves neither delivery nor response. Use an authorized test route or an already approved drill, and identify any difference from the intended operating route. Do not page people or trigger production incidents without authorization. Reuse applicable evidence with attribution; a draft guide can mark this check untested.
34
+
35
+ ## Recoverable checkpoint
36
+
37
+ For substantial work, keep a compact checkpoint in the existing permitted customer or project task record; if none exists, include it in the returned receipt. Reuse existing task/ticket identifiers when available. Record the task and agreed outcome, repository/branch/revision and dirty state, completed work and check results, pending work and checks, current blocker or `none`, and the exact next action. Link existing evidence rather than copying it into a new tracking artifact. Follow the record's write rules; a checkpoint does not silently change agreed scope or acceptance.
38
+
39
+ In an ongoing engagement, optionally summarize that checkpoint under an unindented `## Implementation checkpoint` heading in the existing `context.md`, with the next action and task-record path/ID first. Follow the engagement confirmation and privacy rules. `fde resume` surfaces this saved summary without opening the referenced task file; retrieve that source only when permitted. Keep one current checkpoint, and clear or explicitly close it when the work ends. Do not initialize `.fde/` for standalone work or copy the whole backlog.
40
+
41
+ Update it after meaningful completed slices and before a pause or handoff. On resuming, inspect the actual working tree and relevant evidence before taking the recorded next action; stale status is not proof that work or checks are still applicable.
42
+
31
43
  ## Acceptance
32
44
 
33
45
  A completion statement cites applicable evidence for its claims and explicitly names material gaps. If required checks fail, investigate or report the blocker; never skip them, edit expectations, or relabel the scope without authority to obtain a green result.
@@ -2,9 +2,9 @@
2
2
  "generator": "bin/generate-skills.js",
3
3
  "version": 1,
4
4
  "files": {
5
- "SKILL.md": "a50e9dd53f9ed6896c219f1ef13f52b254eb896cee53a02ed56d40cf77a29a7c",
5
+ "SKILL.md": "0c51c5421875b17c66c4fdb03a33e3705da52a0c649dd138c4c4cd3f3c92292a",
6
6
  "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25",
7
- "references/task-context.md": "3c0b0083e63a3e667d80fa7641b10eabf88ee729e877f658580cbc07031834ec",
7
+ "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5",
8
8
  "references/test-assumptions.md": "bf60d8bb4c0701fcffb196d78f7f6c8b1c472fc877fb2caf41058fbf8e2415a1",
9
9
  "references/three-options.md": "168fab9fb8ac8de85b0d1fa58e1db17deaa244cdef8c99623a04a0a6c70fe52c"
10
10
  }
@@ -11,7 +11,11 @@ description: Compare feasible approaches to a customer problem and recommend a p
11
11
 
12
12
  Compare feasible approaches to a customer problem and recommend a path with costs, constraints and evidence. Use for an architecture or delivery decision, not implementation.
13
13
 
14
- Read [the task context contract](references/task-context.md), then [the method](references/three-options.md). Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
14
+ Before investigating or acting:
15
+ 1. Read [the task context contract](references/task-context.md).
16
+ 2. Read [the method](references/three-options.md).
17
+
18
+ Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
15
19
 
16
20
  ## Principles
17
21
 
@@ -18,3 +18,7 @@ Only locate the CLI when the selected task needs it. Check `fde` on PATH and its
18
18
  If no permitted executable is available, explain the missing capability. Continue any useful draft from supplied excerpts, but do not claim to have read, switched, staged, saved or rendered real records. Do not read raw private record files as a fallback.
19
19
 
20
20
  Apply the selected method to this context. Follow its linked supporting methods only when needed; do not restart discovery or repeat already answered questions.
21
+
22
+ ## Identifier masking
23
+
24
+ Before reading stored engagement content, run `fde privacy` to verify runtime support. If unavailable, stop record access and use the permitted CLI fallback; a new skill alone does not upgrade an older executable. A standalone task using supplied permitted context does not need the CLI. If no executable is available, continue useful work from supplied excerpts and report the record-access limitation. Use CLI context and previews for model input. They mask common email, phone, SSN-shaped, and credential patterns by default; aliases remain consistent within the local engagements root. Preserve complete alias tokens when drafting updates; the CLI resolves them locally. Never read the private `.privacy/` dictionary, sealed sidecars, raw sensitive notes, or local dashboard/vault files to recover an identity. Custom masking additionally hides the literal names or terms the user supplied locally, ignoring letter case and matching whole terms. It does not infer variants or discover names. Names, company names, addresses, and unrecognized formats are otherwise not automatically detected: keep sensitive prose in `<private>` blocks. Direct file tools, pasted chat, and upstream source MCPs bypass this boundary.
@@ -2,9 +2,9 @@
2
2
  "generator": "bin/generate-skills.js",
3
3
  "version": 1,
4
4
  "files": {
5
- "SKILL.md": "7228088cfea2128c220475fb1b2a417e3aecfb70dbd96a8fcbbc6b652ab0e3a2",
5
+ "SKILL.md": "88254d8bc2f58f4fcdd610dd7c111854dccf3ef488cfae85a4f81e90e25d1c96",
6
6
  "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25",
7
- "references/plan.md": "4ccc74a3476da1c10bf8c05d249d573bcf73d13b8b6c88bd769635d816d0914b",
8
- "references/task-context.md": "3c0b0083e63a3e667d80fa7641b10eabf88ee729e877f658580cbc07031834ec"
7
+ "references/plan.md": "324cf48e9ba46b55eb382a93b6836cbd3d8f4df2e899567baa361a5b42c022a4",
8
+ "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5"
9
9
  }
10
10
  }
@@ -11,7 +11,11 @@ description: Sequence an understood outcome into verifiable delivery slices with
11
11
 
12
12
  Sequence an understood outcome into verifiable delivery slices with dependencies, ownership and acceptance checks. Use for delivery planning, estimation or migration strategy.
13
13
 
14
- Read [the task context contract](references/task-context.md), then [the method](references/plan.md). Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
14
+ Before investigating or acting:
15
+ 1. Read [the task context contract](references/task-context.md).
16
+ 2. Read [the method](references/plan.md).
17
+
18
+ Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
15
19
 
16
20
  ## Principles
17
21
 
@@ -30,6 +30,8 @@ An FDE plan is not a sprint backlog. The technical sequence is the easy part. Th
30
30
 
31
31
  **Reuse check.** Before sequencing a build, compare the requested solution with the smallest existing capability or operating change that could satisfy the same acceptance test. Cite the relevant repo/config/workaround evidence. Record why reuse is sufficient or insufficient in `decisions.md`; include “no new code” when supported. A request for AI does not establish that a model is needed. If a host engineering pack already has an approved implementation plan, reference it from `decisions.md`; do not generate a parallel user-story backlog.
32
32
 
33
+ Use existing ticket identifiers when they help connect the plan to implementation and evidence. Reuse the customer's domain terms; define a term in the existing plan or glossary only when ambiguity could change behavior or acceptance. Do not introduce another ticket scheme or glossary by default.
34
+
33
35
  **1. Work backwards from success.** What's the last thing that must be true before done? And before that? That's the dependency chain - not a wish list.
34
36
 
35
37
  **2. Front-load the fragile.** Check `terrain.md` hotspots. Risky modules go early - fail fast, not in week three.
@@ -138,7 +140,7 @@ Never quietly update tasks. Name the reset: update `reality.md` and `success.md`
138
140
 
139
141
  Acme, after discover: the reconciliation job is unowned, Marco's spreadsheet is the real fallback.
140
142
 
141
- **Now** is three tasks, not eight. Task 1 is *failures reach a named human* - delivers a page to a rota, accepts "kill the job mid-run → the on-call is paged within 15 min", touches the job wrapper and the alert config, rollback is re-disable the route, **Kill if:** a real failure page is acked by nobody on the rota (the *finance would act* assumption, DISPROVED if Marco is the only name that answers), verify by killing it in staging. Value promised: `risk-mitigation - a silent failure becomes a 15-minute one`.
143
+ **Now** is three tasks, not eight. Task 1 is *failures reach a named human* - delivers a page to a rota, accepts "a permitted staging failure → the agreed operator receives the test alert within 15 min", touches the job wrapper and the alert config, rollback is re-disable the route, **Kill if:** the approved drill alert is acked by nobody on the rota (the *finance would act* assumption, DISPROVED if Marco is the only name that answers), verify in an approved staging drill with the operator and route agreed beforehand. Record configured, delivered and acknowledged separately; the drill does not authorize production paging. Value promised: `risk-mitigation - a silent failure becomes a 15-minute one`.
142
144
 
143
145
  The kill list in `decisions.md` is where the plan earns its keep: the rewrite of the reconciliation service that Tom keeps proposing goes there - *deferred, the failure mode is ownership not architecture (Priya accepted, Jun 12)* - along with the finance dashboard finance asked for directly. Both stay visible so the same argument is not re-litigated in week 4 without a receipt.
144
146
 
@@ -18,3 +18,7 @@ Only locate the CLI when the selected task needs it. Check `fde` on PATH and its
18
18
  If no permitted executable is available, explain the missing capability. Continue any useful draft from supplied excerpts, but do not claim to have read, switched, staged, saved or rendered real records. Do not read raw private record files as a fallback.
19
19
 
20
20
  Apply the selected method to this context. Follow its linked supporting methods only when needed; do not restart discovery or repeat already answered questions.
21
+
22
+ ## Identifier masking
23
+
24
+ Before reading stored engagement content, run `fde privacy` to verify runtime support. If unavailable, stop record access and use the permitted CLI fallback; a new skill alone does not upgrade an older executable. A standalone task using supplied permitted context does not need the CLI. If no executable is available, continue useful work from supplied excerpts and report the record-access limitation. Use CLI context and previews for model input. They mask common email, phone, SSN-shaped, and credential patterns by default; aliases remain consistent within the local engagements root. Preserve complete alias tokens when drafting updates; the CLI resolves them locally. Never read the private `.privacy/` dictionary, sealed sidecars, raw sensitive notes, or local dashboard/vault files to recover an identity. Custom masking additionally hides the literal names or terms the user supplied locally, ignoring letter case and matching whole terms. It does not infer variants or discover names. Names, company names, addresses, and unrecognized formats are otherwise not automatically detected: keep sensitive prose in `<private>` blocks. Direct file tools, pasted chat, and upstream source MCPs bypass this boundary.
@@ -2,22 +2,22 @@
2
2
  "generator": "bin/generate-skills.js",
3
3
  "version": 1,
4
4
  "files": {
5
- "SKILL.md": "bceae7ba11c006b3d1e93e330a80cc58eeef55d863cc374653eef8fd124c3056",
5
+ "SKILL.md": "f72f8cf960aa85150f85e316bca0f306e3e57c140ed9f49ed9fa04dd0671662f",
6
6
  "references/audit.md": "ed32ea78cbccb100742dd838e8cf4cd4b6f33ad44b3de7424fc624670d571dbc",
7
- "references/build.md": "3f8b5e52eb874ee4e99db5e0b70d1ccca1134f667a39279d6b4e55629832ae75",
7
+ "references/build.md": "7634abd02b70011b7443a65ea3aaf3cb536ed5b051312aed188f46523deea7f9",
8
8
  "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25",
9
9
  "references/debug.md": "c3bb344d38cc3552cb4e230c601a9be3fe173af2b2efb89aab6b7b04339f24f4",
10
10
  "references/discover.md": "f65aa11a539b4dbbed70cfaa94ec2a35595aa9a2d0282790510b933ac9c721ce",
11
11
  "references/eval-pack.md": "0590b85d3cae0903c6b1274540c92eaa2a4373047e8a0548d6942516ef0bb9e1",
12
12
  "references/integrate.md": "d0de35a783902ca8b4762e3a42a14f467766d56a928c3a5cf11adac2a6ba90ba",
13
- "references/plan.md": "4ccc74a3476da1c10bf8c05d249d573bcf73d13b8b6c88bd769635d816d0914b",
13
+ "references/plan.md": "324cf48e9ba46b55eb382a93b6836cbd3d8f4df2e899567baa361a5b42c022a4",
14
14
  "references/poc.md": "818dc90c2d401819735233ab9d69df171675d75abf8644c403dab7dd1dcf9199",
15
15
  "references/qa.md": "d8f58e6d36436469a58aeb1107037f3e27fa81ff5b82d0e4df3c23eeadaf683c",
16
- "references/review.md": "63a007f78288089cc84cccc72647e8ce6721b7efa0f4f8d6774c0f0af594749d",
17
- "references/ship.md": "8cdcb2d4d6eb57e0adf3f1996bc02ae66920852ca304d2afd778fa483b7e969a",
18
- "references/task-context.md": "3c0b0083e63a3e667d80fa7641b10eabf88ee729e877f658580cbc07031834ec",
16
+ "references/review.md": "55733ca868c00fb22110bc7b3ec7bb6c6451366c795073b19a2bccd30d2764c8",
17
+ "references/ship.md": "c7fd7774d6ba1f7e9d05b4bfd89bae124bb9bab0079d49c15a025b8b3383f157",
18
+ "references/task-context.md": "9066514a50043f3ad888d133d4e8b89b7132551e098cf2c80203c458a80126e5",
19
19
  "references/test-assumptions.md": "bf60d8bb4c0701fcffb196d78f7f6c8b1c472fc877fb2caf41058fbf8e2415a1",
20
20
  "references/three-options.md": "168fab9fb8ac8de85b0d1fa58e1db17deaa244cdef8c99623a04a0a6c70fe52c",
21
- "references/verification.md": "62bb4fb40d9b71c6481c57a4564bcc98c4014a8be5d4aedfe1eb3f7f90d5e1f7"
21
+ "references/verification.md": "18dfaa97b16e8713a99d9686e3a9fef4e0b9bde0f81c87af8fd73dae588543c2"
22
22
  }
23
23
  }
@@ -11,7 +11,11 @@ description: Run a bounded customer proof of concept to test a consequential unc
11
11
 
12
12
  Run a bounded customer proof of concept to test a consequential uncertainty. Use for a spike or pilot with a question and decision deadline, not a full rollout.
13
13
 
14
- Read [the task context contract](references/task-context.md), then [the method](references/poc.md). Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
14
+ Before investigating or acting:
15
+ 1. Read [the task context contract](references/task-context.md).
16
+ 2. Read [the method](references/poc.md).
17
+
18
+ Load further references only when the task needs them. Everything linked is included in this skill; no other skill pack is required.
15
19
 
16
20
  ## Principles
17
21
 
@@ -6,7 +6,7 @@ Use the permitted context and authority in [task context](task-context.md). This
6
6
 
7
7
  ## Method
8
8
 
9
- 1. Identify the repository, its instructions, working tree, relevant callers, and test commands. Inspect examples before creating abstractions. Preserve unrelated edits and state which dependencies or interfaces the change touches. Before changing an untested legacy path, capture the undocumented behavior callers depend on with targeted characterization checks; distinguish behavior to preserve from the intended change.
9
+ 1. Identify the repository, its instructions, working tree, relevant callers, and test commands. Inspect examples before creating abstractions. Follow the repository's branch policy and choose any needed checkout isolation according to that policy and overlapping work. Preserve unrelated edits and state which dependencies or interfaces the change touches. Before changing an untested legacy path, capture the undocumented behavior callers depend on with targeted characterization checks; distinguish behavior to preserve from the intended change.
10
10
  2. State the observable outcome, constraints, and acceptance checks. Reuse agreed criteria for routine fixes. If a consequential product choice is unresolved, surface that choice while continuing independent investigation; do not invent acceptance.
11
11
  3. Choose the smallest coherent path that demonstrates the outcome through the real entry point. Include the necessary storage, error handling, and interface behavior in that slice. Name the failure that stops expansion and the recovery path for stateful changes.
12
12
  4. Implement using the repository's tools and conventions. Search for existing services, fixtures, and validation before adding alternatives. Keep cleanup limited to what makes the changed path understandable; do not expand scope to repair unrelated code. When changing dependencies, inspect the package source, requested version, lockfile changes and repository install-script policy before executing package code. Use the approved package manager and bootstrap controls; do not blanket-enable scripts or apply unrelated dependency upgrades.
@@ -15,6 +15,8 @@ Use the permitted context and authority in [task context](task-context.md). This
15
15
 
16
16
  ## Deliverable and acceptance
17
17
 
18
+ For substantial work, maintain the [recoverable checkpoint](verification.md#recoverable-checkpoint) in the existing task record as slices complete or work pauses.
19
+
18
20
  Return the implemented behavior, relevant paths, evidence, remaining limitations, and any decision needed. Done means the agreed checks have applicable evidence and the change is reviewable; passing tests does not imply deployment or customer acceptance. Committing, opening a PR, merging, and publishing happen only when the requested workflow authorizes those actions.
19
21
 
20
22
  When coordinated through `@fde`, record implementation and verification in the existing decisions/delivery records under their write rules. Standalone work can return the same receipt directly or use the repository's task record.
@@ -30,6 +30,8 @@ An FDE plan is not a sprint backlog. The technical sequence is the easy part. Th
30
30
 
31
31
  **Reuse check.** Before sequencing a build, compare the requested solution with the smallest existing capability or operating change that could satisfy the same acceptance test. Cite the relevant repo/config/workaround evidence. Record why reuse is sufficient or insufficient in `decisions.md`; include “no new code” when supported. A request for AI does not establish that a model is needed. If a host engineering pack already has an approved implementation plan, reference it from `decisions.md`; do not generate a parallel user-story backlog.
32
32
 
33
+ Use existing ticket identifiers when they help connect the plan to implementation and evidence. Reuse the customer's domain terms; define a term in the existing plan or glossary only when ambiguity could change behavior or acceptance. Do not introduce another ticket scheme or glossary by default.
34
+
33
35
  **1. Work backwards from success.** What's the last thing that must be true before done? And before that? That's the dependency chain - not a wish list.
34
36
 
35
37
  **2. Front-load the fragile.** Check `terrain.md` hotspots. Risky modules go early - fail fast, not in week three.
@@ -138,7 +140,7 @@ Never quietly update tasks. Name the reset: update `reality.md` and `success.md`
138
140
 
139
141
  Acme, after discover: the reconciliation job is unowned, Marco's spreadsheet is the real fallback.
140
142
 
141
- **Now** is three tasks, not eight. Task 1 is *failures reach a named human* - delivers a page to a rota, accepts "kill the job mid-run → the on-call is paged within 15 min", touches the job wrapper and the alert config, rollback is re-disable the route, **Kill if:** a real failure page is acked by nobody on the rota (the *finance would act* assumption, DISPROVED if Marco is the only name that answers), verify by killing it in staging. Value promised: `risk-mitigation - a silent failure becomes a 15-minute one`.
143
+ **Now** is three tasks, not eight. Task 1 is *failures reach a named human* - delivers a page to a rota, accepts "a permitted staging failure → the agreed operator receives the test alert within 15 min", touches the job wrapper and the alert config, rollback is re-disable the route, **Kill if:** the approved drill alert is acked by nobody on the rota (the *finance would act* assumption, DISPROVED if Marco is the only name that answers), verify in an approved staging drill with the operator and route agreed beforehand. Record configured, delivered and acknowledged separately; the drill does not authorize production paging. Value promised: `risk-mitigation - a silent failure becomes a 15-minute one`.
142
144
 
143
145
  The kill list in `decisions.md` is where the plan earns its keep: the rewrite of the reconciliation service that Tom keeps proposing goes there - *deferred, the failure mode is ownership not architecture (Priya accepted, Jun 12)* - along with the finance dashboard finance asked for directly. Both stay visible so the same argument is not re-litigated in week 4 without a receipt.
144
146
 
@@ -22,6 +22,8 @@ Trace the changed path through its consumers and failure cases:
22
22
  - **AI behavior:** outputs remain untrusted, tools enforce allowed actions, and [eval evidence](eval-pack.md) covers the changed behavior and documented authority. Preserve privacy-safe source evidence and concise rationale, never hidden reasoning.
23
23
  - **Operability:** observable failures, bounded resource use, meaningful checks, and a recovery path appropriate to the risk. Deployment readiness is assessed separately in [ship](ship.md).
24
24
 
25
+ For changes with consequential security impact, map the affected assets, actors and permissions, and trust boundaries. Trace plausible abuse paths through the changed code, identify the controls that stop them, and check those controls or record the missing evidence. Keep this assessment with the existing review receipt and proportional to the change; use a formal threat-model framework only when the project requires or benefits from it.
26
+
25
27
  ## Findings and repair
26
28
 
27
29
  For each actionable finding give the path/line or precise location, concrete trigger, observed or reasoned failure, impact, and focused correction. Distinguish proven bugs from hypotheses that need a check. Prioritize release blockers over minor concerns; avoid speculative style work.
@@ -30,7 +30,7 @@ Before deployment, establish these facts from existing evidence or a necessary c
30
30
  | Acceptance | Replayable check and agreed decision-maker/mechanism; record actual acceptance separately from readiness |
31
31
  | Data and policy | Permitted data, applicable security/residency/change-window requirements, necessary approvals already recorded or obtained |
32
32
  | Recovery | Applicable tested rollback, restore, compensation, or roll-forward within agreed recovery-time/data-loss limits; explicit authority for irreversible effects |
33
- | Operations | Named release/recovery owner, runbook appropriate to risk, health and business signals, stop thresholds, observation coverage |
33
+ | Operations | Named release/recovery owner, runbook appropriate to risk, health and business signals, stop thresholds, observation coverage; applicable [failure-signal delivery evidence](verification.md#operator-response) for paths whose readiness depends on operator response |
34
34
  | AI, when applicable | Current applicable SHIP eval evidence, critical failures zero, enforced action boundary and required human review or documented bounded automation |
35
35
 
36
36
  Check migration compatibility, old/new version coexistence, delayed jobs, caches, and already-emitted side effects where relevant. A code revert does not undo data loss or external writes. Reuse drill evidence only when the mechanism and relevant conditions are unchanged, explaining applicability. If recovery is only a plan, exercise it in a permitted representative environment before release.
@@ -57,7 +57,7 @@ Before wider exposure, verify expected load/cost, data pipeline behavior, owners
57
57
 
58
58
  Keep these claims separate: implemented, verified, deployed, measured outcome, and accepted. Include the candidate, target, command/pipeline, applicable checks and unrun checks, review source, evaluation where needed, authority source, recovery evidence, observation, and next owner/action. Attribute acceptance to its actual source and scope. A staging measurement is not production value, and a commit is not deployment.
59
59
 
60
- In engagement mode, write confirmed implementation/decisions and delivery receipts under the existing record rules. Standalone work returns the same receipt or uses the repository's permitted release record. Committing, pushing, opening a PR, publishing, and notifying others are actions governed by the user's workflow, not mandatory steps imposed by this method.
60
+ In engagement mode, write confirmed implementation/decisions and delivery receipts under the existing record rules. Standalone work returns the same receipt or uses the repository's permitted release record. If substantial work remains, retain a [recoverable checkpoint](verification.md#recoverable-checkpoint) there. Committing, pushing, opening a PR, publishing, and notifying others are actions governed by the user's workflow, not mandatory steps imposed by this method.
61
61
 
62
62
  ## Worked example
63
63
 
@@ -18,3 +18,7 @@ Only locate the CLI when the selected task needs it. Check `fde` on PATH and its
18
18
  If no permitted executable is available, explain the missing capability. Continue any useful draft from supplied excerpts, but do not claim to have read, switched, staged, saved or rendered real records. Do not read raw private record files as a fallback.
19
19
 
20
20
  Apply the selected method to this context. Follow its linked supporting methods only when needed; do not restart discovery or repeat already answered questions.
21
+
22
+ ## Identifier masking
23
+
24
+ Before reading stored engagement content, run `fde privacy` to verify runtime support. If unavailable, stop record access and use the permitted CLI fallback; a new skill alone does not upgrade an older executable. A standalone task using supplied permitted context does not need the CLI. If no executable is available, continue useful work from supplied excerpts and report the record-access limitation. Use CLI context and previews for model input. They mask common email, phone, SSN-shaped, and credential patterns by default; aliases remain consistent within the local engagements root. Preserve complete alias tokens when drafting updates; the CLI resolves them locally. Never read the private `.privacy/` dictionary, sealed sidecars, raw sensitive notes, or local dashboard/vault files to recover an identity. Custom masking additionally hides the literal names or terms the user supplied locally, ignoring letter case and matching whole terms. It does not infer variants or discover names. Names, company names, addresses, and unrecognized formats are otherwise not automatically detected: keep sensitive prose in `<private>` blocks. Direct file tools, pasted chat, and upstream source MCPs bypass this boundary.