grinrus/aidd-init
skills/aidd-init/SKILL.md
Initializes AIDD workspace scaffolding for the current project. Use when bootstrapping canonical `aidd/` templates and project-owned test execution contract in `aidd/config/gates.json`. Do not use when the request is to start feature ideation (`idea-new`) or to inspect existing ticket progress (`status`).
$ install --global
skillsauthnpx skillsauth add grinrus/ai_driven_dev aidd-initInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 8:05 PM13.0s2 files scanned
SKILL.md
- name:
- aidd-init
- description:
- Initializes AIDD workspace scaffolding for the current project. Use when bootstrapping canonical `aidd/` templates and project-owned test execution contract in `aidd/config/gates.json`. Do not use when the request is to start feature ideation (`idea-new`) or to inspect existing ticket progress (`status`).
- argument-hint:
- [--force]
- lang:
- en
- prompt_version:
- 0.1.12
- source_version:
- 0.1.12
- model:
- inherit
- disable-model-invocation:
- true
- user-invocable:
- true
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. - Default behavior is idempotent: existing workspace files stay untouched unless
--forceis explicitly passed. --forceis limited to refreshing managed bootstrap/config artifacts and theqa.testscontract; it is not permission to overwrite user-authored workspace docs or reports.- Verify
aidd/exists and core templates were copied (aidd/AGENTS.md,aidd/docs/shared/stage-lexicon.md). - Verify
aidd/config/gates.jsoncontainsqa.testscontract fields (contract_version,profile_default,commands, defaults). - Return the output contract and next actions, explicitly stating whether the run was non-destructive or a forced refresh.
Command contracts
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-init/runtime/init.py
- When to run: always for canonical workspace bootstrap.
- Inputs: optional
--force. - Outputs: initialized
aidd/structure and synced managed bootstrap/config templates with bootstrappedqa.testscontract. - Failure mode: non-zero exit on invalid workspace, write failures, or template contract mismatch.
- Next action: fix workspace path/permissions or choose the correct
--forcemode, then rerun the same entrypoint.
Notes
- Planning stage:
AIDD:ACTIONS_LOG: n/a. - Without
--force, do not overwrite user-authored workspace docs or reports. - With
--force, refresh only managed bootstrap/config artifacts; user-authored workspace docs or reports still stay out of scope.
Additional resources
- Runtime implementation: runtime/init.py (when: init behavior or flags are unclear; why: verify exact bootstrap logic and exit conditions).
Related Skills
grinrus/tasks-new
tools
VerifiedTrustedCommunity
Derives or refines tasklist items from PRD and plan artifacts. Use when tasklist stage prepares implementation-ready work items. Do not use when the request is plan authoring in `plan-new` or loop execution in `implement`.
5SKILL.mdUpdated Apr 5, 2026
grinrus/status
testing
VerifiedTrustedCommunity
Generates consolidated ticket status summary and key artifact pointers. Use when checking current stage state or handoff readiness. Do not use when the request is diagnostics/inventory from `aidd-observability` or flow-state mutation via `aidd-flow-state`.
5SKILL.mdUpdated Apr 5, 2026
grinrus/spec-interview
testing
VerifiedTrustedCommunity
Collects missing spec inputs and synchronizes answers into `spec.yaml`. Use when review-spec leaves unresolved specification fields. Do not use when the request is readiness gating in `review-spec` or task derivation in `tasks-new`.
5SKILL.mdUpdated Apr 5, 2026
grinrus/review
testing
VerifiedTrustedCommunity
Runs review-stage validation for scope changes, findings, and follow-up task derivation. Use when review stage needs verdict and handoff tasks. Do not use when the request is direct implementation execution in `implement` or QA validation in `qa`.
5SKILL.mdUpdated Apr 5, 2026