fcc

fcc — Flowchart for Claude Code

Streamline code comprehension with ease. fcc enhances the Claude Code workflow by automatically generating concise documentation after every coding task. It provides a local link that details the changes made in plain language, visualizes the behavior flow influenced by those changes, and maintains a comprehensive development history within the project repository.

Key Features

Comprehensive Change Documentation

Every time a task modifies files, fcc generates a detailed summary explaining what was changed. This includes:

• The purpose behind the task and the decisions made.
• An overview of how the application's behavior has evolved.
• A checklist of requests highlighting completed, partial, or missing components.

Runtime Behavior Visualization

Each task generates a flowchart that delineates the runtime behavior, highlighting new, modified, or removed steps. This gives clear insight into how changes impact the system’s functionality:

flowchart TD
  s1(["User opens checkout"])
  s2["User enters discount code"]:::added
  s3["Calculate discounted total"]:::added
  s4["Display subtotal and discounted total"]:::added
  s5["User clicks Pay"]
  s6["Submit order with discount code"]:::modified
  s7{\"Order created successfully?\"}:::added
  s8(["Order completed"])
  s9(["Invalid discount code error displayed"]:::added)
  s1 --> s2
  s2 --> s3
  s3 --> s4
  s4 --> s5
  s5 --> s6
  s6 --> s7
  s7 -->|"success"| s8
  s7 -->|"invalid code"| s9
  classDef added fill:#e3f3e7,stroke:#2f8a4c,color:#1f1e1c
  classDef modified fill:#fbf0dc,stroke:#b7791f,color:#1f1e1c

Project Structure Analysis

fcc also creates a symbol graph that shows changes to functions, methods, and classes, detailing the relationships between them, aiding in code maintenance and understanding.

Organized Project History

Every modification is logged into the docs/flow/ directory, presenting a clear timeline of tasks grouped by features or commits. The history view enables easy navigation through previous changes and decisions made during the project lifecycle.

Integration with Projects

Each task generates a Markdown file containing relevant details, allowing for seamless integration into the development process:

---
fcc: 1
task: "20260922-190815-6478"
date: "2026-09-22T17:08:15.759Z"
feature: "Discount Codes"
---

# Checkout now displays the discounted total alongside the subtotal…

## Why
The checkout now clearly shows users the discount amount applied with the entered code while informing them if the code is invalid…

This thorough documentation aids in project transparency and ensures that key decisions are preserved for future reference.

Data and Security

• fcc operates locally, meaning only task-related data is recorded. No sensitive project information is sent online.
• User conversations stay private, with no logs retained beyond immediate functionality.

By leveraging fcc, developers can enhance clarity and traceability in their coding efforts, reducing the cognitive load associated with code changes and project history.