AIDDbot

Imported from AIDDbot/AIDDbot (AGENTS.md). Install upstream with npx skills add AIDDbot/AIDDbot. Copyright stays with the author.

AIDDbot

This is not a traditional application. There is no application source code to build or test.

The deliverable are agent skills tailored to implement AI-Driven Development (AIDD) workflows.

Skills

• Folder: .agents/skills/
• Inventory, pipeline, and SDLC coverage: .agents/skills/skills.catalog.md — it summarizes the executable routing owned by orchestrators
• Human-oriented docs are in docs/
• Product development docs are in .product/

Editing skills

• Every SKILL.md uses concise English prose in the same voice as an instruction. Express composed control flow in sentences and short paragraphs; do not use indented pseudocode. Follow .agents/skills/maintain-skills/assets/skill.template.md. Always create or fix skills via /maintain-skills — do not edit skills ad hoc.
• Write only what a capable agent would get wrong on its own. Drop role (the agent file already has it) and workflow (the command already has it). Never paraphrase a linked template — the template in assets/ is the artifact's spec.
• Put guides and long checklists in references/; put templates in assets/. Link them from the skill (same skill folder only).
• Put paths, slugs, personality, git rules, and the spec status chain in the consumer {Agents_File} (generated by /document-system from document-system/assets/AGENTS.template.md); put skill-specific rules in that skill's SKILL.md.
• Every executable capability is a skill: public orchestrator skills own end-to-end outcomes and routing, while public primitive skills provide focused AIDD capability without invoking the next pipeline stage. Orchestrators name Architect, Builder, or Craftsman, reference target skills in backticks, and rely on native discovery and invocation so instructions load only when execution reaches them.
• After changing a skill, align the docs /maintain-skills tracks:
  • its SKILL.md
  • the catalog, when behavior, paths, or routing changed
  • the root README and workflow, only when what a human is told changes

Delegation

• Request portable delegation effort as low, medium, or high; use medium when it is not stated.
• Resolve the harness-native spawn controls from .aiddbot/efforts.yaml. If the harness, model, or reasoning setting is unavailable, inherit the parent's compatible settings.