Package Index

Purpose #

Single table covering every @aidokit/* package: layer, responsibility, runtime deps on other @aidokit/* packages, and where it lives.

Big Picture #

Fifteen packages at v1.0. Layering rules in concepts/three-layer-architecture.md.

Table #

Package	Path	Layer	Runtime `@aidokit/*` deps	Responsibility
`aidokit` (unscoped CLI)	`packages/cli`	3	core, adapter-, stack-pack-, shared-docs, base-skills, mcp-catalog, prereq-check, stack-detect	User-facing shell (Commander + `@clack/prompts`); composes everything
`@aidokit/core`	`packages/core`	1	none (enforced)	Contracts (`Adapter`, `StackPack`), types, Zod schemas, `AidoError`, interpolate, conformance harness
`@aidokit/shared-docs`	`packages/shared-docs`	1	core	`docs/` + `agent-artifacts/` skeleton templates (v4-faithful)
`@aidokit/stack-detect`	`packages/stack-detect`	1	core	Safe `DetectContext` builder + parallel detector orchestration
`@aidokit/prereq-check`	`packages/prereq-check`	1	core	Detection-only prereq checks; per-OS install hints
`@aidokit/mcp-catalog`	`packages/mcp-catalog`	1	core	MCP catalog (TS const array), trigger evaluator, install resolver
`@aidokit/base-skills`	`packages/base-skills`	1	core	18 v4 base skills as `SkillTemplate[]`; extracted from CLI for third-party reuse
`@aidokit/adapter-claude-code`	`packages/adapter-claude-code`	2	core	Claude Code adapter, Strict conformance (CHANGELOG `[0.5.0]`)
`@aidokit/adapter-codex`	`packages/adapter-codex`	2	core	Codex adapter, Minimum conformance
`@aidokit/adapter-copilot`	`packages/adapter-copilot`	2	core	Copilot adapter, Minimum conformance (ADR-0016)
`@aidokit/stack-pack-node-ts`	`packages/stack-pack-node-ts`	2	core	Node + TypeScript
`@aidokit/stack-pack-node-js`	`packages/stack-pack-node-js`	2	core	Plain Node JS
`@aidokit/stack-pack-python`	`packages/stack-pack-python`	2	core	Python (ruff / mypy / pytest)
`@aidokit/stack-pack-react`	`packages/stack-pack-react`	2	core	React (composes with `node-ts`)
`@aidokit/stack-pack-go`	`packages/stack-pack-go`	2	core	Go

The `@aidokit/core` constraint #

@aidokit/core MUST have zero runtime deps on other @aidokit/* packages (CLAUDE.md §4). This is what lets a third-party adapter author install only @aidokit/core and build against the contract.

Package conventions #

From ADR-0004 §9:

Every published package.json carries "license": "Apache-2.0", "type": "module", "engines": { "node": ">=20.0.0" }.
files allowlist: ["dist/**", "README.md", "LICENSE", "NOTICE", "CHANGELOG.md"].
Workspace deps use workspace:*; Changesets rewrites at publish.
Templates under packages/*/src/files/ are tree-copied to dist/files/ by a scripts/copy-files.mjs post-tsc step.

Reading order for a new contributor #

To get a feel for the codebase:

packages/core/src/types.ts and src/schema.ts — the contracts.
packages/core/src/error.ts and src/interpolate.ts — the small helpers.
packages/mcp-catalog/src/catalog.ts — the smallest data-driven package.
packages/stack-pack-node-ts/src/index.ts — the simplest stack pack.
packages/adapter-claude-code/src/index.ts — the largest adapter.
packages/cli/src/run.ts + commands/init.ts — orchestration.