caio-startkit

caio-startkit is a framework for the logistics of AI projects: structured steps, artifacts, and handoffs from first assessment through production and adoption, so the initiative stays coherent.

That framework is what you run in Claude Code—one slash command per phase, each conversation writing a professional Markdown document on disk.

No UI. No backend. No build step. Just conversations that write files to your local machine.

Beta: This project is still in early shape. Several domain experts are trying it out and sharing feedback so the workflows and outputs can improve. If you use it, reactions and suggestions are welcome.

Installation

Option 1 — npx (recommended)

Run once from the root of any repository:

npx caio-startkit

Installs the command files into .claude/commands/ and adds initiatives/ to your .gitignore.

Option 2 — Clone

git clone [email protected]:amohsen1984/caio-startkit.git
cd caio-startkit

Commands are ready to use immediately — no install step needed.

Usage

Run commands inside Claude Code. Each command guides you through a conversation and writes a Markdown document to initiatives/<your-initiative-name>/.

| Command | Phase | Output | |---|---|---| | /caio.assess <name> | 1 — Business Alignment Assessment | phase-1-assessment.md | | /caio.usecase <name> | 2 — Use Case Plan Implementation | phase-2-usecase.md | | /caio.production <name> | 3 — From Pilot to Production | phase-3-production.md | | /caio.adopt <name> | 4 — AI Adoption Plan | phase-4-adoption.md | | /caio.export <name> | Export full portfolio | portfolio.md |

Example

/caio.assess northwind
/caio.usecase northwind
/caio.production northwind
/caio.adopt northwind
/caio.export northwind

Produces:

initiatives/
└── northwind/
    ├── phase-1-assessment.md
    ├── phase-2-usecase.md
    ├── phase-3-production.md
    ├── phase-4-adoption.md
    ├── portfolio.md
    └── archive/           ← previous versions saved here on re-run

See docs/quickstart.md for a step-by-step walkthrough.

How it works

• One command per phase. Each command is a Claude Code agent file that conducts a focused conversation.
• Context carry-forward. Each phase reads all prior phase documents so you never repeat yourself.
• Thin-answer prompting. If your answer is too brief, the AI asks targeted follow-ups until the answer is detailed enough to write a good document.
• Archive on re-run. Re-running any phase archives the previous document before starting fresh.

Phases this framework covers

| Phase | Covers | |---|---| | Business Alignment Assessment | Strategic pillars, AI readiness across 5 dimensions, recommended priorities | | Use Case Plan Implementation | Use case selection, Buy/Build/Hybrid sourcing, roadmap, risk assessment, ROI, governance | | From Pilot to Production | EU AI Act / NIST AI RMF compliance, monitoring, change management, scaling roadmap | | AI Adoption Plan | Hub-and-Spoke organising model, AI Hub roles, infrastructure, training strategy, enterprise roadmap |

Requirements

• Claude Code CLI
• Node.js ≥ 16 (only needed for the npx installer)