From d3f3e8987b9e17873b3a1014a4fda31a7ea3d448 Mon Sep 17 00:00:00 2001 From: Subash Date: Mon, 5 Oct 2026 09:48:46 +0530 Subject: [PATCH] Adapt engagement guidance to scope, uncertainty and risk --- .claude-plugin/plugin.json | 2 +- CHANGELOG.md | 5 +++++ README.md | 2 ++ mcp/fdeops-ingest/package.json | 2 +- package.json | 2 +- plugin.json | 2 +- skills/audit/.fde-generated.json | 2 +- skills/audit/references/task-context.md | 1 + skills/board-memo/.fde-generated.json | 2 +- skills/board-memo/references/task-context.md | 1 + skills/brief/.fde-generated.json | 4 ++-- skills/brief/references/land.md | 4 +++- skills/brief/references/task-context.md | 1 + skills/build/.fde-generated.json | 2 +- skills/build/references/task-context.md | 1 + skills/business-case/.fde-generated.json | 2 +- skills/business-case/references/task-context.md | 1 + skills/connect/.fde-generated.json | 2 +- skills/connect/references/task-context.md | 1 + skills/dashboard/.fde-generated.json | 2 +- skills/dashboard/references/task-context.md | 1 + skills/debrief/.fde-generated.json | 2 +- skills/debrief/references/task-context.md | 1 + skills/debug/.fde-generated.json | 2 +- skills/debug/references/task-context.md | 1 + skills/demo-prep/.fde-generated.json | 2 +- skills/demo-prep/references/task-context.md | 1 + skills/discover/.fde-generated.json | 2 +- skills/discover/references/task-context.md | 1 + skills/earn-trust/.fde-generated.json | 2 +- skills/earn-trust/references/task-context.md | 1 + skills/evaluate/.fde-generated.json | 2 +- skills/evaluate/references/task-context.md | 1 + skills/fde/SKILL.md | 2 +- skills/fde/references/ai.md | 8 ++++---- skills/fde/references/fintech.md | 2 +- skills/fde/references/land.md | 4 +++- skills/fde/references/plan.md | 12 +++++++----- skills/fde/references/task-context.md | 1 + skills/feedback/.fde-generated.json | 2 +- skills/feedback/references/task-context.md | 1 + skills/handoff/.fde-generated.json | 4 ++-- skills/handoff/references/land.md | 4 +++- skills/handoff/references/task-context.md | 1 + skills/ingest/.fde-generated.json | 2 +- skills/ingest/references/task-context.md | 1 + skills/integrate/.fde-generated.json | 2 +- skills/integrate/references/task-context.md | 1 + skills/options/.fde-generated.json | 2 +- skills/options/references/task-context.md | 1 + skills/plan/.fde-generated.json | 4 ++-- skills/plan/references/plan.md | 12 +++++++----- skills/plan/references/task-context.md | 1 + skills/poc/.fde-generated.json | 4 ++-- skills/poc/references/plan.md | 12 +++++++----- skills/poc/references/task-context.md | 1 + skills/prioritize/.fde-generated.json | 2 +- skills/prioritize/references/task-context.md | 1 + skills/qa/.fde-generated.json | 2 +- skills/qa/references/task-context.md | 1 + skills/readout/.fde-generated.json | 2 +- skills/readout/references/task-context.md | 1 + skills/red-team/.fde-generated.json | 2 +- skills/red-team/references/task-context.md | 1 + skills/rescue/.fde-generated.json | 2 +- skills/rescue/references/task-context.md | 1 + skills/review/.fde-generated.json | 2 +- skills/review/references/task-context.md | 1 + skills/rollback/.fde-generated.json | 2 +- skills/rollback/references/task-context.md | 1 + skills/runbook/.fde-generated.json | 4 ++-- skills/runbook/references/land.md | 4 +++- skills/runbook/references/task-context.md | 1 + skills/scope/.fde-generated.json | 2 +- skills/scope/references/task-context.md | 1 + skills/score-use-cases/.fde-generated.json | 2 +- skills/score-use-cases/references/task-context.md | 1 + skills/ship/.fde-generated.json | 2 +- skills/ship/references/task-context.md | 1 + skills/switch-clients/.fde-generated.json | 2 +- skills/switch-clients/references/task-context.md | 1 + skills/test-assumptions/.fde-generated.json | 2 +- skills/test-assumptions/references/task-context.md | 1 + skills/what-breaks/.fde-generated.json | 2 +- skills/what-breaks/references/task-context.md | 1 + skills/who-decides/.fde-generated.json | 2 +- skills/who-decides/references/task-context.md | 1 + 87 files changed, 126 insertions(+), 69 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 01d5915..9adaf75 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "fdeops", "description": "Skills for forward deployed engineers across strategy, architecture and engineering. Use individual tasks or @fde coordination; local customer memory supports continuity.", - "version": "5.1.22", + "version": "5.1.23", "category": "productivity", "tags": [ "community-managed" diff --git a/CHANGELOG.md b/CHANGELOG.md index 3a96c7f..e039f96 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## 5.1.23 - 2026-10-05 + +- Adapt engagement guidance to uncertainty, dependencies, risk and customer constraints rather than duration or a mandatory phase sequence. +- Let bounded tasks proceed directly to implementation or a brief single-slice plan; reserve fuller planning and coordination for work that needs them. Preserve acceptance, data and release authority checks. + ## 5.1.22 - 2026-10-01 - Keep approvals limited to API compatibility, budget or release scope from becoming general engagement signer proposals; preserve the original notes and sources for review. diff --git a/README.md b/README.md index b959db0..6972f4c 100644 --- a/README.md +++ b/README.md @@ -53,6 +53,8 @@ Here are the agreed behavior, repository and checks: ... Each task skill includes the instructions it needs. Use `build` with supplied project context without creating a customer record or installing the coordinator. +Use only the methods the work needs, whether the engagement lasts three days, three weeks or several months. A clear, bounded task can go straight to implementation. Uncertain requirements, dependent teams or production risk may need more discovery and coordination. Reuse the customer’s existing tools and approvals; the skill catalog is not a sequence to complete. +
Installation requirements and alternatives diff --git a/mcp/fdeops-ingest/package.json b/mcp/fdeops-ingest/package.json index efdfed8..b6edc84 100644 --- a/mcp/fdeops-ingest/package.json +++ b/mcp/fdeops-ingest/package.json @@ -1,6 +1,6 @@ { "name": "fdeops-ingest-mcp", - "version": "5.1.22", + "version": "5.1.23", "private": true, "description": "Thin stdio MCP sink for FDEOps ingest (stage \u2192 propose \u2192 apply). Zero runtime dependencies.", "bin": { diff --git a/package.json b/package.json index 5acd81a..1d820bf 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "fdeops", - "version": "5.1.22", + "version": "5.1.23", "description": "Skills for forward deployed engineers across strategy, architecture and engineering. Use individual tasks or @fde coordination; local customer memory supports continuity.", "bin": { "fdeops": "bin/install.js", diff --git a/plugin.json b/plugin.json index ccfd9c4..9574eeb 100644 --- a/plugin.json +++ b/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "fdeops", - "version": "5.1.22", + "version": "5.1.23", "description": "Skills for forward deployed engineers across strategy, architecture and engineering. Use individual tasks or @fde coordination; local customer memory supports continuity.", "author": { "name": "Subash Natarajan", diff --git a/skills/audit/.fde-generated.json b/skills/audit/.fde-generated.json index ea2f632..99ef893 100644 --- a/skills/audit/.fde-generated.json +++ b/skills/audit/.fde-generated.json @@ -6,6 +6,6 @@ "agents/openai.yaml": "3b08e2e6a4149545da08238463955501bc60b7bf628cf4e344e893330590bbde", "references/audit.md": "ed32ea78cbccb100742dd838e8cf4cd4b6f33ad44b3de7424fc624670d571dbc", "references/discover.md": "f65aa11a539b4dbbed70cfaa94ec2a35595aa9a2d0282790510b933ac9c721ce", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/audit/references/task-context.md b/skills/audit/references/task-context.md index d313522..1b8314a 100644 --- a/skills/audit/references/task-context.md +++ b/skills/audit/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/board-memo/.fde-generated.json b/skills/board-memo/.fde-generated.json index 0d0d078..00c9c52 100644 --- a/skills/board-memo/.fde-generated.json +++ b/skills/board-memo/.fde-generated.json @@ -6,6 +6,6 @@ "agents/openai.yaml": "a3ce2dc79d3732da6c9aa2d45d09541c09c8f7bdf44f34c6603b5dbaf8624095", "references/board-memo.md": "44eb3c27f164da63af694591025b3fc96bb23d149c29de400997c1653e3322f8", "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/board-memo/references/task-context.md b/skills/board-memo/references/task-context.md index d313522..1b8314a 100644 --- a/skills/board-memo/references/task-context.md +++ b/skills/board-memo/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/brief/.fde-generated.json b/skills/brief/.fde-generated.json index 1a3bbf4..2be95ca 100644 --- a/skills/brief/.fde-generated.json +++ b/skills/brief/.fde-generated.json @@ -4,7 +4,7 @@ "files": { "SKILL.md": "5d88b9818951f8a8a44c39ad2b36ccdca74fef5e6ed31e67788b50d3ca1bb006", "agents/openai.yaml": "8dc0b43545004419bad49e1d50cd3beb968bbcc24baacdaf7fb7304a5fd03bba", - "references/land.md": "87dfffc8e39d35eaf23d510ba7e9913d48e90d2705eb9155ab192d12ea98d18d", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/land.md": "f33f1b9e03a3c23c39ffce925a8f8b956b48a53982f55246752a48a317cb084d", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/brief/references/land.md b/skills/brief/references/land.md index 1b1210c..16226af 100644 --- a/skills/brief/references/land.md +++ b/skills/brief/references/land.md @@ -4,6 +4,8 @@ **Read first:** apply [task context](task-context.md), then permitted `context.md` evidence if it exists and the supplied brief. Once the engagement type and AI/access policy are known, inspect the supplied repo/docs relevant to the ask before asking questions they can answer. This is a bounded evidence check, not a full discovery scan. +**Bounded engagement:** A new customer does not automatically require a full landing exercise. For a single-outcome task or simulation of any duration, use the supplied brief to establish the outcome, deadline, permitted inputs, acceptance and next authorized action. If those are clear, route to the working task immediately. If one material gap remains, investigate that gap; do not build a stakeholder map or populate engagement files for their own sake. A simulated stakeholder does not justify invented meetings or approval chains. Keep actual data and release authority checks where they affect the work. + ## Validation gate (confirm understanding, clarify where it elevates) Before landing, state what you know in 2-3 lines: @@ -12,7 +14,7 @@ Before landing, state what you know in 2-3 lines: Then check - probe ONLY if it prevents a bad start: -1. **Engagement speed.** If timeline is unclear → weave it in naturally: "Is this days, weeks, or months? That shapes how much structure we set up now." +1. **Deadline and scope.** Ask about timing only when it changes the next action: "What result is needed by when?" Use uncertainty, dependencies, risk and access to choose the necessary structure; duration alone does not decide it. 2. **Existing context.** If `.fde/` already exists → one line: "There's existing engagement memory here. Continuing this or starting fresh?" 3. **Access.** If the FDE is about to start work → one line: "Got repo and environment access sorted, or is that still pending?" diff --git a/skills/brief/references/task-context.md b/skills/brief/references/task-context.md index d313522..1b8314a 100644 --- a/skills/brief/references/task-context.md +++ b/skills/brief/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/build/.fde-generated.json b/skills/build/.fde-generated.json index 1c519a7..1924d58 100644 --- a/skills/build/.fde-generated.json +++ b/skills/build/.fde-generated.json @@ -11,7 +11,7 @@ "references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e", "references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a", "references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/build/references/task-context.md b/skills/build/references/task-context.md index d313522..1b8314a 100644 --- a/skills/build/references/task-context.md +++ b/skills/build/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/business-case/.fde-generated.json b/skills/business-case/.fde-generated.json index 05be321..a93e3be 100644 --- a/skills/business-case/.fde-generated.json +++ b/skills/business-case/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "1105f7e78b5e73e54aafb8150e03be8c3ccd3443bc3ae667555763a839c1abe4", "agents/openai.yaml": "dd2676346caea1b53ae2bee6662aea064eea74c8ca6edf721382526f5fc42ef5", "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/business-case/references/task-context.md b/skills/business-case/references/task-context.md index d313522..1b8314a 100644 --- a/skills/business-case/references/task-context.md +++ b/skills/business-case/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/connect/.fde-generated.json b/skills/connect/.fde-generated.json index 84061ab..d375e9d 100644 --- a/skills/connect/.fde-generated.json +++ b/skills/connect/.fde-generated.json @@ -8,6 +8,6 @@ "references/debrief.md": "2e8e929f1c741e1a7250ad720dfa2196e1f8b14ae84f17e406c38910b9b83376", "references/ingest.md": "2aaf948f6ae19fb472a2bf101b8064fc04e3c1103b874455b5a4457b5c69cf86", "references/source-setup.md": "a28ae7c6dbb2573a66f31b30b7abca34bc52573fe34d48fff4c7490e4dc85d3e", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/connect/references/task-context.md b/skills/connect/references/task-context.md index d313522..1b8314a 100644 --- a/skills/connect/references/task-context.md +++ b/skills/connect/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/dashboard/.fde-generated.json b/skills/dashboard/.fde-generated.json index e6efe8f..855b453 100644 --- a/skills/dashboard/.fde-generated.json +++ b/skills/dashboard/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "e06df3f2da2586c14e12f2599091231083c0a2f43af70b427c0ab307641610a3", "agents/openai.yaml": "abbfc923f66cea302d6fb06b02ff5d2a9f9faa24f30904344785abab1e627999", "references/dashboard.md": "dd842c17a2689a6017fecf34a6a24ee5cd40f504af4397eaeb2493ef4ffceda0", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/dashboard/references/task-context.md b/skills/dashboard/references/task-context.md index d313522..1b8314a 100644 --- a/skills/dashboard/references/task-context.md +++ b/skills/dashboard/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/debrief/.fde-generated.json b/skills/debrief/.fde-generated.json index 1735ca5..f9f4bb2 100644 --- a/skills/debrief/.fde-generated.json +++ b/skills/debrief/.fde-generated.json @@ -8,6 +8,6 @@ "references/debrief.md": "2e8e929f1c741e1a7250ad720dfa2196e1f8b14ae84f17e406c38910b9b83376", "references/ingest.md": "2aaf948f6ae19fb472a2bf101b8064fc04e3c1103b874455b5a4457b5c69cf86", "references/source-setup.md": "a28ae7c6dbb2573a66f31b30b7abca34bc52573fe34d48fff4c7490e4dc85d3e", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/debrief/references/task-context.md b/skills/debrief/references/task-context.md index d313522..1b8314a 100644 --- a/skills/debrief/references/task-context.md +++ b/skills/debrief/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/debug/.fde-generated.json b/skills/debug/.fde-generated.json index 5bf9f6d..a2c48b5 100644 --- a/skills/debug/.fde-generated.json +++ b/skills/debug/.fde-generated.json @@ -11,7 +11,7 @@ "references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e", "references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a", "references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/debug/references/task-context.md b/skills/debug/references/task-context.md index d313522..1b8314a 100644 --- a/skills/debug/references/task-context.md +++ b/skills/debug/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/demo-prep/.fde-generated.json b/skills/demo-prep/.fde-generated.json index 215b805..68efaeb 100644 --- a/skills/demo-prep/.fde-generated.json +++ b/skills/demo-prep/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "a9c477a1f2f2d44ba1893ea1299c3b30f07c772064b8c28d5bb31d87f032ef67", "agents/openai.yaml": "14df03f4ac1652773b277fbe8e9c501f253dbe550b29f4df1ec0e15a9b6eb6aa", "references/demo-prep.md": "2166d4104c8da995ea1dbdf27e36fe288a83c6e18ff1de2650fb0eec769ec84f", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/demo-prep/references/task-context.md b/skills/demo-prep/references/task-context.md index d313522..1b8314a 100644 --- a/skills/demo-prep/references/task-context.md +++ b/skills/demo-prep/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/discover/.fde-generated.json b/skills/discover/.fde-generated.json index 8d7f33c..ac8c77c 100644 --- a/skills/discover/.fde-generated.json +++ b/skills/discover/.fde-generated.json @@ -6,6 +6,6 @@ "agents/openai.yaml": "77306e5aa72884b8c06afe91ae4991910bf3ad38a72375c2fc5251fc7744789a", "references/audit.md": "ed32ea78cbccb100742dd838e8cf4cd4b6f33ad44b3de7424fc624670d571dbc", "references/discover.md": "f65aa11a539b4dbbed70cfaa94ec2a35595aa9a2d0282790510b933ac9c721ce", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/discover/references/task-context.md b/skills/discover/references/task-context.md index d313522..1b8314a 100644 --- a/skills/discover/references/task-context.md +++ b/skills/discover/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/earn-trust/.fde-generated.json b/skills/earn-trust/.fde-generated.json index c905b8d..a3a18cf 100644 --- a/skills/earn-trust/.fde-generated.json +++ b/skills/earn-trust/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "a739454cd58e6beba57877e8b1c0d888d1068617b63959014c7b142fd12d68c3", "agents/openai.yaml": "3157721445a01f3f840106c23f775305155946669cf44d056e5eb4641f47a84d", "references/earn-trust.md": "ec31c339a39d9a7f3855ff77478684bc1d6cae473362489456f0c17b64c33399", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/earn-trust/references/task-context.md b/skills/earn-trust/references/task-context.md index d313522..1b8314a 100644 --- a/skills/earn-trust/references/task-context.md +++ b/skills/earn-trust/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/evaluate/.fde-generated.json b/skills/evaluate/.fde-generated.json index 858463e..fb87ba2 100644 --- a/skills/evaluate/.fde-generated.json +++ b/skills/evaluate/.fde-generated.json @@ -11,7 +11,7 @@ "references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e", "references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a", "references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/evaluate/references/task-context.md b/skills/evaluate/references/task-context.md index d313522..1b8314a 100644 --- a/skills/evaluate/references/task-context.md +++ b/skills/evaluate/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/fde/SKILL.md b/skills/fde/SKILL.md index 48a97f8..1bb983d 100644 --- a/skills/fde/SKILL.md +++ b/skills/fde/SKILL.md @@ -164,7 +164,7 @@ Work names (engage, diagnose, align, deliver, realize, transfer) are the same ma | Payments, cardholder data, PCI-DSS, anything that moves money | `references/fintech.md` | | Government agency, FedRAMP, ATO, CUI, classified | `references/gov.md` | -Ready to build: check that the supplied facts establish the outcome, constraints and verification path. Use discover or plan only for material gaps. On a takeover, audit inherited claims that affect the task. Two customers in one message: confirm which folder. +Ready to build at any point in an engagement: check that the supplied facts establish the outcome, constraints and verification path, then use `build` for the working slice. Use discover or plan only for a material gap or a real sequencing decision; do not run every stage or create records to demonstrate activity. On a takeover, audit inherited claims that affect the task. Two customers in one message: confirm which folder. ## Principles diff --git a/skills/fde/references/ai.md b/skills/fde/references/ai.md index aaa2c81..2fd4319 100644 --- a/skills/fde/references/ai.md +++ b/skills/fde/references/ai.md @@ -2,7 +2,7 @@ **Activate when you hear:** AI, ML, machine learning, model, LLM, GPT, inference, embeddings, RAG, agents, fine-tuning, prompt engineering, training data, model drift, hallucination, vector database, neural network, generative AI. Loads **alongside** the active phase, never instead of it. -**Read first:** `trust-profile.md` always - AI policy and data classification before any action. `terrain.md` when reviewing existing AI components. +**Read first:** apply [task context](task-context.md). Use permitted AI-policy and data-classification evidence from the supplied brief or existing `trust-profile.md`; use `terrain.md` when reviewing existing AI components. Missing records do not block standalone work. AI systems fail differently from traditional software: they **degrade silently** instead of throwing exceptions. A model that hallucinates returns a 200 OK with confident nonsense. A drifted model passes every unit test while making worse decisions. The monitoring, testing, and governance patterns for AI are fundamentally different. @@ -10,13 +10,13 @@ AI systems fail differently from traditional software: they **degrade silently** > "Is there an existing AI/ML policy? Who approves production use of AI? What data can leave the network?" -Get these answers before any AI code is written: +Resolve the following before the action that depends on them: customer-data use, a paid model call or production release. Reuse supplied answers. While approval is pending, an authorized local prototype can use synthetic inputs and stubbed model responses; label what that does not verify. - **Model hosting:** cloud API (OpenAI, Anthropic, Google) or self-hosted? Cloud = data leaves the network. Self-hosted = infra cost and maintenance. - **Data classification:** what data touches the model? PII in prompts = a compliance conversation before a technical one. - **Human-in-the-loop requirements:** which decisions require human review before action? In regulated industries, autonomous AI decisions may be prohibited. - **Budget/cost model:** AI inference costs scale with usage. What's the expected volume? What's the cost ceiling? -Record in `trust-profile.md` under `## AI policy`. +For a bound engagement, record confirmed policy in `trust-profile.md` under `## AI policy`; otherwise retain the supplied constraints with the task. ## Model selection - choosing the right tool @@ -38,7 +38,7 @@ Write model selection rationale to `decisions.md`. Include: models tested, test ## Engagement eval pack (before AI ships) -When any slice touches a model, embeddings, RAG, or an agent: create or update `.fde/evals.md` **before** ship. Full skill: `references/eval-pack.md`. This is the engagement-local test set - not unit tests. +Before releasing model, embedding, RAG or agent behavior, use [eval-pack](eval-pack.md) with evidence proportional to the intended use and risk. Reuse the project’s existing evaluation artifact; in a bound engagement, link or update `.fde/evals.md`. Standalone work does not require a customer record. A synthetic demo result does not establish production readiness. **Minimum pack (do not grow until the minimum exists):** 1. **Component + quality bar** - one sentence each; kill switch / fallback named. diff --git a/skills/fde/references/fintech.md b/skills/fde/references/fintech.md index db1d3ad..bec640f 100644 --- a/skills/fde/references/fintech.md +++ b/skills/fde/references/fintech.md @@ -2,7 +2,7 @@ **Activate when you hear:** payments, transfers, settlements, reconciliation · PCI-DSS, PSD2, SOX, open banking, SWIFT · banking, lending, insurance, trading, crypto · "we handle money" in any form. Loads **alongside** the active phase, never instead of it. -**Read first:** `trust-profile.md` always - data classification and AI policy before any action. `terrain.md` only when reviewing transaction/cardholder code. +**Read first:** apply [task context](task-context.md). Use permitted data-classification and AI-policy evidence from the supplied brief or existing `trust-profile.md`; use `terrain.md` when reviewing transaction/cardholder code. Resolve missing permissions before the affected action; continue independent analysis using permitted evidence. Financial systems carry a failure class others don't: **silent money loss.** A bug that processes a payment twice or drops a transaction is regulatory breach + customer harm + potential criminal liability, not a defect ticket. diff --git a/skills/fde/references/land.md b/skills/fde/references/land.md index 1b1210c..16226af 100644 --- a/skills/fde/references/land.md +++ b/skills/fde/references/land.md @@ -4,6 +4,8 @@ **Read first:** apply [task context](task-context.md), then permitted `context.md` evidence if it exists and the supplied brief. Once the engagement type and AI/access policy are known, inspect the supplied repo/docs relevant to the ask before asking questions they can answer. This is a bounded evidence check, not a full discovery scan. +**Bounded engagement:** A new customer does not automatically require a full landing exercise. For a single-outcome task or simulation of any duration, use the supplied brief to establish the outcome, deadline, permitted inputs, acceptance and next authorized action. If those are clear, route to the working task immediately. If one material gap remains, investigate that gap; do not build a stakeholder map or populate engagement files for their own sake. A simulated stakeholder does not justify invented meetings or approval chains. Keep actual data and release authority checks where they affect the work. + ## Validation gate (confirm understanding, clarify where it elevates) Before landing, state what you know in 2-3 lines: @@ -12,7 +14,7 @@ Before landing, state what you know in 2-3 lines: Then check - probe ONLY if it prevents a bad start: -1. **Engagement speed.** If timeline is unclear → weave it in naturally: "Is this days, weeks, or months? That shapes how much structure we set up now." +1. **Deadline and scope.** Ask about timing only when it changes the next action: "What result is needed by when?" Use uncertainty, dependencies, risk and access to choose the necessary structure; duration alone does not decide it. 2. **Existing context.** If `.fde/` already exists → one line: "There's existing engagement memory here. Continuing this or starting fresh?" 3. **Access.** If the FDE is about to start work → one line: "Got repo and environment access sorted, or is that still pending?" diff --git a/skills/fde/references/plan.md b/skills/fde/references/plan.md index 0da761d..58fbb2c 100644 --- a/skills/fde/references/plan.md +++ b/skills/fde/references/plan.md @@ -4,7 +4,9 @@ **Enter when:** scope is understood and the work needs breaking down - a slice, a phase, or the whole delivery. -**Read first:** `reality.md`, `success.md`, `terrain.md`, `stakeholders.md`. Load `business-case.md` if poc produced one. Not the full folder. +**Read first, when an engagement record exists:** the relevant parts of `reality.md`, `success.md`, `terrain.md`, and `stakeholders.md`. Load `business-case.md` only when its cost case affects this decision. For standalone work, use the supplied context; absent records are not a blocker. + +**Bounded path:** If implementation is requested and authorized, and the outcome, constraints and acceptance checks already support one bounded change, the coordinator can select `build` without a separate planning exercise. An explicit planning request still returns a plan; it does not authorize implementation or require another installed skill. If a bounded task genuinely needs sequencing, give the FDE a brief plan with the next working slice, its boundary, a success and failure check, and the blocking unknown or authority if any. Spend the time on the working result. A single-slice plan does not require a new engagement record, stakeholder map or multi-phase template. **On an initialized engagement, before a new delivery plan or material scope change:** run `fde doctor --ready`. For standalone planning, check the supplied outcome, scope, acceptance and authority directly; do not initialize records to run this validator. Missing acceptance criteria or authority blocks the affected implementation commitment, not a provisional plan. Draft proposed checks and next steps, mark them pending, and ask only what changes the next action. Use a test/input and observable pass/fail under **Done when:** or **Acceptance check:**. A number, role, or successful demo alone is insufficient. Do not invent missing facts to pass lint. Routine reversible fixes within confirmed scope reuse the existing signer, acceptance criteria, and engineering plan; record verification without reopening settled decisions. @@ -46,7 +48,7 @@ Preserve supplied ticket identifiers and blocking dependencies; do not renumber **6. Agree useful stakeholder touchpoints.** Name who needs to see which result before the next decision. Reuse the customer's existing review cadence; task count alone does not justify another meeting or imply lost trust. -**7. End with a kill list.** Every plan names what you will **not** do this phase. If everything is "later," you have no plan - you have a wish list. Keep **Now** small enough to review and act on; split by independently verifiable outcomes. +**7. Bound a multi-slice plan.** For a phased engagement, name consequential work excluded from this phase. Do not invent a kill list for one bounded slice. Keep **Now** small enough to review and act on; split by independently verifiable outcomes. Carry the agreed acceptance checks and their source into implementation and verification, preferably by linking the existing record. Added checks may strengthen coverage; changing a threshold or removing a requirement remains a proposal until the appropriate decision-maker approves the change with a dated source. Record what changed and why; a passing weaker test does not satisfy the original agreement. @@ -56,7 +58,7 @@ Carry the agreed acceptance checks and their source into implementation and veri For standalone planning, return the requested draft or save to the authorized project document. In a bound engagement, propose the plan for **`decisions.md`** under its confirmation rules, or link the existing approved plan; do not duplicate it. -A plan is **not done** until all four blocks exist: +For a single-slice plan, the brief slice, boundary, acceptance checks, verification and any blocking dependency are enough. Use the full four-block format below when sequencing several slices or decisions with material dependencies, regardless of engagement duration: ```markdown ## Plan - @@ -92,7 +94,7 @@ In `Who accepted`, distinguish a proposed deferral from an agreement: use `pendi Check the plan against every supplied requirement and constraint. Each must map to a task and acceptance check, an explicitly accepted exclusion, or a visible unresolved decision. Do not silently omit a requirement to simplify the plan. Reuse an existing approved plan rather than creating a second coverage record. If no work is deferred, say so; do not invent exclusions to fill the template. ## Checkpoint -Walk the FDE through: sequence + why this order, where the fragile work sits, where the touchpoints land, the acceptance gate and **Kill if** on task 1, and the kill list. State who sees the first slice and when, which exclusions are accepted or proposed, and what observation stops task 1. Reuse supplied answers; ask only about a missing or consequentially ambiguous answer. +For a single-slice plan, state the first slice, how it will be checked, and what would stop it. For a phased plan, walk the FDE through the sequence, fragile work, useful touchpoints, acceptance gate, and consequential exclusions. Reuse supplied answers; ask only about a missing or consequentially ambiguous answer. ## Method - estimation (when the sponsor asks "how long, how much?") @@ -157,7 +159,7 @@ First visible slice goes to Marco, not Priya: he is the one whose morning change - Fragile zones early. Fail fast. - Touchpoints serve the next customer decision and agreed cadence. - No written acceptance criteria, no build. -- No kill list, no finished plan. +- Make consequential exclusions explicit when work is deferred; a bounded slice needs no invented kill list. - No **Kill if** on a Now PR, that PR is hope. - Estimates are ranges, not promises. Name the assumptions and the observation that voids them. - Migrations: compatibility determines order; verified recovery precedes cutover. diff --git a/skills/fde/references/task-context.md b/skills/fde/references/task-context.md index d313522..1b8314a 100644 --- a/skills/fde/references/task-context.md +++ b/skills/fde/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/feedback/.fde-generated.json b/skills/feedback/.fde-generated.json index 1df5d9c..9af38a3 100644 --- a/skills/feedback/.fde-generated.json +++ b/skills/feedback/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "7d49a9e89736e35c2aaf10c78b10be365bdf91af1aaf99430de6069e96069d55", "agents/openai.yaml": "6b8d024e9ea9676a2607b76a6f1fcd2fbcba585af2990b1172dbdb8cec0364c6", "references/encode-pattern.md": "10fc5679752f0ea0b4d3004e4c7e282bb17f9b496ab99e5c7aae04ac942fb3c1", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/feedback/references/task-context.md b/skills/feedback/references/task-context.md index d313522..1b8314a 100644 --- a/skills/feedback/references/task-context.md +++ b/skills/feedback/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/handoff/.fde-generated.json b/skills/handoff/.fde-generated.json index 36f1380..f0d90e3 100644 --- a/skills/handoff/.fde-generated.json +++ b/skills/handoff/.fde-generated.json @@ -6,7 +6,7 @@ "agents/openai.yaml": "93ac049cf1a9d0fdfdf67d34ca6d3dd33800e91334f38bb303828eab8c4b3aaf", "references/close.md": "4c75697bb7c85af3b4054bf427d0f265d388972a3139f1e25a1bc9f56ac65cf4", "references/encode-pattern.md": "10fc5679752f0ea0b4d3004e4c7e282bb17f9b496ab99e5c7aae04ac942fb3c1", - "references/land.md": "87dfffc8e39d35eaf23d510ba7e9913d48e90d2705eb9155ab192d12ea98d18d", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/land.md": "f33f1b9e03a3c23c39ffce925a8f8b956b48a53982f55246752a48a317cb084d", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/handoff/references/land.md b/skills/handoff/references/land.md index 1b1210c..16226af 100644 --- a/skills/handoff/references/land.md +++ b/skills/handoff/references/land.md @@ -4,6 +4,8 @@ **Read first:** apply [task context](task-context.md), then permitted `context.md` evidence if it exists and the supplied brief. Once the engagement type and AI/access policy are known, inspect the supplied repo/docs relevant to the ask before asking questions they can answer. This is a bounded evidence check, not a full discovery scan. +**Bounded engagement:** A new customer does not automatically require a full landing exercise. For a single-outcome task or simulation of any duration, use the supplied brief to establish the outcome, deadline, permitted inputs, acceptance and next authorized action. If those are clear, route to the working task immediately. If one material gap remains, investigate that gap; do not build a stakeholder map or populate engagement files for their own sake. A simulated stakeholder does not justify invented meetings or approval chains. Keep actual data and release authority checks where they affect the work. + ## Validation gate (confirm understanding, clarify where it elevates) Before landing, state what you know in 2-3 lines: @@ -12,7 +14,7 @@ Before landing, state what you know in 2-3 lines: Then check - probe ONLY if it prevents a bad start: -1. **Engagement speed.** If timeline is unclear → weave it in naturally: "Is this days, weeks, or months? That shapes how much structure we set up now." +1. **Deadline and scope.** Ask about timing only when it changes the next action: "What result is needed by when?" Use uncertainty, dependencies, risk and access to choose the necessary structure; duration alone does not decide it. 2. **Existing context.** If `.fde/` already exists → one line: "There's existing engagement memory here. Continuing this or starting fresh?" 3. **Access.** If the FDE is about to start work → one line: "Got repo and environment access sorted, or is that still pending?" diff --git a/skills/handoff/references/task-context.md b/skills/handoff/references/task-context.md index d313522..1b8314a 100644 --- a/skills/handoff/references/task-context.md +++ b/skills/handoff/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/ingest/.fde-generated.json b/skills/ingest/.fde-generated.json index 9dddbea..07c01d5 100644 --- a/skills/ingest/.fde-generated.json +++ b/skills/ingest/.fde-generated.json @@ -8,6 +8,6 @@ "references/debrief.md": "2e8e929f1c741e1a7250ad720dfa2196e1f8b14ae84f17e406c38910b9b83376", "references/ingest.md": "2aaf948f6ae19fb472a2bf101b8064fc04e3c1103b874455b5a4457b5c69cf86", "references/source-setup.md": "a28ae7c6dbb2573a66f31b30b7abca34bc52573fe34d48fff4c7490e4dc85d3e", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/ingest/references/task-context.md b/skills/ingest/references/task-context.md index d313522..1b8314a 100644 --- a/skills/ingest/references/task-context.md +++ b/skills/ingest/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/integrate/.fde-generated.json b/skills/integrate/.fde-generated.json index a07bb8e..8e88ca3 100644 --- a/skills/integrate/.fde-generated.json +++ b/skills/integrate/.fde-generated.json @@ -11,7 +11,7 @@ "references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e", "references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a", "references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/integrate/references/task-context.md b/skills/integrate/references/task-context.md index d313522..1b8314a 100644 --- a/skills/integrate/references/task-context.md +++ b/skills/integrate/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/options/.fde-generated.json b/skills/options/.fde-generated.json index 6d6aa01..a02b9df 100644 --- a/skills/options/.fde-generated.json +++ b/skills/options/.fde-generated.json @@ -5,7 +5,7 @@ "SKILL.md": "0c51c5421875b17c66c4fdb03a33e3705da52a0c649dd138c4c4cd3f3c92292a", "agents/openai.yaml": "ff5da2d5215943e5c4e2a1339c11101035ed2741ded38e443af5180239e2a24b", "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/test-assumptions.md": "977acbf88dc0468afeb0fb222fae88100ee6a5078a729e0651c28a45870e3925", "references/three-options.md": "2c979027c09af936f9a50446721e344f15e3e3bf43d3c1b7b0b85240747168c4" } diff --git a/skills/options/references/task-context.md b/skills/options/references/task-context.md index d313522..1b8314a 100644 --- a/skills/options/references/task-context.md +++ b/skills/options/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/plan/.fde-generated.json b/skills/plan/.fde-generated.json index 370726d..9925e8c 100644 --- a/skills/plan/.fde-generated.json +++ b/skills/plan/.fde-generated.json @@ -5,7 +5,7 @@ "SKILL.md": "88254d8bc2f58f4fcdd610dd7c111854dccf3ef488cfae85a4f81e90e25d1c96", "agents/openai.yaml": "09f79a8a6f59741be07ae42adb9187ef790c1c4dd0341adc22ca70cd043e9ac1", "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25", - "references/plan.md": "f5c456b5e2c00a6a44fdf94935b143f3b5271c31187bf06d09eae724f9d466fa", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/plan.md": "5f0330ab7195a5dec406463824b2c00dd013b70626ec52f7de4dfa0d401c1575", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/plan/references/plan.md b/skills/plan/references/plan.md index 0da761d..58fbb2c 100644 --- a/skills/plan/references/plan.md +++ b/skills/plan/references/plan.md @@ -4,7 +4,9 @@ **Enter when:** scope is understood and the work needs breaking down - a slice, a phase, or the whole delivery. -**Read first:** `reality.md`, `success.md`, `terrain.md`, `stakeholders.md`. Load `business-case.md` if poc produced one. Not the full folder. +**Read first, when an engagement record exists:** the relevant parts of `reality.md`, `success.md`, `terrain.md`, and `stakeholders.md`. Load `business-case.md` only when its cost case affects this decision. For standalone work, use the supplied context; absent records are not a blocker. + +**Bounded path:** If implementation is requested and authorized, and the outcome, constraints and acceptance checks already support one bounded change, the coordinator can select `build` without a separate planning exercise. An explicit planning request still returns a plan; it does not authorize implementation or require another installed skill. If a bounded task genuinely needs sequencing, give the FDE a brief plan with the next working slice, its boundary, a success and failure check, and the blocking unknown or authority if any. Spend the time on the working result. A single-slice plan does not require a new engagement record, stakeholder map or multi-phase template. **On an initialized engagement, before a new delivery plan or material scope change:** run `fde doctor --ready`. For standalone planning, check the supplied outcome, scope, acceptance and authority directly; do not initialize records to run this validator. Missing acceptance criteria or authority blocks the affected implementation commitment, not a provisional plan. Draft proposed checks and next steps, mark them pending, and ask only what changes the next action. Use a test/input and observable pass/fail under **Done when:** or **Acceptance check:**. A number, role, or successful demo alone is insufficient. Do not invent missing facts to pass lint. Routine reversible fixes within confirmed scope reuse the existing signer, acceptance criteria, and engineering plan; record verification without reopening settled decisions. @@ -46,7 +48,7 @@ Preserve supplied ticket identifiers and blocking dependencies; do not renumber **6. Agree useful stakeholder touchpoints.** Name who needs to see which result before the next decision. Reuse the customer's existing review cadence; task count alone does not justify another meeting or imply lost trust. -**7. End with a kill list.** Every plan names what you will **not** do this phase. If everything is "later," you have no plan - you have a wish list. Keep **Now** small enough to review and act on; split by independently verifiable outcomes. +**7. Bound a multi-slice plan.** For a phased engagement, name consequential work excluded from this phase. Do not invent a kill list for one bounded slice. Keep **Now** small enough to review and act on; split by independently verifiable outcomes. Carry the agreed acceptance checks and their source into implementation and verification, preferably by linking the existing record. Added checks may strengthen coverage; changing a threshold or removing a requirement remains a proposal until the appropriate decision-maker approves the change with a dated source. Record what changed and why; a passing weaker test does not satisfy the original agreement. @@ -56,7 +58,7 @@ Carry the agreed acceptance checks and their source into implementation and veri For standalone planning, return the requested draft or save to the authorized project document. In a bound engagement, propose the plan for **`decisions.md`** under its confirmation rules, or link the existing approved plan; do not duplicate it. -A plan is **not done** until all four blocks exist: +For a single-slice plan, the brief slice, boundary, acceptance checks, verification and any blocking dependency are enough. Use the full four-block format below when sequencing several slices or decisions with material dependencies, regardless of engagement duration: ```markdown ## Plan - @@ -92,7 +94,7 @@ In `Who accepted`, distinguish a proposed deferral from an agreement: use `pendi Check the plan against every supplied requirement and constraint. Each must map to a task and acceptance check, an explicitly accepted exclusion, or a visible unresolved decision. Do not silently omit a requirement to simplify the plan. Reuse an existing approved plan rather than creating a second coverage record. If no work is deferred, say so; do not invent exclusions to fill the template. ## Checkpoint -Walk the FDE through: sequence + why this order, where the fragile work sits, where the touchpoints land, the acceptance gate and **Kill if** on task 1, and the kill list. State who sees the first slice and when, which exclusions are accepted or proposed, and what observation stops task 1. Reuse supplied answers; ask only about a missing or consequentially ambiguous answer. +For a single-slice plan, state the first slice, how it will be checked, and what would stop it. For a phased plan, walk the FDE through the sequence, fragile work, useful touchpoints, acceptance gate, and consequential exclusions. Reuse supplied answers; ask only about a missing or consequentially ambiguous answer. ## Method - estimation (when the sponsor asks "how long, how much?") @@ -157,7 +159,7 @@ First visible slice goes to Marco, not Priya: he is the one whose morning change - Fragile zones early. Fail fast. - Touchpoints serve the next customer decision and agreed cadence. - No written acceptance criteria, no build. -- No kill list, no finished plan. +- Make consequential exclusions explicit when work is deferred; a bounded slice needs no invented kill list. - No **Kill if** on a Now PR, that PR is hope. - Estimates are ranges, not promises. Name the assumptions and the observation that voids them. - Migrations: compatibility determines order; verified recovery precedes cutover. diff --git a/skills/plan/references/task-context.md b/skills/plan/references/task-context.md index d313522..1b8314a 100644 --- a/skills/plan/references/task-context.md +++ b/skills/plan/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/poc/.fde-generated.json b/skills/poc/.fde-generated.json index 8ab52ca..86c3cca 100644 --- a/skills/poc/.fde-generated.json +++ b/skills/poc/.fde-generated.json @@ -11,12 +11,12 @@ "references/discover.md": "f65aa11a539b4dbbed70cfaa94ec2a35595aa9a2d0282790510b933ac9c721ce", "references/eval-pack.md": "0590b85d3cae0903c6b1274540c92eaa2a4373047e8a0548d6942516ef0bb9e1", "references/integrate.md": "1cb7a60d7545b0bf224fce678a04ce6ccdf368c47877d9c8e4dc4272bb0d5b0c", - "references/plan.md": "f5c456b5e2c00a6a44fdf94935b143f3b5271c31187bf06d09eae724f9d466fa", + "references/plan.md": "5f0330ab7195a5dec406463824b2c00dd013b70626ec52f7de4dfa0d401c1575", "references/poc.md": "65c91866037dc034a64484683ad9a329896786f1487265c9fddecd19b09a3039", "references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e", "references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a", "references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/test-assumptions.md": "977acbf88dc0468afeb0fb222fae88100ee6a5078a729e0651c28a45870e3925", "references/three-options.md": "2c979027c09af936f9a50446721e344f15e3e3bf43d3c1b7b0b85240747168c4", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" diff --git a/skills/poc/references/plan.md b/skills/poc/references/plan.md index 0da761d..58fbb2c 100644 --- a/skills/poc/references/plan.md +++ b/skills/poc/references/plan.md @@ -4,7 +4,9 @@ **Enter when:** scope is understood and the work needs breaking down - a slice, a phase, or the whole delivery. -**Read first:** `reality.md`, `success.md`, `terrain.md`, `stakeholders.md`. Load `business-case.md` if poc produced one. Not the full folder. +**Read first, when an engagement record exists:** the relevant parts of `reality.md`, `success.md`, `terrain.md`, and `stakeholders.md`. Load `business-case.md` only when its cost case affects this decision. For standalone work, use the supplied context; absent records are not a blocker. + +**Bounded path:** If implementation is requested and authorized, and the outcome, constraints and acceptance checks already support one bounded change, the coordinator can select `build` without a separate planning exercise. An explicit planning request still returns a plan; it does not authorize implementation or require another installed skill. If a bounded task genuinely needs sequencing, give the FDE a brief plan with the next working slice, its boundary, a success and failure check, and the blocking unknown or authority if any. Spend the time on the working result. A single-slice plan does not require a new engagement record, stakeholder map or multi-phase template. **On an initialized engagement, before a new delivery plan or material scope change:** run `fde doctor --ready`. For standalone planning, check the supplied outcome, scope, acceptance and authority directly; do not initialize records to run this validator. Missing acceptance criteria or authority blocks the affected implementation commitment, not a provisional plan. Draft proposed checks and next steps, mark them pending, and ask only what changes the next action. Use a test/input and observable pass/fail under **Done when:** or **Acceptance check:**. A number, role, or successful demo alone is insufficient. Do not invent missing facts to pass lint. Routine reversible fixes within confirmed scope reuse the existing signer, acceptance criteria, and engineering plan; record verification without reopening settled decisions. @@ -46,7 +48,7 @@ Preserve supplied ticket identifiers and blocking dependencies; do not renumber **6. Agree useful stakeholder touchpoints.** Name who needs to see which result before the next decision. Reuse the customer's existing review cadence; task count alone does not justify another meeting or imply lost trust. -**7. End with a kill list.** Every plan names what you will **not** do this phase. If everything is "later," you have no plan - you have a wish list. Keep **Now** small enough to review and act on; split by independently verifiable outcomes. +**7. Bound a multi-slice plan.** For a phased engagement, name consequential work excluded from this phase. Do not invent a kill list for one bounded slice. Keep **Now** small enough to review and act on; split by independently verifiable outcomes. Carry the agreed acceptance checks and their source into implementation and verification, preferably by linking the existing record. Added checks may strengthen coverage; changing a threshold or removing a requirement remains a proposal until the appropriate decision-maker approves the change with a dated source. Record what changed and why; a passing weaker test does not satisfy the original agreement. @@ -56,7 +58,7 @@ Carry the agreed acceptance checks and their source into implementation and veri For standalone planning, return the requested draft or save to the authorized project document. In a bound engagement, propose the plan for **`decisions.md`** under its confirmation rules, or link the existing approved plan; do not duplicate it. -A plan is **not done** until all four blocks exist: +For a single-slice plan, the brief slice, boundary, acceptance checks, verification and any blocking dependency are enough. Use the full four-block format below when sequencing several slices or decisions with material dependencies, regardless of engagement duration: ```markdown ## Plan - @@ -92,7 +94,7 @@ In `Who accepted`, distinguish a proposed deferral from an agreement: use `pendi Check the plan against every supplied requirement and constraint. Each must map to a task and acceptance check, an explicitly accepted exclusion, or a visible unresolved decision. Do not silently omit a requirement to simplify the plan. Reuse an existing approved plan rather than creating a second coverage record. If no work is deferred, say so; do not invent exclusions to fill the template. ## Checkpoint -Walk the FDE through: sequence + why this order, where the fragile work sits, where the touchpoints land, the acceptance gate and **Kill if** on task 1, and the kill list. State who sees the first slice and when, which exclusions are accepted or proposed, and what observation stops task 1. Reuse supplied answers; ask only about a missing or consequentially ambiguous answer. +For a single-slice plan, state the first slice, how it will be checked, and what would stop it. For a phased plan, walk the FDE through the sequence, fragile work, useful touchpoints, acceptance gate, and consequential exclusions. Reuse supplied answers; ask only about a missing or consequentially ambiguous answer. ## Method - estimation (when the sponsor asks "how long, how much?") @@ -157,7 +159,7 @@ First visible slice goes to Marco, not Priya: he is the one whose morning change - Fragile zones early. Fail fast. - Touchpoints serve the next customer decision and agreed cadence. - No written acceptance criteria, no build. -- No kill list, no finished plan. +- Make consequential exclusions explicit when work is deferred; a bounded slice needs no invented kill list. - No **Kill if** on a Now PR, that PR is hope. - Estimates are ranges, not promises. Name the assumptions and the observation that voids them. - Migrations: compatibility determines order; verified recovery precedes cutover. diff --git a/skills/poc/references/task-context.md b/skills/poc/references/task-context.md index d313522..1b8314a 100644 --- a/skills/poc/references/task-context.md +++ b/skills/poc/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/prioritize/.fde-generated.json b/skills/prioritize/.fde-generated.json index 733f765..430e6be 100644 --- a/skills/prioritize/.fde-generated.json +++ b/skills/prioritize/.fde-generated.json @@ -6,6 +6,6 @@ "agents/openai.yaml": "3cfc01668b1bc6ec42d429e9730c68fd01520a7d15ea4289dee265e16bcd6b55", "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25", "references/pick-three.md": "c64a04fd0724b28701bbe334f444d0df93da4d858de993e82ccae04e48b66db9", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/prioritize/references/task-context.md b/skills/prioritize/references/task-context.md index d313522..1b8314a 100644 --- a/skills/prioritize/references/task-context.md +++ b/skills/prioritize/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/qa/.fde-generated.json b/skills/qa/.fde-generated.json index 9ce2524..6decdd1 100644 --- a/skills/qa/.fde-generated.json +++ b/skills/qa/.fde-generated.json @@ -11,7 +11,7 @@ "references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e", "references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a", "references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/qa/references/task-context.md b/skills/qa/references/task-context.md index d313522..1b8314a 100644 --- a/skills/qa/references/task-context.md +++ b/skills/qa/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/readout/.fde-generated.json b/skills/readout/.fde-generated.json index 1ec34a0..6ebe8d9 100644 --- a/skills/readout/.fde-generated.json +++ b/skills/readout/.fde-generated.json @@ -7,6 +7,6 @@ "references/board-memo.md": "44eb3c27f164da63af694591025b3fc96bb23d149c29de400997c1653e3322f8", "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25", "references/readout.md": "485301ef5e6e333f0272aec0b6428839077341b228506c6e77f79cce22399903", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/readout/references/task-context.md b/skills/readout/references/task-context.md index d313522..1b8314a 100644 --- a/skills/readout/references/task-context.md +++ b/skills/readout/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/red-team/.fde-generated.json b/skills/red-team/.fde-generated.json index 54043d0..24e4208 100644 --- a/skills/red-team/.fde-generated.json +++ b/skills/red-team/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "e406016f3cf7b715084bde0081bec03706a695e6272ada2e51ff3cb9d5194de5", "agents/openai.yaml": "c6cac62d94f5294f981de12539dca0a8aa601cea3357fedd94083f4fd1cb0d48", "references/red-team.md": "31aaa96f2bac337daa8fc8abf1ddbef745d7ab7a8b77776d2fbb2dd59f4782ce", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/red-team/references/task-context.md b/skills/red-team/references/task-context.md index d313522..1b8314a 100644 --- a/skills/red-team/references/task-context.md +++ b/skills/red-team/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/rescue/.fde-generated.json b/skills/rescue/.fde-generated.json index 7818879..bcd6d31 100644 --- a/skills/rescue/.fde-generated.json +++ b/skills/rescue/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "de58cdfb46219c71c85b4e940bffe0e52d8511f4dede803d0efe1bf46aa5ac5c", "agents/openai.yaml": "d88d5433332c8269c8342589bc88ef9df7b0f7b0224e4b8ee5a00bc5d96f5e2e", "references/rescue.md": "3af07633b82dc1022bafc86173f6c55da81501317e25c9ac8980cfcb04b27df3", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/rescue/references/task-context.md b/skills/rescue/references/task-context.md index d313522..1b8314a 100644 --- a/skills/rescue/references/task-context.md +++ b/skills/rescue/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/review/.fde-generated.json b/skills/review/.fde-generated.json index faba3c3..3690150 100644 --- a/skills/review/.fde-generated.json +++ b/skills/review/.fde-generated.json @@ -11,7 +11,7 @@ "references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e", "references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a", "references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/review/references/task-context.md b/skills/review/references/task-context.md index d313522..1b8314a 100644 --- a/skills/review/references/task-context.md +++ b/skills/review/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/rollback/.fde-generated.json b/skills/rollback/.fde-generated.json index 0278a50..1fad8e8 100644 --- a/skills/rollback/.fde-generated.json +++ b/skills/rollback/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "19645edc8853a4b1ca7f3dacbf48ed553d7f630939c81c9254c00808fdebedc8", "agents/openai.yaml": "d8fa5d46f05dd1501993f40b0c8e205f061c5b4de754046d9059cb0c3d8c88f9", "references/rollback.md": "cdde85caeb8e556825d0c3a156cd16d6e41550931984429e4978486ee91854cd", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/rollback/references/task-context.md b/skills/rollback/references/task-context.md index d313522..1b8314a 100644 --- a/skills/rollback/references/task-context.md +++ b/skills/rollback/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/runbook/.fde-generated.json b/skills/runbook/.fde-generated.json index d175b66..9cf5ce5 100644 --- a/skills/runbook/.fde-generated.json +++ b/skills/runbook/.fde-generated.json @@ -6,9 +6,9 @@ "agents/openai.yaml": "53922bbe55ba23dc812c9bef311fbef238e2e25252100bdac7a8bd4f6c5e2780", "references/close.md": "4c75697bb7c85af3b4054bf427d0f265d388972a3139f1e25a1bc9f56ac65cf4", "references/encode-pattern.md": "10fc5679752f0ea0b4d3004e4c7e282bb17f9b496ab99e5c7aae04ac942fb3c1", - "references/land.md": "87dfffc8e39d35eaf23d510ba7e9913d48e90d2705eb9155ab192d12ea98d18d", + "references/land.md": "f33f1b9e03a3c23c39ffce925a8f8b956b48a53982f55246752a48a317cb084d", "references/runbook.md": "d32a40113941c603b97f09eabfd0e25afd25129102c6b07fa91a04fb4f8e93e7", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/runbook/references/land.md b/skills/runbook/references/land.md index 1b1210c..16226af 100644 --- a/skills/runbook/references/land.md +++ b/skills/runbook/references/land.md @@ -4,6 +4,8 @@ **Read first:** apply [task context](task-context.md), then permitted `context.md` evidence if it exists and the supplied brief. Once the engagement type and AI/access policy are known, inspect the supplied repo/docs relevant to the ask before asking questions they can answer. This is a bounded evidence check, not a full discovery scan. +**Bounded engagement:** A new customer does not automatically require a full landing exercise. For a single-outcome task or simulation of any duration, use the supplied brief to establish the outcome, deadline, permitted inputs, acceptance and next authorized action. If those are clear, route to the working task immediately. If one material gap remains, investigate that gap; do not build a stakeholder map or populate engagement files for their own sake. A simulated stakeholder does not justify invented meetings or approval chains. Keep actual data and release authority checks where they affect the work. + ## Validation gate (confirm understanding, clarify where it elevates) Before landing, state what you know in 2-3 lines: @@ -12,7 +14,7 @@ Before landing, state what you know in 2-3 lines: Then check - probe ONLY if it prevents a bad start: -1. **Engagement speed.** If timeline is unclear → weave it in naturally: "Is this days, weeks, or months? That shapes how much structure we set up now." +1. **Deadline and scope.** Ask about timing only when it changes the next action: "What result is needed by when?" Use uncertainty, dependencies, risk and access to choose the necessary structure; duration alone does not decide it. 2. **Existing context.** If `.fde/` already exists → one line: "There's existing engagement memory here. Continuing this or starting fresh?" 3. **Access.** If the FDE is about to start work → one line: "Got repo and environment access sorted, or is that still pending?" diff --git a/skills/runbook/references/task-context.md b/skills/runbook/references/task-context.md index d313522..1b8314a 100644 --- a/skills/runbook/references/task-context.md +++ b/skills/runbook/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/scope/.fde-generated.json b/skills/scope/.fde-generated.json index 7033d32..598464f 100644 --- a/skills/scope/.fde-generated.json +++ b/skills/scope/.fde-generated.json @@ -5,6 +5,6 @@ "SKILL.md": "544424180d2e924e21e98e94c1d6a35c067176ff9876f6c11415638e041f89f5", "agents/openai.yaml": "22b669e628e4401c6b042d17fca25f0259593d90a581e232816c140e788306ec", "references/hold-scope.md": "651ba25570401ceda8dc518d1037f1644ee09a0166609b93d437164e4dc45837", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/scope/references/task-context.md b/skills/scope/references/task-context.md index d313522..1b8314a 100644 --- a/skills/scope/references/task-context.md +++ b/skills/scope/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/score-use-cases/.fde-generated.json b/skills/score-use-cases/.fde-generated.json index 78065b3..e0db33a 100644 --- a/skills/score-use-cases/.fde-generated.json +++ b/skills/score-use-cases/.fde-generated.json @@ -6,6 +6,6 @@ "agents/openai.yaml": "8f4af12758edb1a4648bb7917ef4c52eb4eb209a3917ae3e04904cdd5fd4dec0", "references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25", "references/score-use-cases.md": "a8352b0886731a647fdb0305b22eaa83244f367d797e130ceb3271f112886801", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e" + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd" } } diff --git a/skills/score-use-cases/references/task-context.md b/skills/score-use-cases/references/task-context.md index d313522..1b8314a 100644 --- a/skills/score-use-cases/references/task-context.md +++ b/skills/score-use-cases/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/ship/.fde-generated.json b/skills/ship/.fde-generated.json index dc2ceaa..10e70f1 100644 --- a/skills/ship/.fde-generated.json +++ b/skills/ship/.fde-generated.json @@ -11,7 +11,7 @@ "references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e", "references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a", "references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/ship/references/task-context.md b/skills/ship/references/task-context.md index d313522..1b8314a 100644 --- a/skills/ship/references/task-context.md +++ b/skills/ship/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/switch-clients/.fde-generated.json b/skills/switch-clients/.fde-generated.json index 30a1bcc..232609a 100644 --- a/skills/switch-clients/.fde-generated.json +++ b/skills/switch-clients/.fde-generated.json @@ -5,7 +5,7 @@ "SKILL.md": "ebfebe6e5872800c749659aec45af48b2287db2e72c0b914118482e4c73334b5", "agents/openai.yaml": "67ecd37a1e5bd57986d800a782aeff8d00171d6d09794b6026d8daf1e2d91e6f", "references/switch-clients.md": "4c13df4441182f6ef9455e0abed4facdb6d1c99dd5d10de278708f0bc07f631f", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6" } } diff --git a/skills/switch-clients/references/task-context.md b/skills/switch-clients/references/task-context.md index d313522..1b8314a 100644 --- a/skills/switch-clients/references/task-context.md +++ b/skills/switch-clients/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/test-assumptions/.fde-generated.json b/skills/test-assumptions/.fde-generated.json index d42037c..c7bf4fa 100644 --- a/skills/test-assumptions/.fde-generated.json +++ b/skills/test-assumptions/.fde-generated.json @@ -4,7 +4,7 @@ "files": { "SKILL.md": "acba10ec77763f1840c3cda95b26e13150683f6a7557a84a93611f2d96cdd389", "agents/openai.yaml": "c67e0342caba79241b1872cdfda8341f4949c2bd7672b8d288b529d8e94342b8", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/test-assumptions.md": "977acbf88dc0468afeb0fb222fae88100ee6a5078a729e0651c28a45870e3925" } } diff --git a/skills/test-assumptions/references/task-context.md b/skills/test-assumptions/references/task-context.md index d313522..1b8314a 100644 --- a/skills/test-assumptions/references/task-context.md +++ b/skills/test-assumptions/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/what-breaks/.fde-generated.json b/skills/what-breaks/.fde-generated.json index efc9112..53f43ad 100644 --- a/skills/what-breaks/.fde-generated.json +++ b/skills/what-breaks/.fde-generated.json @@ -4,7 +4,7 @@ "files": { "SKILL.md": "cacffe6b01d36cde634be5e7f8a2127d701d3dac90b3000c414a648956839c5e", "agents/openai.yaml": "6c4b97d3268698d1eed0b628f9872351f29b91dd47c9de371a12c584983cb0fe", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/what-breaks.md": "fbf85539fe9c762d713c5772dbef731e96783d369610ba61b66fc220d9e50abf" } } diff --git a/skills/what-breaks/references/task-context.md b/skills/what-breaks/references/task-context.md index d313522..1b8314a 100644 --- a/skills/what-breaks/references/task-context.md +++ b/skills/what-breaks/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record. diff --git a/skills/who-decides/.fde-generated.json b/skills/who-decides/.fde-generated.json index ad636e9..9b23e46 100644 --- a/skills/who-decides/.fde-generated.json +++ b/skills/who-decides/.fde-generated.json @@ -4,7 +4,7 @@ "files": { "SKILL.md": "f5c97755bdeb42cd18dbc1fc79f1d311521efe99fb599d4ebd72b21b6d1dee74", "agents/openai.yaml": "fee09f0f2cc7d0c07a1aefa592e10f046abb8951f157ca3336a6233edd3a61ea", - "references/task-context.md": "9f995c1fe4d8a27d313b4c008a943fbcdd150029358c70b450dbbfb303a2666e", + "references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd", "references/who-decides.md": "fa1f65d921943e76f42284570004a603488905417d96b4bd52dc6c4a11dd5a97" } } diff --git a/skills/who-decides/references/task-context.md b/skills/who-decides/references/task-context.md index d313522..1b8314a 100644 --- a/skills/who-decides/references/task-context.md +++ b/skills/who-decides/references/task-context.md @@ -3,6 +3,7 @@ Use this contract for standalone methods and methods routed through `@fde`. - **Standalone work:** use the supplied, permitted facts, notes, code, and artifacts. A client name, `.fde/` directory, or initialized engagement is not a prerequisite for work on supplied context. Tasks that inspect actual records need those records; staging or saving requires a selected customer. Never fabricate records to make an operational task appear complete. Do not bootstrap records merely to run a method. Ask only for missing information or authority that changes the next action; mark other gaps as unknown. +- **Fit the method to the engagement:** choose the smallest useful next action from the outcome, uncertainty, dependencies, consequence of failure, available access and time. Duration alone does not choose the process: a three-day production change may need more controls than a three-week prototype. Reuse the customer's tools, review cadence and approved evidence; load specialist methods only for a relevant decision or failure. For a simulation, use the supplied actors and constraints without inventing meetings or authority. Expand coordination when dependencies or risk require it, and simplify again when they are resolved. A deadline can reduce scope or change the proposed delivery stage; it cannot silently waive acceptance, data policy or release authority. Judge progress by the requested result and evidence, whether that is a working increment, a resolved decision or a validated finding; record volume is not progress. - **Artifact names are destinations:** names such as `success.md`, `decisions.md`, and `delivery.md` identify relevant evidence and, when bound, record destinations. If absent, use supplied facts and return the requested draft or result in the current workspace or conversation. Do not invent files or require initialization to complete useful work. - **Bound engagement:** honor the current client binding and constraints. Before reading records, run `fde privacy` to verify masking support. Obtain a fresh, identity-matching sanitized `fde resume` packet for this task (or reuse a fresh session-hook packet); retrieve missing evidence with targeted `fde recall `. Use bounded `fde handoff` for transfer work. Refresh after binding, masking, or record changes. Never substitute raw `.fde/` reads, private blocks, masking dictionaries, or full transcripts. If the CLI is unavailable, use only permitted supplied excerpts and report the context limitation. - **Authority:** continue reversible work within authorized scope. Reuse prior authorization when it covers the specific action. Show consequential engagement-record judgments and uncertainties for confirmation before saving unless already explicitly confirmed. New scope, acceptance changes, production actions, exports, and external messages need the applicable authority; a method invocation alone does not supply it. Keep one customer's writes in that customer's record.