# Build Tools Used in i-have-adhd: Understanding the Repository's Minimal Build System

> Discover the minimal build system in the i-have-adhd repository. Learn how it leverages npm for dependency management and CLI installation without traditional build steps.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: internals
- Published: 2026-07-30

---

**The i-have-adhd repository uses only npm as its build-related tool, solely for installing the Claude Code CLI in CI workflows and user environments; it contains no compilation, bundling, or traditional build steps.**

The **i-have-adhd** project is a collection of configuration and documentation files that define an agent skill for AI coding assistants. Unlike traditional software projects, it does not contain application source code that requires compilation, bundling, or other standard build processes. According to the source code analysis of `ayghri/i-have-adhd`, the repository relies exclusively on the npm package manager for specific CLI installation tasks.

## What Build Tools Are Used in i-have-adhd?

The repository's build tool landscape is intentionally minimal. The only build-related tool present is **npm** (Node Package Manager), which appears in two specific contexts within the codebase.

### npm for CLI Installation

The repository utilizes npm exclusively to install the Claude Code CLI utility. This is the single build-related dependency in the entire project. No JavaScript bundlers like Webpack or Rollup, no task runners like Gulp or Grunt, and no compiled language build systems like Make, Gradle, or Maven are present in the source code.

### Absence of Traditional Build Systems

A thorough review of the repository files—including `.github/workflows/`, root configuration files, and documentation—confirms that **no traditional build systems** are referenced or required. The project contains:

- **Skill definition files**: [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md), `agents/*.toml`, and `agents/*.yaml` that are read directly by supported agents
- **Hooks**: [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) and [`hooks/always-on.sh`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/always-on.sh) that agents load at startup
- **Documentation**: [`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md), [`GEMINI.md`](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md), and language-specific README files

Because the skill is interpreted at runtime by the various agents (Claude Code, Codex, Gemini CLI, Zed, etc.), there is no compilation step required.

## How npm Is Used in the Repository

The npm package manager serves two distinct purposes within the i-have-adhd codebase: automating CI/CD testing and facilitating user installation.

### CI/CD Workflow Integration

In [`.github/workflows/plugin-load-check.yml`](https://github.com/ayghri/i-have-adhd/blob/main/.github/workflows/plugin-load-check.yml), npm installs the Claude Code CLI globally before testing the plugin load. This workflow ensures the skill configuration loads correctly across different agent environments.

```bash

# Install the Claude Code CLI (the only npm step required)

npm install -g @anthropic-ai/claude-code

```

The workflow file uses this command to prepare the testing environment, after which the plugin validation occurs without additional build steps.

### User Installation Process

The [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) file documents how end users install the plugin via the Claude Code CLI, which itself is distributed through npm. Users execute the following sequence:

```bash

# Install Claude Code globally via npm

npm install -g @anthropic-ai/claude-code

# Add and install the i-have-adhd plugin

claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

```

These commands represent the complete "build" process for the end user—simply installing the agent capable of interpreting the skill files.

## Repository Structure Without Build Steps

The i-have-adhd repository is designed for immediate interpretation by AI agents, eliminating the need for preprocessing or compilation. Key files include:

- **[`skills/i-have-adhd/agents/gemini.toml`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/agents/gemini.toml)**: Defines custom Gemini CLI commands without requiring a build step
- **[`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json)**: Declares session-start hooks that agents load automatically
- **[`hooks/always-on.sh`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/always-on.sh)**: Shell script executed by agents at runtime
- **[`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md)**: Contains overview and quick install snippets

Every component in the repository is a configuration file, documentation asset, or interpreted script. The "build" step is simply installing the agent or the plugin via npm, after which the skill becomes operational.

## Summary

- **i-have-adhd** uses **only npm** as a build-related tool, exclusively for installing the Claude Code CLI
- **No compilation** or bundling is required; the repository contains configuration files interpreted at runtime
- **Two contexts** for npm usage: CI workflow testing ([`.github/workflows/plugin-load-check.yml`](https://github.com/ayghri/i-have-adhd/blob/main/.github/workflows/plugin-load-check.yml)) and user installation ([`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md))
- **Supported agents** (Claude Code, Gemini CLI, Codex, Zed) load skill files directly without preprocessing
- **Repository contents** include TOML/YAML skill definitions, shell hooks, and markdown documentation rather than source code requiring builds

## Frequently Asked Questions

### Does i-have-adhd require compilation?

No, the i-have-adhd repository does not require compilation. The project consists of configuration files ([`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md), `agents/*.toml`, `agents/*.yaml`) and shell scripts that are interpreted at runtime by AI coding agents. There is no source code that needs to be transformed into executable binaries or bundled JavaScript.

### What package manager does i-have-adhd use?

The repository uses **npm** (Node Package Manager) exclusively. It appears only in the context of installing the Claude Code CLI globally via `npm install -g @anthropic-ai/claude-code`. This installation step is used both in the CI workflow defined in [`.github/workflows/plugin-load-check.yml`](https://github.com/ayghri/i-have-adhd/blob/main/.github/workflows/plugin-load-check.yml) and in the user installation instructions documented in [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md).

### Are there Docker or containerization build tools in i-have-adhd?

No, there are no Docker files, container configurations, or containerization build tools present in the repository. The project does not use Docker Compose, Dockerfile, or any other container build systems. The repository is designed to run directly on the host system where the AI agent is installed.

### How do I install the i-have-adhd plugin?

First, install the Claude Code CLI using npm: `npm install -g @anthropic-ai/claude-code`. Then add the plugin to your marketplace with `claude plugin marketplace add ayghri/i-have-adhd` and install it using `claude plugin install i-have-adhd@i-have-adhd`. These steps are documented in [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) and represent the only build-like process required to use the skill.