Product Map

Purpose #

Show every actor who interacts with aidokit, the CLI itself, the extensions, the emitted tree, and the user's AI coding CLI.

Diagram #

%%{init: {
  "theme": "base",
  "themeVariables": {
    "fontFamily": "ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif",
    "fontSize": "14px",
    "primaryColor": "#eff6ff",
    "primaryTextColor": "#0f172a",
    "primaryBorderColor": "#2563eb",
    "lineColor": "#475569",
    "secondaryColor": "#f1f5f9",
    "tertiaryColor": "#ffffff",
    "clusterBkg": "#f8fafc",
    "clusterBorder": "#cbd5e1"
  }
}}%%
flowchart LR
  classDef actor    fill:#ede9fe,stroke:#6d28d9,color:#1e1b4b,stroke-width:1.2px;
  classDef cli      fill:#dbeafe,stroke:#1d4ed8,color:#0c1f4a,stroke-width:1.4px;
  classDef adapter  fill:#cffafe,stroke:#0e7490,color:#083344;
  classDef pack     fill:#dcfce7,stroke:#15803d,color:#052e16;
  classDef core     fill:#fef9c3,stroke:#a16207,color:#422006;
  classDef artifact fill:#f1f5f9,stroke:#475569,color:#0f172a;
  classDef stop     fill:#fee2e2,stroke:#b91c1c,color:#7f1d1d,stroke-dasharray:4 3;
  classDef ok       fill:#ecfdf5,stroke:#047857,color:#064e3b;
  classDef external fill:#fff7ed,stroke:#c2410c,color:#431407;

  subgraph users [Users]
    dev["Developer"]:::actor
    qa["QA"]:::actor
    maint["Maintainer"]:::actor
    third["Third-party adapter author (post-v1.0)"]:::actor
  end

  cli["aidokit CLI
(unscoped npm)"]:::cli

  subgraph ext [Extensions]
    adapters["@aidokit/adapter-*
claude-code / codex / copilot"]:::adapter
    packs["@aidokit/stack-pack-*
node-ts / node-js / python / react / go"]:::pack
  end

  subgraph shared [Shared catalogs + docs]
    mcp["@aidokit/mcp-catalog"]:::core
    bs["@aidokit/base-skills"]:::core
    sd["@aidokit/shared-docs"]:::core
  end

  subgraph emitted ["Emitted into the user's project"]
    eng[".claude/ / .codex/ / .copilot/
engine directory"]:::artifact
    rules["CLAUDE.md / AGENTS.md / .github/copilot-instructions.md"]:::artifact
    docs["docs/ skeleton"]:::artifact
    art["agent-artifacts/ skeleton"]:::artifact
    state[".aido/adapter.md + state.json"]:::artifact
  end

  aicli["User's AI coding CLI
(Claude Code / Codex / Copilot)"]:::external
  npm["npm registry
+ provenance attestations"]:::external

  dev --> cli
  qa --> cli
  maint --> cli
  cli --> adapters
  cli --> packs
  cli --> mcp
  cli --> bs
  cli --> sd
  cli --> eng
  cli --> rules
  cli --> docs
  cli --> art
  cli --> state
  eng --> aicli
  rules --> aicli
  third -.->|publishes| npm
  npm -.->|npx install| cli

What this shows #

• aidokit is a one-shot CLI — it writes files, then exits. It does not run alongside the AI coding CLI.
• Extensions are siblings (concepts/adapters-and-stack-packs.md).
• Emitted content is the deliverable — what the user's AI coding CLI consumes.
• Third-party adapter authors interact via npm, not via a plugin system. There is no runtime registry.

Related Pages #

• system-overview.md — internal package layering
• adapter-composition.md — how 1 adapter + N packs combine
• .docs/ARCHITECTURE.md §1