Getting Started

AIDDbot is a set of skills for your coding agent. You say what you need. The agent writes a spec, waits for you, then writes the code, the tests, and a new version.

Install

You need Node.js 18 or later, Git, and one coding agent: Claude Code, Codex, GitHub Copilot, or Cursor. Use a model from 2026 or later.

In the root folder of your repository, run:

npx github:AIDDbot/AIDDbot init

init adds the skills and commits them. If the folder is not a Git repository, it creates one. It never overwrites a file that already exists.

Prepare

Open your agent in the same folder and run:

/architect-system-foundation

In Codex, start each command with $ instead of /.

• Existing code: the agent documents it. It does not change it.
• Empty repository: the agent asks about your product, proposes a system, and builds it after you approve.

Deliver

Write the change in plain language:

/build-requested-spec riders can rate a trip from 1 to 5 stars

Read the spec. Approve it, or ask for changes. The agents then write the code, test it, and ship a new version.

Add YOLO to the request to skip that approval.

Repair

From time to time, run:

/craft-lasting-quality

The agents look for technical debt and repair the most important part.

Update

npx github:AIDDbot/AIDDbot update

update replaces the skills and keeps your project files.

The same guide, with a few extra notes, is in the repository: Getting started. To choose models, see Customize agent profiles.

Next: Workflow · GitHub