ClearFlow: AI-Powered Cognitive Accessibility for Confluence

Transforms dense Confluence docs into ADHD-friendly content. AI restructures walls of text into short sentences, bullets, and scannable sections. One-click accessibility for neurodivergent teams.

Comment

The Problem

Picture this: A new developer joins your team. Their manager sends them the "Engineering Onboarding Guide" - 47 paragraphs of dense technical documentation filled with terms like "microservices architecture," "event-driven patterns," "CQRS," and "distributed sagas orchestration."

For people with ADHD, dyslexia, or anyone who processes information differently, this isn't just challenging - it's a barrier that prevents them from doing their job effectively. They might:

  • Read the same paragraph three times without retaining it
  • Get lost in walls of text and give up
  • Miss critical information buried in jargon
  • Take 2x longer than colleagues to understand the same content

The reality: 4-5% of adults have ADHD, and 10-20% have dyslexia. That's potentially millions of Atlassian users struggling silently with cognitive accessibility every single day.

Current "solutions" don't work:

  • Basic font changes help visual accessibility, not cognitive load
  • Screen readers serve blind users, not those with reading disabilities
  • AI summarization tools remove important details
  • Manual rewriting takes hours and never happens in practice

The Solution

ClearFlow is an AI-powered Forge app that transforms dense Confluence documentation into cognitively accessible content with one click - while preserving 100% of the information.

How it works:

  1. User opens any Confluence page (engineering docs, HR policies, runbooks)
  2. Clicks the "ClearFlow" button in the page header
  3. Chooses one of three transformation modes
  4. AI instantly restructures the content for readability
  5. Original page remains untouched - transformation is view-only

Three Transformation Modes:

🔹 Simplify - Replaces jargon with plain language, breaks complex sentences into shorter ones, maintains technical accuracy while improving readability

📋 Organize - Adds visual structure with bullet points, headers, and spacing. Converts dense paragraphs into scannable sections with clear hierarchy

🌊 Flow - Optimized for ADHD: very short sentences (10-15 words), numbered lists, bold key terms, clear section breaks, maximum scannability

Technical Implementation

Stack:

  • Platform: Atlassian Forge (serverless, Node.js 22)
  • AI: Google Gemini 2.5 Flash
  • Frontend: Forge UI Kit (React)
  • Integration: Confluence REST API

Key Features:

  • Zero configuration required - works immediately after installation
  • Processes any Confluence page in 5-10 seconds
  • Smart text extraction from HTML storage format
  • Graceful fallback handling if content fetch fails
  • Responsive markdown formatting with headers, lists, and bold text
  • Clean, card-based UI with mode descriptions

Security & Privacy:

  • No data stored - transformations happen in real-time
  • Uses Forge's built-in authentication (user's permissions)
  • Original documents never modified
  • Serverless architecture (no server management needed)

Why This Matters

Universal Impact: ClearFlow isn't just for people with diagnosed disabilities. It helps:

  • Neurodivergent employees (ADHD, dyslexia, autism spectrum)
  • Non-native English speakers
  • Junior developers/employees
  • Anyone experiencing information overload
  • Remote workers reading async documentation
  • Teams onboarding new members faster

Business Value:

  • Reduce average doc reading time by 30-40%
  • Accelerate employee onboarding
  • Improve knowledge sharing effectiveness
  • Support neurodiversity inclusion initiatives
  • Make documentation accessible to global teams

Competitive Advantage:

  • Zero apps exist in Atlassian Marketplace for cognitive accessibility
  • First to apply AI transformation specifically for workplace documentation
  • Proven concept (inspired by Mochi, winner of Google's AI Challenge)
  • Addresses growing demand for neurodiversity workplace tools

Installation & Usage

For Judges (Zero Setup):

  1. Click installation link
  2. Approve Confluence permissions
  3. Open any Confluence page
  4. Click "clearflow" button
  5. Choose transformation mode
  6. See results instantly

No API keys, no configuration, no technical knowledge required.

Future Enhancements

If this wins, planned features include:

  • TL;DR auto-summary at page top
  • User preference memory (save favorite mode)
  • Custom transformation settings
  • Browser extension version
  • Support for Jira ticket descriptions
  • Multi-language support
  • Analytics dashboard (what content gets transformed most)

Built with ❤️ for Codegeist 2025: Atlassian Williams Racing Edition

Just like F1 engineers optimize every system for speed, ClearFlow optimizes human cognitive performance for workplace efficiency. 🏎️💨

Share this project:

Updates