# Isis Architecture Kitbash Pack SDK End-to-End Examples Runbook

Last Updated: 2026-02-28  
Scope: `MXA-0190` SDK exposure for `architecture-kitbash-pack` workflows with
typed run contracts and end-to-end examples.

## Purpose

Generate and validate the canonical SDK contract artifact for
`architecture-kitbash-pack`, confirming typed workflow run methods, client
shortcuts, root exports, and runnable direct/chain/batch examples.

## Artifacts

- `docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_SDK_END_TO_END_EXAMPLES.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_SDK_END_TO_END_EXAMPLES.md`

## Generator

```bash
node scripts/isis/generate-v2-architecture-kitbash-pack-sdk-end-to-end-examples.mjs
```

Options:

- `--report-date=YYYY-MM-DD` (default: current UTC date)

## Validator

```bash
node scripts/isis/validate-v2-architecture-kitbash-pack-sdk-end-to-end-examples.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_GENERATION_API_TYPED_REQUEST_CONTRACTS.json`
- `libs/isis/client/src/resources/workflows.ts`
- `libs/isis/client/src/resources/workflows.architecture-kitbash-pack.spec.ts`
- `libs/isis/client/src/examples/architecture-kitbash-pack.ts`
- `libs/isis/client/src/examples/architecture-kitbash-pack.spec.ts`
- `libs/isis/client/src/client.ts`
- `libs/isis/client/src/index.ts`
- `libs/isis/client/src/resources/index.ts`

## Operational Cadence

1. Regenerate whenever architecture-kitbash-pack workflow IDs, required
   parameters, or SDK method signatures change.
2. Validate before closing SDK parity and documentation tasks tied to
   `MXA-0190`.
3. Keep SDK typed contracts synchronized with generation API typed contract
   guarantees from `MXA-0189`.

## Related Artifacts

- `libs/isis/client/src/resources/workflows.ts`
- `libs/isis/client/src/examples/architecture-kitbash-pack.ts`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
