# rohunvora/just-fucking-cancel architecture

> Architecture diagram of the GitHub repository rohunvora/just-fucking-cancel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rohunvora/just-fucking-cancel
- Repository: https://github.com/rohunvora/just-fucking-cancel

## Overview

This repo is **not a traditional app with runtime services** (no backend, no DB, no deployable API). It’s a **Claude Code skill**: a packaged set of instructions + assets that teach Claude how to run a local workflow:

- Ingest **local bank/credit-card CSVs**
- Detect **recurring charges**
- Interactively classify them (Keep / Investigate / Cancel)
- Generate a **local HTML audit report**
- Optionally perform **browser automation** (open Chrome, navigate cancellation flows)

##### Skill package (the “product”)
- `.claude/skills/just-fucking-cancel/SKILL.md`
The core “program” in this repo: instructions, prompts, step-by-step logic Claude follows.
- `.claude/skills/just-fucking-cancel/assets/template.html`
The report template Claude uses to generate the audit HTML.
- `.claude/skills/just-fucking-cancel/references/common-services.md`
Domain knowledge / reference data Claude uses for classification, heuristics, known merchants, etc.

##### Local data inputs / examples
- `data/subscriptions.json`
Likely example data, defaults, or a structure the skill reads/writes (even if used as reference).
- User-provided: “exported .csv’s to your local folder” (from README)

##### Docs / onboarding
- `README.md`, `GETTING_STARTED.md`, `getting-started.html`

##### Hosting/deployment (minor/optional
- `vercel.json`

##### User (Operator)
- Provides CSV exports
- Answers classification questions
- Confirms cancellations

##### Claude Code (runtime environment)
- The actual execution context where the skill runs
- Has access to local filesystem and can drive tools (browser)

##### Just F*ing Cancel Skill
- As a subcomponent inside Claude Code or as a plugin attached to it
- Internals:
- “Skill Instructions” (`SKILL.md`)
- “Reference Knowledge” (`common-services.md`)
- “Report Template” (`template.html`)

##### Local Filesystem
- Input: CSV statements (user drops in)
- Output: Generated HTML report (local file)
- Optional: Intermediate data (e.g., normalized transactions, subscription list JSON)

##### Report Viewer (Browser / Local HTML)
- User opens the generated HTML report locally
- Contains checkboxes, copy button, privacy toggle, collapsible sections (from README)

##### Browser Automation Controller
- Claude-driven automation that opens Chrome and performs navigation/clicks

##### External Subscription Provider Websites
- Netflix/Spotify/Gym/SaaS cancellation pages
- As a cloud/external boundary

##### Anthropic Claude Model (Cloud)
- The model that processes conversation/instructions
- Important for the privacy/trust boundary: the README explicitly distinguishes “local CSV stays local” vs “conversation reaches Anthropic”.

##### Browser Automation Controller ↔ External Websites: “HTTP interactions + UI automation”
10. **Browser Automation Controller ↔ User**: “Confirm before final steps / user can intervene”

##### Claude Code ↔ Anthropic Claude Model (Cloud): “Prompts, reasoning, dialogue”
12. A note/annotation: “Raw CSV not uploaded; user data remains local” (this is a core product claim in the README, so it belongs visually).

##### Architectural patterns/principles to highlight (specific to this repo)
This is best diagrammed as **a “local-first, AI-orchestrated workflow”**:

- **Instruction-driven orchestration**: `SKILL.md` is effectively the “application logic”
- **Reference-driven classification**: `common-services.md` and maybe `subscriptions.json` act as knowledge sources
- **Template-based report generation**: `template.html` is a deterministic output structure
- **Human-in-the-loop**: user Q&A is a first-class control mechanism (not an edge case)
- **Trust boundaries**:
- Local filesystem + browser actions are on the user’s machine
- Model inference occurs in the cloud (Anthropic)

These deserve explicit visual treatment (boundaries, annotations).

##### Concrete labeling/coloring conventions (so it’s readable and unambiguous)

- **Gray cloud**: external services: subscription websites
- **Orange cloud**: Anthropic Claude Model (explicit trust boundary)

- `SKILL.md` as “Orchestration Logic”
- `assets/template.html` as “Presentation Template”
- `references/common-services.md` as “Merchant/Service Knowledge Base”
- `data/subscriptions.json` as “Seed Data / Example Catalog (optional)”
- `vercel.json` as “Static docs hosting config (optional)”

Small callouts next to relevant edges:

- Next to **Local FS ↔ Claude Code**: “CSV stays local”
- Next to **Claude Model cloud**: “Only conversation/context sent”
- Next to **Browser Automation → Websites**: “Human confirmation before final cancellation”
- Next to **Report HTML**: “Checkboxes + privacy blur + copy cancel list”

These are key product properties described in README and should appear visually.

That set will be the “best and most accurate” representation for this repo because it captures: instruction-based logic, local-first data handling, human-in-the-loop decisions, and optional browser automation across trust boundaries.

## Diagram (Mermaid)

```mermaid
flowchart TD

%% =========================
%% Diagram 1 — Context / System Boundary (C4 L1)
%% =========================
subgraph D1["Diagram 1: Context / System Boundary"]
direction TB

    U1["User (Operator)"]:::user

    subgraph LM1["Local Machine Boundary"]
    direction TB
        CC1["Claude Code (Runtime Environment)"]:::claude
        subgraph SK1["Just F***ing Cancel Skill (Package)"]
        direction TB
            SK1A["Skill Instructions (SKILL.md)"]:::skill
            SK1B["Reference Knowledge (common-services.md)"]:::skill
            SK1C["Report Template (template.html)"]:::skill
            SK1D["Seed/Example Catalog (subscriptions.json)"]:::skill
        end

        LFS1[("Local Filesystem")]:::local
        CSV1["Input: Bank/Credit-Card CSV Exports"]:::local
        REP1["Output: Local HTML Audit Report"]:::local
        RV1["Report Viewer (Local Browser Tab)"]:::local
        BAC1["Browser Automation Controller (Chrome)"]:::local
    end

    subgraph EXT1["External / Internet Boundary"]
    direction TB
        WEB1["External Subscription Provider Websites"]:::external
    end

    subgraph AC1["Anthropic Cloud Boundary"]
    direction TB
        AM1["Anthropic Claude Model (Cloud)"]:::anthropic
    end

    %% Flows (vertical, labeled)
    U1 -->|"exports_CSVs"| CSV1
    CSV1 -->|"stored_locally"| LFS1

    CC1 <-->|"read_CSV_write_HTML"| LFS1
    CC1 <-->|"Q&A_classify_recurring_charges"| U1

    CC1 -->|"generate_HTML_report_from_template"| REP1
    REP1 -->|"open_local_HTML"| RV1
    RV1 -->|"review_select_copy_lists"| U1

    U1 -.->|"command_cancel_selected"| CC1
    CC1 -->|"drive_UI_automation"| BAC1
    BAC1 <-->|"navigate_click_cancel_flows"| WEB1
    BAC1 <-->|"confirm_before_final_steps"| U1

    CC1 <-->|"prompts_reasoning_dialogue"| AM1

    %% Callouts / Notes
    N1["Note: Raw CSV stays local (not uploaded)"]:::note
    N2["Note: Only conversation/context sent to model"]:::note
    N3["Note: Human confirmation before final cancellation"]:::note
    N4["Report features: checkboxes, privacy blur, copy cancel list"]:::note

    LFS1 --- N1
    AM1 --- N2
    BAC1 --- N3
    RV1 --- N4
end

%% =========================
%% Diagram 2 — Container / Runtime Workflow (C4 L2)
%% =========================
subgraph D2["Diagram 2: Runtime Workflow / Containers (Audit + Report + Automation)"]
direction TB

    U2["User (Operator)"]:::user

    subgraph LM2["Local Machine Boundary"]
    direction TB

        LFS2[("Local Filesystem")]:::local
        CSV2["Transaction CSV Files"]:::local
        INT2["Intermediate: Normalized Transactions + Subscription List"]:::local
        OUT2["Generated Audit Report (HTML file)"]:::local

        subgraph CC2["Claude Code (Runtime)"]
        direction TB

            subgraph SK2["Skill Content (Repo Assets)"]
            direction TB
                ORCH2["Orchestration Logic (SKILL.md)"]:::skill
                REF2["Merchant/Service Knowledge (common-services.md)"]:::skill
                TPL2["HTML Template (template.html)"]:::skill
                SEED2["Seed/Example Catalog (subscriptions.json)"]:::skill
            end

            ING2["Data Ingestion (CSV parsing/normalization)"]:::claude
            DET2["Recurring Charge Detection"]:::claude
            HITL2["Interactive Classification (Keep/Investigate/Cancel)"]:::claude
            REPGEN2["Report Generator (uses template)"]:::claude
            AUTO2["Browser Automation Module"]:::claude
        end

        RV2["Report Viewer (Local HTML)"]:::local
        CH2["Chrome (Automated + User Interventions)"]:::local
    end

    AM2["Anthropic Claude Model (Cloud)"]:::anthropic
    WEB2["Subscription Provider Websites"]:::external

    %% Data path (solid)
    U2 -->|"drops_CSVs_into_folder"| CSV2
    CSV2 -->|"persist"| LFS2

    CC2 -->|"read_CSVs"| LFS2
    ING2 -->|"normalized_transactions"| INT2
    DET2 -->|"recurring_candidates"| HITL2
    HITL2 -->|"categorized_subscriptions"| INT2
    REPGEN2 -->|"render_HTML_from_template"| OUT2
    OUT2 -->|"open"| RV2
    RV2 -->|"review_actions_copy_lists"| U2

    %% Control path (dashed)
    U2 -.->|"answer_questions_confirm_labels"| HITL2
    U2 -.->|"request_cancellation_for_selected"| AUTO2
    AUTO2 -->|"open_navigate_click"| CH2
    CH2 <-->|"web_UI_requests"| WEB2
    CH2 -.->|"pause_for_user_confirmation"| U2

    %% Claude model boundary
    CC2 <-->|"prompts_reasoning_dialogue"| AM2

    %% Local I/O linkage
    ING2 -->|"write_intermediate"| LFS2
    DET2 -->|"read_normalized"| LFS2
    HITL2 -->|"read_write_classifications"| LFS2
    REPGEN2 -->|"write_report_HTML"| LFS2

    %% Notes
    N5["Privacy: CSV/local files remain on machine"]:::note
    N6["Trust boundary: browser automation can be stopped/overridden by user"]:::note
    LFS2 --- N5
    CH2 --- N6
end

%% =========================
%% Diagram 3 — Sequence (Audit + Optional Cancellation) as Flow
%% =========================
subgraph D3["Diagram 3: Sequence (Audit + Optional Cancellation)"]
direction TB

    U3["User (Operator)"]:::user
    CC3["Claude Code (Runtime)"]:::claude
    FS3[("Local Filesystem")]:::local
    AM3["Anthropic Claude Model (Cloud)"]:::anthropic
    CH3["Chrome (Automation)"]:::local
    WEB3["Subscription Websites"]:::external

    U3 -->|"Save exported transaction CSVs"| FS3
    CC3 -->|"Read CSV files"| FS3
    CC3 <-->|"Prompts/reasoning/dialogue\n(only conversation/context)"| AM3
    CC3 -->|"Detect recurring charges"| CC3
    CC3 -->|"Ask classification Q&A\n(Keep/Investigate/Cancel)"| U3
    U3 -->|"Provide decisions/confirm labels"| CC3
    CC3 -->|"Write HTML audit report (from template)"| FS3
    U3 -->|"Open local report HTML"| FS3
    FS3 -->|"Render report in browser\n(checkboxes, privacy blur, copy lists)"| U3

    subgraph D3OPT["Optional: Cancellation automation (user-requested)"]
    direction TB
        U3 -.->|"Command: cancel selected subscriptions"| CC3
        CC3 -.->|"Confirm before proceeding"| U3
        U3 -.->|"Confirm"| CC3
        CC3 -->|"Launch + navigate cancellation flows"| CH3
        CH3 <-->|"UI automation + HTTP interactions"| WEB3
        CH3 -.->|"Pause for final confirmation/intervention"| U3
        U3 -.->|"Confirm/finish or abort"| CH3
    end
end

%% =========================
%% Click events (from component mapping)
%% =========================
click SK1 "https://github.com/rohunvora/just-fucking-cancel/tree/main/.claude/skills/just-fucking-cancel/"
click SK1A "https://github.com/rohunvora/just-fucking-cancel/blob/main/.claude/skills/just-fucking-cancel/SKILL.md"
click SK1C "https://github.com/rohunvora/just-fucking-cancel/blob/main/.claude/skills/just-fucking-cancel/assets/template.html"
click SK1B "https://github.com/rohunvora/just-fucking-cancel/blob/main/.claude/skills/just-fucking-cancel/references/common-services.md"
click SK1D "https://github.com/rohunvora/just-fucking-cancel/blob/main/data/subscriptions.json"

click SK2 "https://github.com/rohunvora/just-fucking-cancel/tree/main/.claude/skills/just-fucking-cancel/"
click ORCH2 "https://github.com/rohunvora/just-fucking-cancel/blob/main/.claude/skills/just-fucking-cancel/SKILL.md"
click TPL2 "https://github.com/rohunvora/just-fucking-cancel/blob/main/.claude/skills/just-fucking-cancel/assets/template.html"
click REF2 "https://github.com/rohunvora/just-fucking-cancel/blob/main/.claude/skills/just-fucking-cancel/references/common-services.md"
click SEED2 "https://github.com/rohunvora/just-fucking-cancel/blob/main/data/subscriptions.json"

%% Docs / onboarding
click D1 "https://github.com/rohunvora/just-fucking-cancel/blob/main/README.md"
click D2 "https://github.com/rohunvora/just-fucking-cancel/blob/main/GETTING_STARTED.md"
click RV1 "https://github.com/rohunvora/just-fucking-cancel/blob/main/getting-started.html"
click RV2 "https://github.com/rohunvora/just-fucking-cancel/blob/main/getting-started.html"
click EXT1 "https://github.com/rohunvora/just-fucking-cancel/blob/main/vercel.json"

%% =========================
%% Styles (coloring)
%% =========================
classDef user fill:#dbeafe,stroke:#1d4ed8,stroke-width:1.5px,color:#0b1f44
classDef local fill:#bfdbfe,stroke:#1e40af,stroke-width:1.2px,color:#0b1f44
classDef claude fill:#e9d5ff,stroke:#6b21a8,stroke-width:1.5px,color:#2a0a3d
classDef skill fill:#bbf7d0,stroke:#166534,stroke-width:1.2px,color:#062b12
classDef external fill:#e5e7eb,stroke:#374151,stroke-width:1.2px,color:#111827
classDef anthropic fill:#fed7aa,stroke:#c2410c,stroke-width:1.5px,color:#3b1506
classDef note fill:#fff7ed,stroke:#9a3412,stroke-width:1px,color:#3b1506

class U1,U2,U3 user
class CC1,CC2,CC3,ING2,DET2,HITL2,REPGEN2,AUTO2 claude
class LFS1,LFS2,FS3,CSV1,CSV2,INT2,OUT2,REP1,RV1,RV2,BAC1,CH2,CH3 local
class SK1,SK1A,SK1B,SK1C,SK1D,SK2,ORCH2,REF2,TPL2,SEED2 skill
class WEB1,WEB2,WEB3 external
class AM1,AM2,AM3 anthropic
class N1,N2,N3,N4,N5,N6 note
```
