fdeops 5.1.21 → 5.1.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/bin/fde.js +17 -5
- package/mcp/fdeops-ingest/package.json +1 -1
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills/audit/.fde-generated.json +1 -1
- package/skills/audit/references/task-context.md +1 -0
- package/skills/board-memo/.fde-generated.json +1 -1
- package/skills/board-memo/references/task-context.md +1 -0
- package/skills/brief/.fde-generated.json +2 -2
- package/skills/brief/references/land.md +3 -1
- package/skills/brief/references/task-context.md +1 -0
- package/skills/build/.fde-generated.json +1 -1
- package/skills/build/references/task-context.md +1 -0
- package/skills/business-case/.fde-generated.json +1 -1
- package/skills/business-case/references/task-context.md +1 -0
- package/skills/connect/.fde-generated.json +1 -1
- package/skills/connect/references/task-context.md +1 -0
- package/skills/dashboard/.fde-generated.json +1 -1
- package/skills/dashboard/references/task-context.md +1 -0
- package/skills/debrief/.fde-generated.json +1 -1
- package/skills/debrief/references/task-context.md +1 -0
- package/skills/debug/.fde-generated.json +1 -1
- package/skills/debug/references/task-context.md +1 -0
- package/skills/demo-prep/.fde-generated.json +1 -1
- package/skills/demo-prep/references/task-context.md +1 -0
- package/skills/discover/.fde-generated.json +1 -1
- package/skills/discover/references/task-context.md +1 -0
- package/skills/earn-trust/.fde-generated.json +1 -1
- package/skills/earn-trust/references/task-context.md +1 -0
- package/skills/evaluate/.fde-generated.json +1 -1
- package/skills/evaluate/references/task-context.md +1 -0
- package/skills/fde/SKILL.md +1 -1
- package/skills/fde/references/ai.md +4 -4
- package/skills/fde/references/fintech.md +1 -1
- package/skills/fde/references/land.md +3 -1
- package/skills/fde/references/pick-three.md +17 -17
- package/skills/fde/references/plan.md +7 -5
- package/skills/fde/references/score-use-cases.md +10 -8
- package/skills/fde/references/task-context.md +1 -0
- package/skills/feedback/.fde-generated.json +1 -1
- package/skills/feedback/references/task-context.md +1 -0
- package/skills/handoff/.fde-generated.json +2 -2
- package/skills/handoff/references/land.md +3 -1
- package/skills/handoff/references/task-context.md +1 -0
- package/skills/ingest/.fde-generated.json +1 -1
- package/skills/ingest/references/task-context.md +1 -0
- package/skills/integrate/.fde-generated.json +1 -1
- package/skills/integrate/references/task-context.md +1 -0
- package/skills/options/.fde-generated.json +1 -1
- package/skills/options/references/task-context.md +1 -0
- package/skills/plan/.fde-generated.json +2 -2
- package/skills/plan/references/plan.md +7 -5
- package/skills/plan/references/task-context.md +1 -0
- package/skills/poc/.fde-generated.json +2 -2
- package/skills/poc/references/plan.md +7 -5
- package/skills/poc/references/task-context.md +1 -0
- package/skills/prioritize/.fde-generated.json +2 -2
- package/skills/prioritize/references/pick-three.md +17 -17
- package/skills/prioritize/references/task-context.md +1 -0
- package/skills/qa/.fde-generated.json +1 -1
- package/skills/qa/references/task-context.md +1 -0
- package/skills/readout/.fde-generated.json +1 -1
- package/skills/readout/references/task-context.md +1 -0
- package/skills/red-team/.fde-generated.json +1 -1
- package/skills/red-team/references/task-context.md +1 -0
- package/skills/rescue/.fde-generated.json +1 -1
- package/skills/rescue/references/task-context.md +1 -0
- package/skills/review/.fde-generated.json +1 -1
- package/skills/review/references/task-context.md +1 -0
- package/skills/rollback/.fde-generated.json +1 -1
- package/skills/rollback/references/task-context.md +1 -0
- package/skills/runbook/.fde-generated.json +2 -2
- package/skills/runbook/references/land.md +3 -1
- package/skills/runbook/references/task-context.md +1 -0
- package/skills/scope/.fde-generated.json +1 -1
- package/skills/scope/references/task-context.md +1 -0
- package/skills/score-use-cases/.fde-generated.json +2 -2
- package/skills/score-use-cases/references/score-use-cases.md +10 -8
- package/skills/score-use-cases/references/task-context.md +1 -0
- package/skills/ship/.fde-generated.json +1 -1
- package/skills/ship/references/task-context.md +1 -0
- package/skills/switch-clients/.fde-generated.json +1 -1
- package/skills/switch-clients/references/task-context.md +1 -0
- package/skills/test-assumptions/.fde-generated.json +1 -1
- package/skills/test-assumptions/references/task-context.md +1 -0
- package/skills/what-breaks/.fde-generated.json +1 -1
- package/skills/what-breaks/references/task-context.md +1 -0
- package/skills/who-decides/.fde-generated.json +1 -1
- package/skills/who-decides/references/task-context.md +1 -0
|
@@ -4,7 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
**Enter when:** scope is understood and the work needs breaking down - a slice, a phase, or the whole delivery.
|
|
6
6
|
|
|
7
|
-
**Read first:** `reality.md`, `success.md`, `terrain.md`, `stakeholders.md`. Load `business-case.md`
|
|
7
|
+
**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.
|
|
8
|
+
|
|
9
|
+
**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.
|
|
8
10
|
|
|
9
11
|
**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.
|
|
10
12
|
|
|
@@ -46,7 +48,7 @@ Preserve supplied ticket identifiers and blocking dependencies; do not renumber
|
|
|
46
48
|
|
|
47
49
|
**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.
|
|
48
50
|
|
|
49
|
-
**7.
|
|
51
|
+
**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.
|
|
50
52
|
|
|
51
53
|
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.
|
|
52
54
|
|
|
@@ -56,7 +58,7 @@ Carry the agreed acceptance checks and their source into implementation and veri
|
|
|
56
58
|
|
|
57
59
|
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.
|
|
58
60
|
|
|
59
|
-
|
|
61
|
+
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:
|
|
60
62
|
|
|
61
63
|
```markdown
|
|
62
64
|
## Plan - <date>
|
|
@@ -92,7 +94,7 @@ In `Who accepted`, distinguish a proposed deferral from an agreement: use `pendi
|
|
|
92
94
|
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.
|
|
93
95
|
## Checkpoint
|
|
94
96
|
|
|
95
|
-
|
|
97
|
+
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.
|
|
96
98
|
|
|
97
99
|
## Method - estimation (when the sponsor asks "how long, how much?")
|
|
98
100
|
|
|
@@ -157,7 +159,7 @@ First visible slice goes to Marco, not Priya: he is the one whose morning change
|
|
|
157
159
|
- Fragile zones early. Fail fast.
|
|
158
160
|
- Touchpoints serve the next customer decision and agreed cadence.
|
|
159
161
|
- No written acceptance criteria, no build.
|
|
160
|
-
-
|
|
162
|
+
- Make consequential exclusions explicit when work is deferred; a bounded slice needs no invented kill list.
|
|
161
163
|
- No **Kill if** on a Now PR, that PR is hope.
|
|
162
164
|
- Estimates are ranges, not promises. Name the assumptions and the observation that voids them.
|
|
163
165
|
- Migrations: compatibility determines order; verified recovery precedes cutover.
|
|
@@ -4,13 +4,15 @@
|
|
|
4
4
|
|
|
5
5
|
**Read first:** `reality.md`, `brief.md`, `terrain.md`, `context.md`. If `business-case.md` or `prototype-log.md` exist from poc, load those - they carry forward.
|
|
6
6
|
|
|
7
|
-
The most dangerous moment in a multi-use-case engagement is when the technically interesting problem wins over the high-value problem. Scoring
|
|
7
|
+
The most dangerous moment in a multi-use-case engagement is when the technically interesting problem wins over the high-value problem. Scoring makes assumptions and trade-offs visible; it does not replace evidence or judgment. These ordinal ratings are a discussion aid, not calibrated estimates of value or a reason to override a hard constraint.
|
|
8
8
|
|
|
9
9
|
## Method (you do this work)
|
|
10
10
|
|
|
11
11
|
**1. List every candidate.** From the brief, from discovery conversations, from the FDE's own observations. Include the ones the customer hasn't said aloud but the codebase implies - a high-churn module with no tests is a candidate even if nobody named it.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
Before ranking work for the proposed step, identify hard feasibility, access, data-permission and policy constraints. Keep blocked or unverified candidates visible with the affected step, owner or authority gap, and evidence needed to reconsider. A high score cannot make dependent work eligible. An authorized design or evidence check may proceed while implementation is blocked; a sponsor's preference does not grant missing API or data permission.
|
|
14
|
+
|
|
15
|
+
**2. Score on five dimensions.** Each 1-5, with the scoring rubric below. Reuse discovery's evidence and rationale, rechecking whether the candidates are eligible for the same next step. Do not invent dimension scores from a thin brief - write `unknown`, return a conditional recommendation and ask only what changes the decision.
|
|
14
16
|
|
|
15
17
|
| Dimension | 1 | 3 | 5 |
|
|
16
18
|
|-----------|---|---|---|
|
|
@@ -27,11 +29,11 @@ Score = (Business value × Urgency × Stakeholder alignment) / (6 - Feasibility)
|
|
|
27
29
|
```
|
|
28
30
|
|
|
29
31
|
Why this formula:
|
|
30
|
-
- **Multiplied numerator** -
|
|
32
|
+
- **Multiplied numerator** - a lower rating reduces the score relative to otherwise identical ratings. Because every scale starts at 1, the formula does not establish that urgency, sponsorship or permission is present; eligibility must be checked separately.
|
|
31
33
|
- **Feasibility inverted** - harder problems get a higher denominator, pulling the score down. A feasibility of 5 (easy) gives denominator 1; feasibility of 1 (hard) gives denominator 5.
|
|
32
34
|
- **Data readiness as multiplier** - for data-dependent use cases (ML, analytics). For pure engineering work, set to 3 (neutral) unless data quality is genuinely a factor.
|
|
33
35
|
|
|
34
|
-
**4. Rank and present.**
|
|
36
|
+
**4. Rank and present.** Compare eligible candidates; show up to three useful options and list blocked work separately. If an uncertain input could reverse the order, show the plausible alternative rankings and the smallest permitted check that distinguishes them, with its owner or an explicit ownership gap. Do not hide uncertainty in a precise-looking score or delay independent authorized work while waiting. The following scores illustrate a recommendation, not a commitment:
|
|
35
37
|
|
|
36
38
|
```markdown
|
|
37
39
|
| Rank | Use case | Value | Urgency | Feasibility | Data | Alignment | Score | Recommend |
|
|
@@ -49,7 +51,7 @@ Why this formula:
|
|
|
49
51
|
**6. Handle the CEO's pet project.** Sometimes the highest-scoring use case isn't the one the most powerful stakeholder wants. That's information, not a problem:
|
|
50
52
|
|
|
51
53
|
- Present the scores honestly - the stakeholder sees you're being rigorous, not political.
|
|
52
|
-
- If
|
|
54
|
+
- If the responsible decision-maker overrides the ranking, preserve the choice, source and trade-off under the existing record-confirmation rules. Check capacity and required permissions before dependent work; an override changes preference, not hard constraints or acceptance authority. An unconfirmed choice remains proposed.
|
|
53
55
|
|
|
54
56
|
## Artifact
|
|
55
57
|
|
|
@@ -59,12 +61,12 @@ Why this formula:
|
|
|
59
61
|
|
|
60
62
|
## Checkpoint
|
|
61
63
|
|
|
62
|
-
Walk the FDE through the
|
|
64
|
+
Walk the FDE through the eligible options, relevant blockers and any uncertainty that could reverse the recommendation. Keep the proposed allocation pending the appropriate decision authority; silence is not approval. Reuse existing authorization when it covers the next step. If evidence is insufficient, recommend a bounded distinguishing check rather than automatically proceeding with the highest score.
|
|
63
65
|
|
|
64
66
|
## Principles
|
|
65
67
|
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
+
- Scores expose assumptions; evidence and eligible scope govern the recommendation.
|
|
69
|
+
- A numerical advantage cannot override a hard constraint or unknown permission.
|
|
68
70
|
- The technically interesting problem that scores low gets deferred, not pursued.
|
|
69
71
|
- Present the model; let the human decide. If overridden, log the trade-off.
|
|
70
72
|
- A use case with no active sponsor is a research project, not an engagement deliverable.
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -5,6 +5,6 @@
|
|
|
5
5
|
"SKILL.md": "7d49a9e89736e35c2aaf10c78b10be365bdf91af1aaf99430de6069e96069d55",
|
|
6
6
|
"agents/openai.yaml": "6b8d024e9ea9676a2607b76a6f1fcd2fbcba585af2990b1172dbdb8cec0364c6",
|
|
7
7
|
"references/encode-pattern.md": "10fc5679752f0ea0b4d3004e4c7e282bb17f9b496ab99e5c7aae04ac942fb3c1",
|
|
8
|
-
"references/task-context.md": "
|
|
8
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd"
|
|
9
9
|
}
|
|
10
10
|
}
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
"agents/openai.yaml": "93ac049cf1a9d0fdfdf67d34ca6d3dd33800e91334f38bb303828eab8c4b3aaf",
|
|
7
7
|
"references/close.md": "4c75697bb7c85af3b4054bf427d0f265d388972a3139f1e25a1bc9f56ac65cf4",
|
|
8
8
|
"references/encode-pattern.md": "10fc5679752f0ea0b4d3004e4c7e282bb17f9b496ab99e5c7aae04ac942fb3c1",
|
|
9
|
-
"references/land.md": "
|
|
10
|
-
"references/task-context.md": "
|
|
9
|
+
"references/land.md": "f33f1b9e03a3c23c39ffce925a8f8b956b48a53982f55246752a48a317cb084d",
|
|
10
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd"
|
|
11
11
|
}
|
|
12
12
|
}
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
|
|
5
5
|
**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.
|
|
6
6
|
|
|
7
|
+
**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.
|
|
8
|
+
|
|
7
9
|
## Validation gate (confirm understanding, clarify where it elevates)
|
|
8
10
|
|
|
9
11
|
Before landing, state what you know in 2-3 lines:
|
|
@@ -12,7 +14,7 @@ Before landing, state what you know in 2-3 lines:
|
|
|
12
14
|
|
|
13
15
|
Then check - probe ONLY if it prevents a bad start:
|
|
14
16
|
|
|
15
|
-
1. **
|
|
17
|
+
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.
|
|
16
18
|
2. **Existing context.** If `.fde/` already exists → one line: "There's existing engagement memory here. Continuing this or starting fresh?"
|
|
17
19
|
3. **Access.** If the FDE is about to start work → one line: "Got repo and environment access sorted, or is that still pending?"
|
|
18
20
|
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -8,6 +8,6 @@
|
|
|
8
8
|
"references/debrief.md": "2e8e929f1c741e1a7250ad720dfa2196e1f8b14ae84f17e406c38910b9b83376",
|
|
9
9
|
"references/ingest.md": "2aaf948f6ae19fb472a2bf101b8064fc04e3c1103b874455b5a4457b5c69cf86",
|
|
10
10
|
"references/source-setup.md": "a28ae7c6dbb2573a66f31b30b7abca34bc52573fe34d48fff4c7490e4dc85d3e",
|
|
11
|
-
"references/task-context.md": "
|
|
11
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd"
|
|
12
12
|
}
|
|
13
13
|
}
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e",
|
|
12
12
|
"references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a",
|
|
13
13
|
"references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c",
|
|
14
|
-
"references/task-context.md": "
|
|
14
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd",
|
|
15
15
|
"references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6"
|
|
16
16
|
}
|
|
17
17
|
}
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"SKILL.md": "0c51c5421875b17c66c4fdb03a33e3705da52a0c649dd138c4c4cd3f3c92292a",
|
|
6
6
|
"agents/openai.yaml": "ff5da2d5215943e5c4e2a1339c11101035ed2741ded38e443af5180239e2a24b",
|
|
7
7
|
"references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25",
|
|
8
|
-
"references/task-context.md": "
|
|
8
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd",
|
|
9
9
|
"references/test-assumptions.md": "977acbf88dc0468afeb0fb222fae88100ee6a5078a729e0651c28a45870e3925",
|
|
10
10
|
"references/three-options.md": "2c979027c09af936f9a50446721e344f15e3e3bf43d3c1b7b0b85240747168c4"
|
|
11
11
|
}
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"SKILL.md": "88254d8bc2f58f4fcdd610dd7c111854dccf3ef488cfae85a4f81e90e25d1c96",
|
|
6
6
|
"agents/openai.yaml": "09f79a8a6f59741be07ae42adb9187ef790c1c4dd0341adc22ca70cd043e9ac1",
|
|
7
7
|
"references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25",
|
|
8
|
-
"references/plan.md": "
|
|
9
|
-
"references/task-context.md": "
|
|
8
|
+
"references/plan.md": "5f0330ab7195a5dec406463824b2c00dd013b70626ec52f7de4dfa0d401c1575",
|
|
9
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd"
|
|
10
10
|
}
|
|
11
11
|
}
|
|
@@ -4,7 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
**Enter when:** scope is understood and the work needs breaking down - a slice, a phase, or the whole delivery.
|
|
6
6
|
|
|
7
|
-
**Read first:** `reality.md`, `success.md`, `terrain.md`, `stakeholders.md`. Load `business-case.md`
|
|
7
|
+
**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.
|
|
8
|
+
|
|
9
|
+
**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.
|
|
8
10
|
|
|
9
11
|
**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.
|
|
10
12
|
|
|
@@ -46,7 +48,7 @@ Preserve supplied ticket identifiers and blocking dependencies; do not renumber
|
|
|
46
48
|
|
|
47
49
|
**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.
|
|
48
50
|
|
|
49
|
-
**7.
|
|
51
|
+
**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.
|
|
50
52
|
|
|
51
53
|
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.
|
|
52
54
|
|
|
@@ -56,7 +58,7 @@ Carry the agreed acceptance checks and their source into implementation and veri
|
|
|
56
58
|
|
|
57
59
|
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.
|
|
58
60
|
|
|
59
|
-
|
|
61
|
+
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:
|
|
60
62
|
|
|
61
63
|
```markdown
|
|
62
64
|
## Plan - <date>
|
|
@@ -92,7 +94,7 @@ In `Who accepted`, distinguish a proposed deferral from an agreement: use `pendi
|
|
|
92
94
|
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.
|
|
93
95
|
## Checkpoint
|
|
94
96
|
|
|
95
|
-
|
|
97
|
+
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.
|
|
96
98
|
|
|
97
99
|
## Method - estimation (when the sponsor asks "how long, how much?")
|
|
98
100
|
|
|
@@ -157,7 +159,7 @@ First visible slice goes to Marco, not Priya: he is the one whose morning change
|
|
|
157
159
|
- Fragile zones early. Fail fast.
|
|
158
160
|
- Touchpoints serve the next customer decision and agreed cadence.
|
|
159
161
|
- No written acceptance criteria, no build.
|
|
160
|
-
-
|
|
162
|
+
- Make consequential exclusions explicit when work is deferred; a bounded slice needs no invented kill list.
|
|
161
163
|
- No **Kill if** on a Now PR, that PR is hope.
|
|
162
164
|
- Estimates are ranges, not promises. Name the assumptions and the observation that voids them.
|
|
163
165
|
- Migrations: compatibility determines order; verified recovery precedes cutover.
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -11,12 +11,12 @@
|
|
|
11
11
|
"references/discover.md": "f65aa11a539b4dbbed70cfaa94ec2a35595aa9a2d0282790510b933ac9c721ce",
|
|
12
12
|
"references/eval-pack.md": "0590b85d3cae0903c6b1274540c92eaa2a4373047e8a0548d6942516ef0bb9e1",
|
|
13
13
|
"references/integrate.md": "1cb7a60d7545b0bf224fce678a04ce6ccdf368c47877d9c8e4dc4272bb0d5b0c",
|
|
14
|
-
"references/plan.md": "
|
|
14
|
+
"references/plan.md": "5f0330ab7195a5dec406463824b2c00dd013b70626ec52f7de4dfa0d401c1575",
|
|
15
15
|
"references/poc.md": "65c91866037dc034a64484683ad9a329896786f1487265c9fddecd19b09a3039",
|
|
16
16
|
"references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e",
|
|
17
17
|
"references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a",
|
|
18
18
|
"references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c",
|
|
19
|
-
"references/task-context.md": "
|
|
19
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd",
|
|
20
20
|
"references/test-assumptions.md": "977acbf88dc0468afeb0fb222fae88100ee6a5078a729e0651c28a45870e3925",
|
|
21
21
|
"references/three-options.md": "2c979027c09af936f9a50446721e344f15e3e3bf43d3c1b7b0b85240747168c4",
|
|
22
22
|
"references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6"
|
|
@@ -4,7 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
**Enter when:** scope is understood and the work needs breaking down - a slice, a phase, or the whole delivery.
|
|
6
6
|
|
|
7
|
-
**Read first:** `reality.md`, `success.md`, `terrain.md`, `stakeholders.md`. Load `business-case.md`
|
|
7
|
+
**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.
|
|
8
|
+
|
|
9
|
+
**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.
|
|
8
10
|
|
|
9
11
|
**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.
|
|
10
12
|
|
|
@@ -46,7 +48,7 @@ Preserve supplied ticket identifiers and blocking dependencies; do not renumber
|
|
|
46
48
|
|
|
47
49
|
**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.
|
|
48
50
|
|
|
49
|
-
**7.
|
|
51
|
+
**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.
|
|
50
52
|
|
|
51
53
|
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.
|
|
52
54
|
|
|
@@ -56,7 +58,7 @@ Carry the agreed acceptance checks and their source into implementation and veri
|
|
|
56
58
|
|
|
57
59
|
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.
|
|
58
60
|
|
|
59
|
-
|
|
61
|
+
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:
|
|
60
62
|
|
|
61
63
|
```markdown
|
|
62
64
|
## Plan - <date>
|
|
@@ -92,7 +94,7 @@ In `Who accepted`, distinguish a proposed deferral from an agreement: use `pendi
|
|
|
92
94
|
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.
|
|
93
95
|
## Checkpoint
|
|
94
96
|
|
|
95
|
-
|
|
97
|
+
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.
|
|
96
98
|
|
|
97
99
|
## Method - estimation (when the sponsor asks "how long, how much?")
|
|
98
100
|
|
|
@@ -157,7 +159,7 @@ First visible slice goes to Marco, not Priya: he is the one whose morning change
|
|
|
157
159
|
- Fragile zones early. Fail fast.
|
|
158
160
|
- Touchpoints serve the next customer decision and agreed cadence.
|
|
159
161
|
- No written acceptance criteria, no build.
|
|
160
|
-
-
|
|
162
|
+
- Make consequential exclusions explicit when work is deferred; a bounded slice needs no invented kill list.
|
|
161
163
|
- No **Kill if** on a Now PR, that PR is hope.
|
|
162
164
|
- Estimates are ranges, not promises. Name the assumptions and the observation that voids them.
|
|
163
165
|
- Migrations: compatibility determines order; verified recovery precedes cutover.
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"SKILL.md": "07e8a3b485762e6b6897472fe4c934cb63ed0240d8258761be445729714d782d",
|
|
6
6
|
"agents/openai.yaml": "3cfc01668b1bc6ec42d429e9730c68fd01520a7d15ea4289dee265e16bcd6b55",
|
|
7
7
|
"references/business-case.md": "32e000e8351cd59f9eaad8be40babb276df69948ea4f81e01a4672e47f48cb25",
|
|
8
|
-
"references/pick-three.md": "
|
|
9
|
-
"references/task-context.md": "
|
|
8
|
+
"references/pick-three.md": "c64a04fd0724b28701bbe334f444d0df93da4d858de993e82ccae04e48b66db9",
|
|
9
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd"
|
|
10
10
|
}
|
|
11
11
|
}
|
|
@@ -29,23 +29,23 @@ Notice: every stakeholder's initiative is P0 or P1. That's the problem this skil
|
|
|
29
29
|
| **Dependency** | How many other initiatives are blocked waiting for this? | 0 (standalone) → 5 (critical path for 3+ others) |
|
|
30
30
|
| **Cost of delay** | What happens each week this doesn't ship? | 1 (nothing) → 5 (measurable loss or regulatory exposure) |
|
|
31
31
|
|
|
32
|
-
**Triage score = Impact + Dependency + Cost of delay** (simple sum,
|
|
32
|
+
**Triage score = Impact + Dependency + Cost of delay** (simple sum, 2-15 range).
|
|
33
33
|
|
|
34
34
|
**3. Sort into three lanes:**
|
|
35
35
|
|
|
36
36
|
| Lane | Score | Action |
|
|
37
37
|
|------|-------|--------|
|
|
38
|
-
| **Now** (max 3) | 11-15 |
|
|
39
|
-
| **Next** (max 5) | 7-10 |
|
|
40
|
-
| **Later** (unlimited) |
|
|
38
|
+
| **Now** (max 3) | 11-15 | Proposed active work, subject to actual capacity, dependencies and authority. |
|
|
39
|
+
| **Next** (max 5) | 7-10 | Proposed sequencing; dependencies tracked but not started. |
|
|
40
|
+
| **Later** (unlimited) | 2-6 | Captured, not committed. Revisit at next triage. |
|
|
41
41
|
|
|
42
|
-
**The cap matters.**
|
|
42
|
+
**The cap matters.** Three is a maximum, not a quota. Use fewer or zero Now items when capacity, unresolved dependencies or required permissions prevent useful authorized work. Check who is available, effort within the phase and shared bottlenecks; one engineer cannot be allocated to several full-capacity initiatives at once. The score bands are a starting point, not automatic lane assignments: high-scoring blocked work waits, and a lower-scoring prerequisite may come first with an explained rationale. Keep uncertain allocations proposed rather than inventing capacity or approval.
|
|
43
43
|
|
|
44
44
|
**4. Handle the political override.** When a powerful stakeholder pushes a low-scoring initiative into "Now":
|
|
45
45
|
|
|
46
|
-
- Show the
|
|
47
|
-
-
|
|
48
|
-
-
|
|
46
|
+
- Show the capacity and dependency trade-off. If Now is full for the available team, adding X requires deferring work or an explicitly agreed capacity change; a vacant slot alone is not capacity.
|
|
47
|
+
- Ask the responsible decision-maker to resolve the actual choice, without assuming three items are already active. Record the supplied choice and its source under the existing confirmation rules.
|
|
48
|
+
- An override cannot waive required permissions or create capacity. Keep an unresolved request proposed, with its impact, rather than reporting it as an allocated commitment.
|
|
49
49
|
|
|
50
50
|
**5. Set the triage cadence.** Triage is not a one-time event:
|
|
51
51
|
|
|
@@ -55,15 +55,15 @@ Notice: every stakeholder's initiative is P0 or P1. That's the problem this skil
|
|
|
55
55
|
| Standard (1-4 weeks) | Weekly | New P0 from sponsor |
|
|
56
56
|
| Programme (months) | Bi-weekly | Quarterly review, team change, market shift |
|
|
57
57
|
|
|
58
|
-
**6. Communicate the triage result.**
|
|
58
|
+
**6. Communicate the triage result.** Distinguish a proposed allocation from an authorized commitment:
|
|
59
59
|
|
|
60
|
-
> "
|
|
60
|
+
> "For the available capacity, I propose [eligible items, or none] this phase. Here's what they deliver, what is blocked or deferred, and which allocation still needs confirmation. Existing agreed work remains agreed; changes need the appropriate decision authority."
|
|
61
61
|
|
|
62
62
|
## Artifact
|
|
63
63
|
|
|
64
|
-
**`decisions.md`** - the triage table with scores, lanes,
|
|
64
|
+
**`decisions.md`** - the triage table with scores, lanes, and proposed or agreed deferrals. Keep status and decision sources explicit. Update the same Now/Next/Later section plan already uses under the record-confirmation rules; do not open a second plan section. Standalone work returns the draft without initializing records.
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
For a recorded triage result, preserve this closing block. A draft may contain pending allocations and deferrals; missing agreement must not be filled with invented acceptance:
|
|
67
67
|
|
|
68
68
|
```markdown
|
|
69
69
|
## Triage - <date>
|
|
@@ -75,21 +75,21 @@ Required closing block (plan will not treat triage as done without it):
|
|
|
75
75
|
### Kill / defer (not this phase)
|
|
76
76
|
| Initiative | Why not now | Who accepted |
|
|
77
77
|
|------------|-------------|--------------|
|
|
78
|
-
| ... | ... | <name, date> |
|
|
78
|
+
| ... | ... | <pending, or supplied name, date and source> |
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
Allocation: <proposed, or agreed with source>. Now contains only work feasible within the stated capacity and authority. Additions require a capacity and dependency check, and displacement when full.
|
|
81
81
|
```
|
|
82
82
|
|
|
83
83
|
**`reality.md`** - if triage revealed that the engagement scope is larger than the timeline supports, update the assessment.
|
|
84
84
|
|
|
85
85
|
## Checkpoint
|
|
86
86
|
|
|
87
|
-
Walk the FDE through: the
|
|
87
|
+
Walk the FDE through: the proposed or agreed Now items and available capacity, the Next items and what enables their promotion, and any real trade-off requiring a decision. Explain an empty Now lane when applicable; do not fill it to satisfy the title.
|
|
88
88
|
|
|
89
89
|
## Principles
|
|
90
90
|
|
|
91
|
-
-
|
|
92
|
-
- Every addition requires a
|
|
91
|
+
- Now has at most three items and must fit actual capacity and dependencies.
|
|
92
|
+
- Every addition requires a capacity check; displace work when full rather than silently overloading the team.
|
|
93
93
|
- Triage is recurring, not one-time. The list changes; the discipline doesn't.
|
|
94
94
|
- A logged override protects the FDE. An unlogged override blames them.
|
|
95
95
|
- The initiative everyone wants but nobody will trade for is the one to watch.
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"references/qa.md": "41de4d70827c83291efa217e97d777f62ec2849827687fbba7e4b1d17484b87e",
|
|
12
12
|
"references/review.md": "8fa35eacdc04d5e818e046e6da8f61f126e08d9c6a1073b2eaa19f72d4bfea3a",
|
|
13
13
|
"references/ship.md": "95f51772b29de6f7d174f1f7678f15d46a3a5327dcb8facb94288e27907ae92c",
|
|
14
|
-
"references/task-context.md": "
|
|
14
|
+
"references/task-context.md": "3d59235f6b7092c41116457cc54e3e2e67fc0fba7b46b60279bd304be18b10cd",
|
|
15
15
|
"references/verification.md": "8ee2502112a37eedfdacf929041e7b91e9e6fabb007408a1ee2e2992e3af6ff6"
|
|
16
16
|
}
|
|
17
17
|
}
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
Use this contract for standalone methods and methods routed through `@fde`.
|
|
4
4
|
|
|
5
5
|
- **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.
|
|
6
|
+
- **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.
|
|
6
7
|
- **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.
|
|
7
8
|
- **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 <topic>`. 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.
|
|
8
9
|
- **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.
|