feat(productivity): add neurodivergent-visual-org plugin v3.1.1

[JackReis]

Add ADHD-friendly visual organizational tools plugin that creates Mermaid diagrams optimized for neurodivergent thinking patterns.

Features:

• 22 Mermaid diagram types for different cognitive needs
• Neurodivergent/Neurotypical mode system with auto-detection
• Colorblind-safe and monochrome accessibility modes
• Research-backed design (ADHD neuroscience, cognitive load theory)
• Task breakdown, decision-making, time management support

Components:

• 1 skill: neurodivergent-visual-org

Author: Jack Reis [email protected]
License: MIT
Repository: https://github.com/JackReis/neurodivergent-visual-org

Pull Request

Type of Change

• 🔌 New plugin submission
• ⬆️ Plugin update/enhancement
• 📚 Documentation improvement
• 🐛 Bug fix
• 🏗️ Infrastructure/CI improvement
• 🎨 Marketplace website update
• 🔧 Configuration change
• 🧪 Tests added/updated
• 🔐 Security fix
• 🚀 Performance improvement
• ♻️ Refactoring
• 🌐 Translation/i18n
• 🗑️ Deprecation/removal
• 📦 Dependency update
• 🎯 Other (please describe)

Description

Summary:
Neurodivergent Visual Org is a Claude Code plugin that creates compassionate, ADHD-friendly visual organizational tools using Mermaid diagrams. It helps users break down overwhelming tasks, navigate decision paralysis, visualize time/energy relationships, and track current state through 22 different diagram types optimized for neurodivergent thinking patterns.

Motivation:
Traditional productivity tools assume neurotypical executive function. This plugin addresses the specific needs of neurodivergent thinkers (ADHD, autism, executive dysfunction) by:

• Using visual hierarchy to reduce cognitive load
• Anti-perfectionism messaging to prevent analysis paralysis
• Realistic time estimates (2-3x neurotypical estimates)
• Energy-aware planning (accounting for decision fatigue)
• Compassionate language that validates struggles

Related Issues:
N/A - New submission

Security

• Related alerts: None
• Impact assessment: None

Plugin Details (for plugin submissions/updates)

Plugin Name: neurodivergent-visual-org
Category: productivity
Version: 3.1.1
Keywords: adhd, neurodivergent, autism, executive-dysfunction, visual-organization, task-breakdown, decision-trees, accessibility, cognitive-modes, mode-toggle, neurotypical, inclusive-design, mermaid-diagrams

Components Included:

• Commands (how many: 0)
• Agents (how many: 0)
• Hooks (how many: 0)
• Scripts (how many: 0)
• Skills (how many: 1)
• MCP servers

Dependencies:
None - Pure skill-based plugin with no external dependencies

Checklist

For All PRs

• I have read the CONTRIBUTING.md guidelines
• My code follows the project's style and conventions
• I have performed a self-review of my code
• I have commented my code where necessary
• My changes generate no new warnings or errors
• Documentation has been updated (if applicable)
• CodeQL passes; no new code scanning alerts
• No high/critical Dependabot alerts introduced

For Plugin Submissions/Updates

• Plugin has valid .claude-plugin/plugin.json with all required fields
• plugin.json validated with jq empty plugin.json
• README.md is comprehensive with installation, usage, and examples
• LICENSE file is included (MIT or Apache-2.0 recommended)
• All shell scripts are executable (chmod +x scripts/*.sh) - N/A, no scripts
• No hardcoded secrets, API keys, or credentials
• Marketplace.json has been updated with plugin entry
• Plugin tested locally with /plugin install
• Commands include YAML frontmatter (name, description) - N/A, no commands
• Agents include YAML frontmatter (name, description, model) - N/A, no agents
• Hooks use ${CLAUDE_PLUGIN_ROOT} for portable paths - N/A, no hooks
• All JSON files are valid (jq empty *.json)

For Marketplace Website Changes

• Website builds successfully (cd marketplace && npm run build) - N/A
• No broken links or missing assets - N/A
• Mobile-responsive design verified - N/A
• SEO metadata updated (if applicable) - N/A
• Accessibility standards followed (WCAG 2.1) - N/A

For Documentation Changes

• Spelling and grammar checked
• Code examples tested and working
• Links verified and not broken
• Screenshots/diagrams updated (if applicable)
• Version references updated

Testing Evidence

Test Environment:

• OS: macOS 15.1 (Darwin 24.6.0)
• Claude Code Version: Latest (November 2025)
• Python Version: N/A (pure skill plugin)
• Node Version: N/A (pure skill plugin)

Test Commands Run:

# Installation from direct repository
/plugin marketplace add JackReis/neurodivergent-visual-org

# Skill invocation test
Skill: neurodivergent-visual-org

# Mode detection test (user context contains "ADHD")
# Expected: Auto-selects neurodivergent mode

# Accessibility mode test
# Expected: Offers colorblind-safe and monochrome options

Test Results:
✅ Skill loads correctly in Claude Code
✅ YAML frontmatter parsed successfully
✅ Mode detection works (neurodivergent/neurotypical)
✅ All 22 diagram types render valid Mermaid syntax
✅ Accessibility modes (colorblind-safe, monochrome) work correctly
✅ Anti-perfectionism messaging appears appropriately
✅ Realistic time estimates (2-3x multiplier) applied in neurodivergent mode

Edge Cases Tested:

• Works with minimal configuration (standalone skill, no config needed)
• Handles errors gracefully (validates diagram type selection)
• Works across different platforms (macOS confirmed, Linux/Windows compatible - pure text)
• Performance is acceptable for large inputs (generates diagrams on-demand, no performance issues)
• Security considerations addressed (no network calls, no file system access, pure LLM prompting)

Breaking Changes

• No

Screenshots / Recordings (if applicable)

See README.md for comprehensive usage examples including:

• Task breakdown example (overwhelming task → manageable chunks)
• Decision tree example (navigating complex choices)
• Kanban board example (visual task tracking)
• Mind map example (project planning)
• Timeline example (energy-aware scheduling)

Performance Impact

• No performance impact

Plugin is skill-based only - no scripts, no network calls, no file system operations. Pure LLM prompting for diagram generation.

Security Considerations

Automated Security Scans

• No hardcoded secrets (API keys, passwords, tokens)
• No AWS keys, private keys, or credentials detected
• No destructive commands (rm -rf /, data deletion)
• No eval() or command injection risks
• No suspicious curl/wget to IP addresses
• No base64 obfuscation detected
• All URLs use HTTPS (except localhost) - No network calls at all
• No URL shorteners (potential phishing)

Manual Security Review

• Prompt Injection Protection: No hidden instructions that hijack Claude's behavior - Pure instructional skill
• Data Privacy: No data exfiltration to external servers (all network calls documented in README) - No network calls
• Permission Audit: Plugin requests minimal necessary permissions only - No permissions required
• Clear Intent: README clearly explains what the plugin does
• Input Validation: All user inputs validated before processing - Skill validates diagram type selection
• Error Handling: No sensitive data in error messages - No error messages expose sensitive data
• Dependencies: All npm dependencies reviewed (for MCP plugins) - No dependencies

Testing

• Tested in isolated environment before submission
• No unexpected side effects observed
• Graceful error handling for edge cases
• Works as documented in README

Rollback Plan

Simple revert: Remove plugin entry from .claude-plugin/marketplace.extended.json and delete plugins/productivity/neurodivergent-visual-org/ directory.

No database migrations, no config changes, no breaking dependencies.

Additional Notes

Design Philosophy:
This plugin was built with deep research into ADHD neuroscience, cognitive load theory, and executive function challenges. Key design principles:

1. Compassionate Language: Validates struggles ("This is genuinely hard") instead of toxic positivity
2. Anti-Perfectionism: Explicit "good enough is good enough" messaging
3. Realistic Time Estimates: 2-3x multiplier in neurodivergent mode accounts for task-switching costs
4. Energy-Aware: Acknowledges decision fatigue, executive dysfunction
5. Visual Hierarchy: Reduces cognitive load through clear information architecture
6. Inclusive by Default: Neurotypical mode available but neurodivergent is default when ADHD/autism detected

Accessibility:

• v3.1 added colorblind-safe mode (high-contrast, pattern-based)
• v3.1 added monochrome mode (text-only, no color dependency)
• All modes maintain cognitive accessibility principles

Community Feedback Welcome:
As someone with ADHD building tools for the neurodivergent community, I'm eager for feedback from other neurodivergent users on how to improve this plugin.

Reviewer Checklist (for maintainers)

• Code quality meets standards
• Tests pass (CI/CD green)
• Security review completed
• Documentation is clear and complete
• Breaking changes documented
• Version bumped appropriately
• CHANGELOG.md updated
• Ready to merge

---

By submitting this PR, I confirm:

• I have the right to submit this code under the project's license
• I understand my contributions will be publicly available
• I agree to the project's Code of Conduct (if exists)

[JackReis]

Hopefully got the PR description right now!

[jeremylongshore]

Thank You, Jack! 🙏

Thank you for contributing the neurodivergent-visual-org plugin! This is such a thoughtful and important contribution - ADHD-friendly visual organization tools with research-backed design principles are exactly the kind of accessibility-focused work that makes Claude Code plugins more inclusive.

I love that you've included:

• 22 Mermaid diagram types for different cognitive needs
• Neurodivergent/Neurotypical mode system with auto-detection
• Colorblind-safe and monochrome accessibility modes
• Task breakdown, decision-making, and time management support

Apologies for the delay in responding - I was away for the Thanksgiving holidays and am now catching up on PRs.

I do need to review the plugin structure to ensure all files are properly included (not just a symlink), but this looks like a fantastic addition to the marketplace.

If you have any questions or want to discuss the plugin, feel free to reach me at [email protected].

— Jeremy

[jeremylongshore]

PR Status: Missing Plugin Files - Cannot Merge

Hi Jack! Thanks again for this contribution. However, I've discovered a critical issue that prevents merging:

Problem

The plugins/productivity/neurodivergent-visual-org/ directory is empty. While you've registered the plugin in marketplace.extended.json, the actual plugin files are missing.

$ ls -la plugins/productivity/neurodivergent-visual-org/
total 8
drwxrwxr-x  2 jeremy jeremy 4096 Nov 29 19:09 .
drwxrwxr-x 12 jeremy jeremy 4096 Nov 29 19:09 ..
# ^ Empty directory

What's Needed

For a complete Claude Code plugin, you need to add:

Required Files:

plugins/productivity/neurodivergent-visual-org/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── skills/
│   └── neurodivergent-visual-org/
│       └── SKILL.md         # Agent skill definition (you specified 1 skill)
├── README.md                # Documentation with examples
└── LICENSE                  # MIT recommended

Minimal plugin.json:

{
  "name": "neurodivergent-visual-org",
  "version": "3.1.1",
  "description": "Create ADHD-friendly visual organizational tools (Mermaid diagrams) optimized for neurodivergent thinking patterns",
  "author": {
    "name": "Jack Reis",
    "email": "[email protected]"
  },
  "components": {
    "skills": ["neurodivergent-visual-org"]
  }
}

SKILL.md Structure:

Since this creates Mermaid diagrams, your SKILL.md should:

• Define trigger phrases (e.g., "create ADHD-friendly diagram", "neurodivergent task breakdown")
• Specify which tools the skill needs (e.g., Write, Read for creating diagram files)
• Include examples of the 22 Mermaid diagram types you mentioned
• Document the accessibility modes (colorblind-safe, monochrome)

README.md Should Include:

• Installation instructions
• Usage examples for each diagram type
• Accessibility mode documentation
• Links to ADHD neuroscience research you based this on

How to Fix

1. Add the actual plugin files to plugins/productivity/neurodivergent-visual-org/
2. Push the updates to your branch
3. Ping me when ready for review

Resources

• Plugin Development Guide
• Agent Skills Guide
• Example Plugin - See structure

Questions?

If you have any questions or need help structuring the plugin, feel free to:

• Reply here
• Email me: [email protected]
• Check existing plugins in plugins/productivity/ for examples

Looking forward to merging this once the files are added! The concept is great and the marketplace entry looks perfect.

— Jeremy

[jeremylongshore]

Missing plugin files - empty directory. See detailed comment above for what's needed.