Skip to content

suboss87/FDEOps / skills/fde

Keeps the engagement record for client work. Use when they name a client or stakeholder. Use when they debrief a meeting or paste notes. Use when they ask what was agreed. Use when they run a POC, change the client's codebase, prove it on their staging, go live, or need evals before a model acts. Use when they prep a readout, when trust shifts, or they say @fde. Route and run the local fde CLI (or npx --yes fdeops). Never ask them to type commands. Not for ordinary code edits in an unbound repo.

FileKindSize
SKILL.mdskill md11.4 KB
agents/openai.yamlconfig219 B
references/ai.mdmarkdown10.5 KB
references/artifacts.mdmarkdown8.7 KB
references/audit.mdmarkdown5.1 KB
references/board-memo.mdmarkdown5.6 KB
references/build.mdmarkdown4.9 KB
references/business-case.mdmarkdown7.2 KB
references/close.mdmarkdown11.7 KB
references/connect.mdmarkdown1.6 KB
references/dashboard.mdmarkdown3.1 KB
references/debrief.mdmarkdown13.7 KB
references/debug.mdmarkdown3.6 KB
references/demo-prep.mdmarkdown2.5 KB
references/discover.mdmarkdown8.9 KB
references/earn-trust.mdmarkdown5.8 KB
references/encode-pattern.mdmarkdown7.9 KB
references/eval-pack.mdmarkdown6.2 KB
references/fintech.mdmarkdown3.6 KB
references/gov.mdmarkdown3.1 KB
references/healthcare.mdmarkdown2.8 KB
references/hold-scope.mdmarkdown6.8 KB
references/ingest.mdmarkdown6.2 KB
references/integrate.mdmarkdown4.7 KB
references/land.mdmarkdown14.4 KB
references/pick-three.mdmarkdown6.0 KB
references/plan.mdmarkdown15.8 KB
references/poc.mdmarkdown5.9 KB
references/qa.mdmarkdown2.6 KB
references/readout.mdmarkdown6.7 KB
references/record-setup.mdmarkdown1.7 KB
references/record-work.mdmarkdown6.4 KB
references/red-team.mdmarkdown6.5 KB
references/rescue.mdmarkdown7.5 KB
references/review.mdmarkdown5.3 KB
references/rollback.mdmarkdown4.9 KB
references/runbook.mdmarkdown4.5 KB
references/score-use-cases.mdmarkdown6.9 KB
references/ship.mdmarkdown10.6 KB
references/source-setup.mdmarkdown2.8 KB
references/switch-clients.mdmarkdown5.8 KB
references/task-context.mdmarkdown6.6 KB
references/test-assumptions.mdmarkdown7.7 KB
references/three-options.mdmarkdown6.3 KB
references/verification.mdmarkdown5.5 KB
references/what-breaks.mdmarkdown5.3 KB
references/who-decides.mdmarkdown6.7 KB

references/what-breaks.md

View on GitHub
# what-breaks - Assess impact

**Enter when:** about to make a change on a system you don't fully understand, touching a high-churn module from `terrain.md`, modifying shared infrastructure (auth, database, messaging), or the FDE asks "what could go wrong?"

**Read first:** `terrain.md`, `decisions.md`, `trust-profile.md` (for sacred systems), `context.md`.

On your own codebase, you know what breaks. On someone else's, you discover it in production. Blast-radius analysis is the discipline of mapping the damage before making the change - not after.

## Method (you do this work)

**1. Trace the dependency chain.** For the file/module/system you're about to change, answer:

| Question | How to find it |
|----------|---------------|
| Who calls this? | `grep -rn "function_name\|module_name" --include="*.ts" --include="*.py" .` |
| Who does this call? | Read the imports and external calls in the module |
| What data flows through? | Trace inputs to outputs - especially user data and money |
| What breaks if this returns differently? | Check every caller's assumptions about the return value |
| What breaks if this is slow? | Timeouts, queues, user-facing latency |
| What breaks if this is down? | Circuit breakers? Fallbacks? Or cascade failure? |

**2. Classify the blast radius:**

```
CONTAINED  → Only the module you're changing is affected
             Rollback: revert the PR
             Example: changing a utility function with no external callers

ADJACENT   → 2-5 callers or one downstream system affected
             Rollback: revert the PR + verify downstream
             Example: changing an API response format used by the frontend

SYSTEMIC   → Multiple systems, shared infrastructure, or data integrity
             Rollback: may require data migration or coordinated rollback
             Example: changing the auth token format, modifying a shared database schema

IRREVERSIBLE → Cannot be rolled back without data loss or manual intervention
               Example: data migration, dropping a column, changing encryption keys
```

**3. The what-breaks declaration.** Before writing any code, state it explicitly in `decisions.md`:

```markdown
## Blast radius: <change name>
Classification: ADJACENT
Affected: payment-service, billing-dashboard, reconciliation-job
Data impact: none (read-only change to response format)
Rollback: revert PR; frontend falls back to previous format handler
Monitoring: error rate on /api/payments endpoint, billing dashboard load time
Time to detect: <5 minutes via error rate alert
```

**4. Match the change to the blast radius:**

| Blast radius | Required before merge |
|-------------|----------------------|
| CONTAINED | Unit tests + self-review |
| ADJACENT | Unit + integration tests + team review + monitoring plan |
| SYSTEMIC | Full test suite + team review + staged rollout + incident playbook |
| IRREVERSIBLE | All of the above + sponsor approval + tested rollback of the rollback + go/no-go checkpoint |

**5. The invisible integration.** The most dangerous blast radius is the one you can't see in the code:

- A webhook endpoint that an external system calls - not in your repo's imports
- A cron job that reads the table you're modifying - runs at midnight, fails silently
- A reporting pipeline that depends on the exact column format
- An monitoring alert that triggers on a metric your change affects

**Ask the team:** "Is anything outside this repo reading from or writing to <the thing you're changing>?" The answer is almost always "yes, and here's one we forgot about."

**5b. Check the consequences of success.** When a change alters throughput, workload or decision-making, trace what happens if it works as intended. Does faster intake move the queue to another team, increase review or recovery work, or reward a local metric while the overall outcome worsens? Use known capacity and observed behavior; label missing evidence rather than inventing downstream harm. Name the affected owner and an end-to-end outcome signal alongside the local improvement. Carry a relevant check into the existing plan and ship pulse. Skip this expansion when the change has no material workflow effect.

**6. The 2am test.** For any SYSTEMIC or IRREVERSIBLE change, ask: "If this fails at 2am on Saturday, who gets woken up, what do they see, and what can they do?" If the answer is "they see nothing until Monday" - the monitoring plan needs work before the change ships.

## Artifact

**`decisions.md`** - the what-breaks declaration, filed before the change starts. Updated if the blast radius grew during implementation.

**`risks.md`** - new risks discovered during the trace (the invisible integrations, the midnight cron job).

**`terrain.md`** - update if the dependency trace revealed connections the map didn't know about.

## Checkpoint

Before merge: blast radius declared and still accurate, monitoring in place for the affected scope, rollback tested (not just planned). If the blast radius grew during implementation: re-classify, update the declaration, adjust the review/rollout requirements.

## Principles

- Declare the blast radius before writing code, not after.
- The invisible integration is always there. Ask the team.
- Match the process to the blast radius - contained gets speed, systemic gets ceremony.
- "We can always revert" is not a rollback plan. Test the rollback.
- If the 2am failure is invisible until Monday, the monitoring isn't ready.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall