Ingredients are the AIDD-local directive catalog. Each lives at
ingredients/<id>/INGREDIENT.md with optional support files. Recipes invoke them with
stepType: "ingredient"; backend-specific runs, including Claude Code, use
stepType: "aidd-cli" plus cliType.
aidd --project-dir <app> --check-artifacts writes .aidd/.artifacts-check.json from the
project assertion catalog (collectArtifactStatuses in shared/src/metadata/store/artifacts.ts).
Only the required/recommended/optional rows below are part of that catalog — those are the
only valid ArtifactSeverity values. The remaining rows (tracked/runtime/generated)
document related .aidd/ artifacts and how they are refreshed, but they are not checked by
--check-artifacts.
The check result records phase, preOnboarding, and staleThresholdDays (30) alongside the
per-artifact statuses. Missing required artifacts are informational until the project reaches
the coding phase — a fresh ingest has no spec.md yet because onboarding creates it later — so
the check only fails on missing required artifacts once phase is coding.
| Artifact | Severity | Refresh Process |
|---|---|---|
CONTEXT.md |
required | ingredient:grill-with-docs {app} |
.aidd/spec.md |
required | ingredient:review-doc {app}/.aidd/spec.md |
.aidd/assertions.md |
recommended | ingredient:review-doc {app}/.aidd/assertions.md |
.aidd/project-structure.md |
recommended | ingredient:review-doc {app}/.aidd/project-structure.md |
.aidd/project.md |
recommended | manual edits only; project-local overrides and goals |
.aidd/roadmap.json |
recommended | ingredient:update-roadmap {app} and aidd-tools roadmap:apply --project-dir |
.aidd/project-profile.json |
recommended | Web maturity flow or explicit assurance-profile edit |
.aidd/screen-map.md |
recommended | ingredient:update-screen-map {app} |
.aidd/testing-scenarios.md |
recommended | ingredient:testing-scenarios {app} |
.aidd/questions.md |
optional | ingredient:onboarding-interview {app} |
.aidd/responses.md |
optional | aidd --interview response index |
.aidd/responses/ |
optional | aidd --interview response files |
.aidd/features/*/feature.json |
tracked | ingredient:feature-review, ingredient:bug2feature, ingredient:doc2feature |
.aidd/CHANGELOG.md |
tracked | ingredient:document-changes, coding sessions |
.aidd/audit-reports/*.md |
tracked | audit runs and writeAuditReport |
.aidd/reports/*.md |
tracked | ingredients and recipes that create session or sweep reports |
.aidd/runs.jsonl |
runtime | AIDD orchestrator run ledger |
.aidd/iterations/*.json, .log |
runtime | AIDD iteration extraction and raw run logs |
.aidd/.artifacts-check.json |
generated | aidd --project-dir <app> --check-artifacts |
Related non-AIDD artifacts:
| Artifact | Refresh Process |
|---|---|
docs/** |
ingredient:document-changes {app} |