Follow feature-dev-aidd:aidd-core.
Steps
- Run
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-init/runtime/init.py. - Runtime-path safety: never call relative runtime paths; use only
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-init/runtime/init.py; if${CLAUDE_PLUGIN_ROOT}is not set, return BLOCKED with env hint. - Verify
aidd/exists and core templates were copied (aidd/AGENTS.md,aidd/docs/shared/stage-lexicon.md). - If
--detect-build-toolswas used, confirm.claude/settings.jsonwas updated. - Return the output contract and next actions.
Command contracts
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-init/runtime/init.py
- When to run: always for canonical workspace bootstrap.
- Inputs: optional
--forceand--detect-build-tools. - Outputs: initialized
aidd/structure and synced workspace templates/settings. - Failure mode: non-zero exit on invalid workspace, write failures, or template contract mismatch.
- Next action: fix workspace path/permissions, then rerun the same entrypoint.
Notes
- Planning stage:
AIDD:ACTIONS_LOG: n/a.
Additional resources
- Runtime implementation: runtime/init.py (when: init behavior or flags are unclear; why: verify exact bootstrap logic and exit conditions).