القائمة
Bootstrap AI-ready governance, traceability, cascade, catalog audits, and validation. Use when setting up AI SDLC; aliases: init-ai-repo and ai-sdlc-init.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Extract and save a DDD glossary, flag ambiguities, and propose canonical terms. Use when defining domain language or a shared vocabulary.
Explain broader code or product context around a focused area. Use when the user needs a higher-level perspective before local changes.
Design APIs/interfaces with Design It Twice: create alternatives, compare tradeoffs, choose one. Use when designing an API, module, class, or boundary.
Interview the user to stress-test a plan or design until decisions are clear. Use when the user wants to be grilled or challenge a plan.
Stress-test a plan against repo docs and update decisions inline. Use when challenging a design against documented language, ADRs, or CONTEXT.md.
Find deepening opportunities from CONTEXT.md and ADRs. Use when refactoring shallow modules, boundaries, coupling, or testability.
| name | ai-catapult-init |
| description | Bootstrap AI-ready governance, traceability, cascade, catalog audits, and validation. Use when setting up AI SDLC; aliases: init-ai-repo and ai-sdlc-init. |
Run this skill in the target repo. ai-catapult-init is the canonical skill name; init-ai-repo and ai-sdlc-init remain deprecated compatibility aliases. Use dry-run first when scope or host choices are unclear. Keep hosted settings as checklist output unless the user explicitly requests an admin/credentialed action.
Inspect repository state, host tooling, trackers, CI, and runtime conventions. Choose greenfield bootstrap, brownfield adoption, hosted-tracker-first, or local fallback. Emit .ai/matrix.json, .ai/init/repo-profile.json, .ai/init/sdlc-path.md, and .ai/phases/01-discover-decide/. OMX surfaces: $deep-interview, $plan, $ralplan; OMC surfaces must produce the same artifact contract.
Generate or refresh AGENTS.md, RULES.md, PLANS.md, CONTRIBUTING.md, active/archived specs, ADRs, .ai/work-intake/, .ai/plans/, and .ai/phases/02-govern-plan/. Ensure a hosted issue/ticket when configured and authorized. Local fallback is allowed before coding, but it must be reconciled before final PR merge. Require active spec/PRD, plan, and acceptance criteria before implementation.
Generate command/runtime surfaces and policy automation under .ai/bin/, .ai/policies/, .ai/commands/omx/, .ai/commands/omc/, .ai/language-packs/, optional Makefile/justfile, and .ai/phases/03-configure-generate/. OMX surfaces: $ralph, $team, $ultragoal, $ultrawork; OMC aliases/commands delegate to the same generated structures rather than duplicate semantics.
Run local validation, drift checks, generated smoke tests, and hosted/local ticket reconciliation. Emit .ai/validation/report.md, .ai/drift/migration-manifest.json, .ai/handoff/init-ai-repo-handoff.md, and .ai/phases/04-validate-handoff/. OMX surfaces: $doctor, $code-review, $team, $ralph. The handoff records done, verified, remaining, and reconciliation status.
The public workflow is four phases, but the generator preserves the original eight internal checkpoints for compatibility and traceability:
Every implementation initialized by this skill must assume protected main and PR-only delivery. Emit provider-specific branch-policy checklist/config artifacts unless the user explicitly authorizes hosted mutation with credentials. Admin users may self-approve only when host policy permits it and the host/runtime explicitly supports an admin approve/admin bypass lane for the same actor; all required checks must still pass. If the host rejects same-actor review approval (for example, GitHub hosted PR review), use a distinct admin reviewer or explicit host admin bypass/admin merge. Record the actor, authority, reason, checks, and approval mode, and fail closed when same-actor admin approval support cannot be proven.
When this skill creates or updates PR workflow guidance, require merge only after:
modules/ci-policy.md adds a mechanical eval-coverage check to this PR merge gate: a changed shippable skill must declare a structurally valid evalset. See modules/evals.md.
modules/README.md — read when choosing which Layer 3 module applies.modules/phases/README.md — read when mapping the four public phases to internal checkpoints.modules/topology.md — read when generating .ai/matrix.json or validating umbrella depth.modules/ci-adapters.md — read when an umbrella renders selected GitHub, ADO, or GitLab CI from its execution profile.modules/documentation-blueprint.md — read when generating the v3 .ai/, .memory/, and docs/ trees.modules/memory.md — read when defining .memory/human-override/ and .memory/self-learned schemas.modules/sync.md — read when implementing physical-copy sync and drift detection.modules/host-policy-automation.md — read when applying hosted branch/PR/policy mutations safely.modules/validation.md — read when validating generated artifacts, depth rules, and golden fixtures.REFERENCE.md — read only for legacy full template bodies that have not yet moved into focused modules.modules/readme-documentation.md — read when initializing, augmenting, or rewriting README.md.modules/release-versioning.md — read when initializing release tagging, versioning, or CI/CD release workflows.modules/workflow.md — read when generating repo workflow docs, workflow/status manifests, entry-surface links, and handoff indexes.modules/traceability.md — read when generating stable traceability IDs, graph schema, backlink validation, graph fixtures, or cross-skill requirement/work-artifact links.modules/cascade.md — read when generating multi-repo cascade plans, first-run confirmation gates, idempotent linked updates, host adapter contracts, audits, and reconciliation reports.modules/skill-modernization.md — read when auditing compact descriptions, progressive disclosure, trigger boundaries, cross-skill links, and AI-SDLC compatibility.modules/evals.md — read when generating the .ai/evals/ scaffold or the offline eval-coverage gate that modules/ci-policy.md adds to the PR merge gate.modules/mcp-a2a.md — read when generating the .ai/mcp/ registry stub and the A2A cross-agent handoff convention.modules/graph-automation.md — read when scaffolding automatic background knowledge-graph refresh via git hooks and harness hooks; covers the lock+coalesce wrapper, engine knob (default graphify, alternative graphwiki), hook-body contract, and ai-catapult graph-hooks install.SKILL.md under 100 body lines; move variants to modules.setup-skills and publish-semver host docs instead of copying their full semantics.