Skip to content

RobGonWin/deving-gene

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 

Repository files navigation

Status: WIP License: Apache-2.0 Platform: Windows 10/11

Deving Gene (WIP — OSS 2026)

Deving Gene (project name short for ‘Developing Gene’, or ‘Development Gene’) is a focus, automation, and AI-assisted workflow system designed with neurodivergent awareness and giftedness protocols (to support twice-exceptionality, spiky cognitive profiles, and executive-function) along with other planned features for real-time scaffolding. Combining an Alexa Skill (communicates through a LAN-based protocol with proper URL tunneling and security measures in place), PC Client (Python/FastAPI), PC dashboards, PC assistant UI, VS Code extension, and evolving adaptive workflow layers (more secrets to be explored soon!) to help users preserve flow state, reduce context loss, and build with more consistency.

Note: This naming convention I chosed, nor this project idea tool is not made to sound grandiose or "better than everyone." This workflow is specifically being designed to augment different neurotypes that have different strengths and weakness - stuff that defers from more neurotypical brains (aka neurodivegrent brains) for better inclusivity and reduce friction.

At its core, Deving Gene is about creating a system that can work with your brain instead of against it using automation, roadmap systems, voice integration, local-first AI, and workflow feedback loops - essentially optimizing your flow state and providing a more frictionless experience using AI, without sacrificing your critical thinking skills. This effectively encourages a "synchronization" with artificial intelligence, powered by personalized context, learning language models, and more--all while being local-first, consent-first, auditable, with multiple trust profiles. out of the box. This allows for a secure Individualized Education Plan (with different security profiles on what you allow to be shared with Amazon+Alexa to reduce security concerns) all while turning your Alexa smart device into something that can be used consistently to monitor, regulate, learn, and do development with for everyday work.

It is especially aimed at developers and learners who may be:

  • highly capable but inconsistent in output
  • strong in reasoning but weaker in working-memory continuity
  • prone to context loss during task switching
  • bored or under-stimulated by generic productivity systems
  • looking for a more adaptive, privacy-aware "external frontal lobe" like workflow

📌 This is a planning/documentation repo, which mirrors my experimental private repo (which contains actual code). Source code will be open-sourced sometime in 2026. Until then, this page hosts images, roadmap, and architecture notes.

What Deving Gene is trying to solve

Traditional productivity systems assume everyone works well with the same structure.

Deving Gene does not.

This project is built around the idea that some people need:

  • external memory scaffolding
  • flow-state protection
  • adaptive prompts and pacing
  • gentle or aggressive interruption management
  • context-aware roadmap realignment
  • voice-assisted check-ins
  • privacy-respecting local-first AI support
  • workflow systems that account for cognitive peaks, dips, and uneven profiles

Rather than replacing thinking, Deving Gene is intended to help users hold onto their thinking long enough to execute on it.


Repository status

What’s here today

General Stuff

  • License ✔️
  • Planning docs, architecture notes, and implementation plans ✔️
  • Trello REST API Integration (reading card progress throughout the day outloud via Alexa Skill) ✔️
  • Schedule block chunking, idle alerts, site blocking (via NextDNS API), schedule syncing (PC->Alexa, Alexa Intents for schedule realignment to allow Alexa to jump blocks) ✔️
  • Conversation hygiene storage under convos/ ✔️
  • Local-first config and integration scaffolding ✔️

Apps In Development / Partially Working

Deving Gene currently spans multiple subprojects in a monorepo-style setup:

  • apps/pc-client - local orchestration layer, FastAPI micro-APIs, schedule sync, conversation hygiene, Alexa bridge, LLM routing, focus/fallback tooling, and EVC voice features
  • apps/pc-assistant - Tauri + Next.js desktop assistant for chat, hygiene metrics, pending ops, project switching, and Alexa hand-off
  • apps/pc-dashboards - Tauri + Next.js dashboards for convos, insights, projects, learning, sessions, alerts, and offline filesystem fallback
  • apps/alexa-skill - Alexa intents, routines, session handling, SSML-safe readouts, and PC communication glue
  • apps/vscode-extension - VS Code sidebar/webview for Deving Gene insights and editor-connected workflows

Supporting repo areas include:

  • configs/ - shared JSON config map and docs
  • convos/ - canonical conversation/session store
  • docs/ - API reference, configuration guide, PRD, and integration plans
  • packages/shared/ - shared workspace code

What’s not here yet

  • Public Source code, release packages (scheduled OSS: 2026, around Q3-Q4 2026) ⏳

What is still in progress

  • config cleanup and onboarding polish
  • broader desktop/UI packaging
  • adaptive profile expansion (more telemetry layers)
  • richer AI workflow and telemetry layers
  • tighter cross-app integration ergonomics

TL;DR value

Adaptive workflow support

Deving Gene is being designed to help users shape their workflow around how they actually think, instead of forcing them into rigid generic systems.

Roadmap-driven focus

Supports roadmap chunking across monthly, weekly, and day-level planning, with schedule realignment tools that help users recover from drift without losing the whole day.

Local PC orchestration

The PC Client serves as the local control point for scheduling, sync, automation behaviors, focus enforcement, LLM routing, and conversation hygiene.

Executive-function scaffolding

The system is designed to reduce the "what am I supposed to be doing right now?" tax through structured external memory, roadmap systems, check-ins, and workflow glue.

Local-first and least-privilege design

Deving Gene is built around the belief that helpful systems should not need unlimited access to be useful.


Current Features Implemented behavior

Alexa specific behavior

Admittedly, part of the charm of using this workflow is the Alexa specific behavior (which is deterministic and least-privilege based on project & user settings, preventing certain data from being shared)

  • Mindfulness Breaks: Allows proper breaks to preserve proper energy for coding sessions/prevent burnout

  • Webhook Routines: Allows Webhook Routine Triggers to be configured in a similar manner as Virtual Smart Home WebhookRoutineTrigger) for proper Alexa communication

  • Schedule Sync / Alignment State

    The PC Client and Alexa Skill already exchange schedule and session data. The current backend supports routes such as:

    • /alexa/schedule
    • /alexa/roadmap
    • /alexa/status
    • /receive-session-data

    This means Alexa can stay aware of roadmap state while the PC layer can fall back to local schedule data when Alexa session data is unavailable.

    Side Note: Triggering Alexa BlockIntents (i.e, JumpForwardBlockIntent with trigger "Alexa, jump to the next block") -> also realigns the schedule on PC. This allows for more hands free realignment, mitigating rumination and feeling of shame loops when missing deadlines.

PC Client Integration

Current Configuration (as of March 31st, 2026)

The current PC Client is the main local coordination layer. It already exposes FastAPI endpoints for:

  • Alexa schedule and status sync
  • conversation turns and summaries
  • pending ops and apply/reject flows
  • MCP tool listing/execution
  • learning summaries
  • EVC microphone and streaming support (for metacognitive strategies + data)
  • periodic snapshotting (takes snapshots of whats going on, gets summaries compiled by )

It also maintains local fallback behavior when Alexa session state is unavailable, which keeps roadmap/schedule-related workflows usable from the PC side.

LLM routing and local-first safeguards

The current backend already contains:

  • local and cloud adapter plumbing
  • Ollama-first local routing support
  • per-turn model/provider/origin metadata handling
  • Corporate Mode alignment in project docs and config direction (specific project files handling MCP, code sharing, etc behavior- with proper PII redaction models integrated for good measure)
  • SSML-safe local readout flow for Alexa (depending on user settings. SSML readout can be used for regulation and personalized "training" scripts, as well as other updates)

Expanded Verbal Comprehension & additional voice features

The pc-client includes implemented Expanded Verbal Comprehension groundwork (real-time analysis of what you are saying outloud) including:

  • realtime STT routes and runtime management
  • microphone enumeration/config support
  • transcript post-processing (with contextual awareness)
  • todo card extraction/validation (able to generate based on thoughts reasoned outloud)
  • prosody capture, enrichment, snapshots, and session baselines (for memory, and helping "Deving Gene" learn how you react to cues, your behavior while developing, etc)
  • voice log append/readback support

Focus and interruption tooling

The current PC-side (pc-client, pc-assistant) codebase includes focus-oriented infrastructure for:

  • idle monitoring (pc-client) - doesn't constantly nag you; has situational awareness to distinguish micro-breaks / dopamine "bursts" of media/thought engagement
  • app switching awareness (for locally logging how certain apps help reset dopamine)
  • session logging (pc-client)
  • schedule/block behavior handling (task chunking and "mode" switching-allowing for different blocks to help with daily executive function tasks)
  • media/site blocking integrations (via NextDNS, currently experimental-planned MCP control later)
  • tray/runtime helpers and local client control

Desktop assistant and dashboards

The desktop surfaces are no longer just planned. Current apps include:

  • PC Assistant with chat UI, project switching, pending ops, hygiene cards, error toasts, and "Read via Alexa"
  • PC Dashboards with longitudinal convos, insights, learning, sessions, alerts, projects, and offline filesystem fallback (allows for macro-pattern analysis of how you develop & work throughout your day)
  • VS Code extension with a sidebar webview and prebuilt webview UI pipeline

Screenshots

Alexa Skill Simulator

PC Client

Alexa Trello Audit

RTFocuser Extension Preview

Alexa Routine Image

Studio focus/idle indicator (RTFocuser add-on)

PC Assistant App (Preview)

PC Dashboards (Preview)


Repository layout

Current high-level layout contains different folders for the monorepo subtree

.
|- apps/
|  |- alexa-skill/        # Alexa skill subtree package, lambda handlers, interaction models
|  |- pc-assistant/       # Tauri + Next.js desktop assistant
|  |- pc-client/          # Python/FastAPI orchestrator, storage, voice, adapters, tests
|  |- pc-dashboards/      # Tauri + Next.js dashboards with offline fallback
|  `- vscode-extension/   # VS Code extension + webview UI
|- configs/               # Shared config files and schema docs
|- convos/                # Canonical conversation/session store
|- docs/                  # PRD, API reference, configuration, implementation plans
|- packages/
|  `- shared/             # Shared workspace package(s)
|- resources/             # Project assets/resources
`- tools/                 # Supporting scripts and tooling

Roadmap

  • 2024 Q4 — Alexa Skill, PC Client, Extension developed ✅

  • 2025 Q1 — Local host tunneling (to expose data from PC Client->Alexa Skill), webhook routine, cross-platform communication established ✅

  • 2025 Q2 — Roadmap, timeboxing, pomodoro session, site blocking (via NextDNS API) ✅

  • 2025 Q4 — Private beta/alpha testing, image-first docs ✅

  • 2026 Q1-Q2 — Monorepo architecture honed (pc-assistant, pc-dashboards integration) + LLM support (tested with Ollama + embeddings)

  • 2026 Q3-Q4Open-source initial release (timeline may vary)

  • 2026 H2 — automation packs, richer analytics, deeper-app integration & experiments (for audits/exports -- monitoring progress)


TO DO:

  • Need more customizability/reliable local host tunneling, as well as dynamic routine creation/deletion
  • More intuitive onboarding process, documentation, and features to become a "true workflow"
  • Confirm proper safety protocols are implemented when exposing localhost/ensure skill interacts only with the right tools

License

This repository is licensed under Apache 2.0. See LICENSE.

Project summary

Deving Gene is a local-first focus, automation, and workflow scaffolding system for developers who need more adaptive support than standard productivity tools usually provide.

It combines voice workflows, local orchestration, roadmap systems, dashboards, desktop clients, editor integrations, and evolving AI-assisted workflow layers to help users maintain context, protect flow state, and build with more consistency.

Status: WIP, with broader OSS release work targeted for 2026.

About

Focus, automation, and metacognitive scaffolding toolkit designed to aid twice-exceptional & neurodivergent developers. Combines an Alexa skill, VS Code extension, and biofeedback data with MCP Server and LLMs.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors