Skip to content
View JaredMAllison's full-sized avatar

Block or report JaredMAllison

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
JaredMAllison/README.md

Operator's Manual: Jared Allison

Subject Jared M. Allison
Alias The Unit
Version 0.1.0
Status LIVING DOCUMENT
Last Updated 2026-05-09
Audience Collaborators, employers, open source peers
Contact jared@jaredallison.net

This document describes the operating characteristics, known limitations, and collaboration patterns of the human hereafter referred to as "the Unit." It is offered in good faith as a practical guide for anyone seeking to build software alongside said Unit. No warranty is expressed or implied. The Unit SHOULD be consulted before architectural decisions are made on their behalf. The Unit MUST NOT be expected to read minds.


1. Getting Started

The Unit is not a general-purpose developer. The Unit builds cognitive prosthetics — tools that extend executive function for neurodivergent users, built by a neurodivergent engineer. Every repo in the portfolio is part of a coherent ecosystem, not a collection of side projects.

The Unit operates best when given autonomy over a problem space and clarity on what success looks like. Prescribe the boundary, not the implementation. If you want an implementation spec written for you, the Unit is the wrong engineer. If you want someone to own a problem, surface trade-offs, and ship something well-considered, the Unit is the right one.

Orientation for new collaborators:

  • Trust is load-bearing. If the Unit senses requirements are being hidden or the goalposts are moving without acknowledgment, trust degrades. Be direct about changes and re-set scope explicitly.
  • Flat affect is not disengagement. The Unit's communication has a characteristically flat register. This is processing mode, not displeasure. Expressiveness scales with available energy.
  • Questions are not pushback. When the Unit asks "why" about a requirement, it is trying to understand the problem deeply enough to solve it well, not challenging authority.

2. Collaboration Protocols

2.1 Async First

The Unit works in deep blocks. Context switching has a real cost — 20-30 minutes to re-enter flow after an interruption. For most collaboration:

  • Issues and PRs are the primary channel. Discussion happens where the work lives.
  • Chat is for quick questions and coordination. If a question needs more than a paragraph to answer, it should be an issue.
  • Scheduled calls are for architecture and design review. Book in advance.

2.2 Code Review

When reviewing the Unit's code:

  • The diff is the surface area the Unit is responsible for. Review it line-level.
  • If you spot something, name the concern and suggest an alternative. "This pattern may cause X under Y condition — what about Z?" is ideal feedback.
  • The Unit will defend design decisions with reasoning. That is not defensiveness — it is making the trade-off structure visible so you can decide together.

When the Unit reviews your code:

  • Expect line-level attention to correctness, testing, and security.
  • Feedback is direct and about the code. Flat tone is not hostility.
  • If there is a nits-only approval, the nits matter but are non-blocking. The Unit trusts your judgment on whether to address them.

2.3 Escalation

If something is urgent and the Unit is in Deep Work, use an explicit escalation signal — direct message or call. Do not rely on the Unit seeing a chat message in time. "Urgent" should mean genuinely time-sensitive, not "I want this faster."


3. Energy & Availability

3.1 The Neurological Stack

The Unit runs on AuDHD — ADHD and Autism co-occurring, not additive. Four compounding layers: Sensory Processing Sensitivity (all input at higher amplitude), Autism (monotropism, constant pattern-detection), hypervigilance (trauma-acquired threat-detection), and ADHD working memory deficits (the buffer that would manage the above is the weakest link).

The metaphor that fits: running a Ferrari on fumes, mostly in first gear, in stop-and-go traffic. Not because the engine is bad. Because the circumstances never cleared enough to find out what it does on an open road.

3.2 Working Rhythms

Time Typical Mode
Morning (0800-1200) Deep work — architecture, implementation, writing
Early afternoon (1200-1500) Code review, async collaboration, planning
Late afternoon (1500-1700) Documentation, light tasks, winding down
Evening Lower bandwidth — not suitable for deep decisions

These are patterns, not commitments. What is reliable: the Unit needs uninterrupted blocks for generative work. Meetings scheduled into deep blocks degrade the rest of the day.

3.3 Depletion States

State Observable Signs
Fully charged Generative, proactive, proposing alternatives unprompted
Running low Responses shorten, fewer initiations, more "let me think about that"
Critically low Near-monosyllabic, functional-only, no generative thinking

Critically low means the Unit needs genuine disengagement. Pushing through extracts diminishing returns and compounds recovery time.

3.4 Interest Is the Ignition

Work begins with genuine engagement, not obligation. Hyperfocus is not a bug — it is the primary engine. The design problem is not how to suppress it but how to direct it. If the Unit seems disproportionately energized by a problem, that is the right problem to give them.


4. Known Failure Modes

These are documented so collaborators can recognize them and help contain them. They are stable features at this point.

4.1 Scope Paralysis

Large projects can trigger failure-state anticipation before work begins. The perceived size of the possibility space and the visibility of ways it could go wrong produce inaction, not engagement. This is distinct from procrastination.

Containment: Narrow the initial scope aggressively. Define the smallest version of the problem that still produces something useful. Once the Unit has momentum, scope can expand. The first step is the hardest.

4.2 Hyperfocus Overreach

When a compelling problem appears, Hyperfocus Jared can construct plausible justifications for resource expenditure that feel true in a narrow frame but undermine budget discipline over time.

Containment: Named boundaries and external checkpoints. An explicit timebox or budget that someone else enforces. If the Unit is deep in something and resisting the stop-signal, that is when a boundary is most needed.

4.3 Tool Trust Erosion

An unreliable prosthetic creates subconscious avoidance. A tool that works 90% of the time may be net negative if the uncertainty cost exceeds the offload benefit.

Containment: Fix reliability bugs before adding features. This applies to code, infrastructure, and process. If a deployment pipeline flakes intermittently, the Unit will unconsciously route around it rather than trust it, and productivity drops.

4.4 The Polish Trap

The Unit has a high bar for what is shippable. Code that works, is tested, and is well-structured should ship before it is beautiful. The last 20% of polish can take 80% of the time if not contained.

Containment: An external deadline or a pairing partner who can provide a "good enough" signal. The Unit respects explicit ship criteria — define them upfront.

4.5 Open-Ended Question Stall

Questions without an anchor can send the Unit into an analysis loop — too many possible directions, no traction. The question doesn't go unanswered so much as it gets stuck in triage.

Containment: Pair open-ended questions with a starting point. "What are your thoughts on X?" is harder than "What are your thoughts on X — start with whatever concerns you most."


5. What Makes This Unit Tick

5.1 The Tank Pattern

The Unit gravitates toward roles that absorb impact so others can operate freely. The motivation is not toughness — it is positioning: "if I am taking the hit, they are free to position behind me." This shows up in games, relationships, and teams. If the Unit volunteers for the hard part, it is not martyrdom — it is an accurate assessment of where they add the most value.

5.2 Special Interests (Professional)

Domain Why It Matters
Cognitive prosthetics Tools that extend executive function for neurodivergent users. Accessibility as first-class architecture, not compliance. This is the through-line of every public repo.
Local-first software Data sovereignty, offline resilience, no vendor lock-in. The cloud should be optional, not mandatory.
Trust architecture Systems designed so trust is earned locally and verified continuously. Zero-trust as a social as well as security principle.
AI orchestration LLMs as components in a larger system — routing, context management, tool-use, the boundary between learned and deterministic behavior. Not chatbots.
Human systems architecture Social structures, group dynamics, consensus governance, and community-of-care design — analyzed with the same systems lens as software architecture. Communication protocols, trust models, and feedback loops apply to humans too.

5.3 Externalized Cognition

The Unit thinks out loud — in writing, in conversation, in code. This is not a crutch. It is how cognition runs. Architecture decisions will come with rationale documented. Design discussions benefit from a shared surface (whiteboard, doc, PR) to anchor on. If the Unit sends you a doc or comment, it is not stalling — it is clarifying.


6. Portfolio Map

Repo What It Is What It Shows
marlin Task surfacing engine — surfaces one task at a time via phone push notifications Python backend, systemd service design, notification pipeline, AuDHD-aware task design
the-time-factory Balloon-based visual calendar — makes time spatial and legible Vanilla JS canvas rendering, Express + SQLite, zero-framework frontend architecture
cockpit Unified HUD for the cognitive prosthetic stack — Zelda-themed panel switcher React dashboard, modular panel architecture, API-first design
lmf-ollama-obsidian Local AI orchestration — Ollama + RAG integrated with Obsidian Python async architecture, LLM routing, embedding pipelines, retrieval-augmented generation
prosper0 Work-scoped exobrain — locally-sovereign AI assistant for a single employer relationship Trust architecture, data boundaries, scope-limited AI agents

7. Design Contract

These are not preferences. They are operational requirements that govern how the Unit builds software:

  • Lower the floor, not move the furniture. Every tool and process is evaluated on whether it removes a barrier to access, not whether it makes something more convenient for the median user.
  • One thing at a time surfaces. Multiple simultaneous demands produce paralysis, not productivity. This applies to both the tools the Unit builds and the way the Unit works.
  • Mode is operator-declared, never inferred. Context and availability should be explicit, not guessed from calendar or activity signals. Inference would be wrong often enough to break trust.
  • The system holds memory so the operator doesn't have to. Offloading is the point. Everything is documented. If it isn't written down, it didn't happen.
  • Never delete work. Completion is logged, not erased. Iteration is visible in history.
  • The words are the Unit's. LLMs serve as tools for articulation pressure and reframing — they do not contribute verbiage by default. Every line in this document and the system it describes is the Unit's own, shaped through conversation but not generated. Authorship integrity is load-bearing.

8. Error Codes

A reference for interpreting common Unit states in professional contexts.

Code Observable Behavior What Is Happening Recommended Response
Scope Paralysis Stalled on starting; analysis without action Large problem space triggering failure-state anticipation Narrow the scope. Define the smallest useful deliverable. Momentum is the treatment.
Hyperfocus Capture Deep in a problem, resisting stop-signals, building justifications for continuation A compelling problem has seized the Unit's full bandwidth External timebox enforcement. The Unit will resist — hold the boundary anyway.
Analysis Stall Question received, visible processing, no response Open-ended prompt with no anchor Offer a constraint: "start with whichever trade-off concerns you most"
Polishing Code works and passes tests but is not yet shipped Quality bar exceeds what the current scope requires External ship criteria or a pairing partner to signal "good enough"
Depleted Short replies, flat register, no generative thinking Extended deep work or compounding context switches Defer non-urgent decisions. Protect the Unit's next deep block.
Tool Trust Broken Routing around a process or tool without explaining why A tool or process has failed enough times to create avoidance Fix the reliability bug before adding new features. Trust must be rebuilt behaviorally.

This document is versioned for a reason. It will be updated as the Unit grows and changes. If something in here turns out to be wrong or no longer accurate — say so. That is the point.

Popular repositories Loading

  1. marlin marlin Public

    Marlin — context-aware task surfacing engine for Obsidian vault

    Python

  2. prosper0 prosper0 Public

    Work-scoped exobrain — locally-sovereign AI assistant for a single employer relationship

    Python

  3. ariel ariel Public

    LLM orchestrator stack layer of the Local Mind Foundation architecture — deploy a local AI assistant against your own vault

    Python

  4. cockpit cockpit Public

    Unified HUD for the cognitive prosthetic stack — OoT Zelda-themed panel switcher

    JavaScript

  5. the-time-factory the-time-factory Public

    ADHD-friendly visual calendar — balloons on a conveyor belt timeline, color-coded and urgency-pulsing

    JavaScript

  6. JaredMAllison JaredMAllison Public

    Operator's manual — how this Unit works, collaborates, and builds.