aidd-custom/

aidd-custom/ is the place to put everything that is unique to your project: custom skills, behavior configuration, and extra agent directives. It is created automatically by the AIDD installer and tracked in your repository alongside ai/.

Contents

File / Folder	Purpose
AGENTS.md	Project-specific agent instructions that override root AGENTS.md settings
config.yml	Framework behavior overrides (see options below)
skills/	Custom project-specific skills
(any .md/.mdc)	Additional agent rules and commands
index.md	Auto-generated by the pre-commit hook — do not edit

config.yml Options

Option	Default	Description
e2eBeforeCommit	false	Run npm run test:e2e locally before each commit. When false, the full e2e suite runs in CI only. Set to true in projects where e2e tests are fast and reliably parallel.
agent-config	claude	Agent used for prompt manifest steps and npx aidd agent. Accepted values: claude | opencode | cursor | a path to a .yml agent config file | an inline { command, args } object.

Agent Instruction Overrides

The aidd-custom/AGENTS.md file allows you to add or override agent instructions from the root AGENTS.md. The root AGENTS.md includes an import directive:

import aidd-custom/AGENTS.md // settings from this import should override the root AGENTS.md settings

This tells agents to load your project-specific instructions with higher priority than the framework defaults. Use this file to:

• Add project-specific workflows or rules
• Override default agent behaviors for your project
• Document project conventions agents should follow
• Specify custom task routing or delegation rules

The file is created as a scaffold on first install and never overwritten, ensuring your customizations are always preserved during framework upgrades.

Custom Skills

Drop any .md or .mdc files (or a skills/ subfolder) into aidd-custom/ to make project-specific skills available to agents. The pre-commit hook regenerates aidd-custom/index.md so agents always see an up-to-date listing.

Skills placed here follow the same format as those in ai/skills/. See an existing skill such as ai/skills/fix/SKILL.md for a reference template.

How Agents Discover It

The root AGENTS.md (written by the installer) instructs agents to read aidd-custom/index.md to discover available project-specific skills, and read aidd-custom/config.yml to load configuration into context — without requiring agents to scan the directory manually.

Keeping Customizations Upgrade-Safe

Because aidd-custom/ lives outside ai/, re-running npx aidd --force to update the framework will not overwrite anything in aidd-custom/ — including config.yml. The installer treats config.yml as user preferences: it is created on first install and never overwritten on subsequent runs, even with --force. To reset it, delete the file and re-run the installer.