@kiroku-solutions/kiroku-ai 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +36 -1
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -45,10 +45,45 @@ pnpm --dir CLI start init
45
45
 
46
46
  | Command | Description |
47
47
  | ---------------- | --------------------------------------------------------------------------- |
48
- | `init` | Guided stack builder; downloads skills into the engine's folders. |
48
+ | `init` | Pick a setup mode, then download skills into the engine's folders. |
49
49
  | `update` | Re-resolves the recorded stack, re-downloads, and prunes removed skills. |
50
50
  | `env [tool]` | Switches the AI tool: **migrates the folders** and regenerates its pointer. |
51
51
 
52
+ ### Setup modes
53
+
54
+ `init` starts by asking how much control you want:
55
+
56
+ | Mode | What it asks |
57
+ | ------------- | --------------------------------------------------------------------------------- |
58
+ | **Quickstart**| Pick one predefined stack (see presets below), then just the AI tool. |
59
+ | **Guided** | The classic stack questionnaire (scope → frontend → backend → db → deploy → devops).|
60
+ | **Modular** | Guided **plus** Architecture, Methodology and Development practices, and per-agent selection. |
61
+
62
+ #### Quickstart presets
63
+
64
+ | Preset id | Stack |
65
+ | ------------------- | --------------------------------------- |
66
+ | `nextjs-supabase` | Next.js + Supabase (fullstack, Vercel) |
67
+ | `astro-fastapi` | Astro + FastAPI (fullstack, Postgres) |
68
+ | `fastapi-supabase` | FastAPI + Supabase (backend API) |
69
+ | `sveltekit-postgres`| SvelteKit + Postgres (fullstack, Vercel)|
70
+ | `dotnet-postgres` | .NET API + Postgres (backend) |
71
+
72
+ Presets live in [`src/presets.mjs`](./src/presets.mjs) — add or edit entries there.
73
+
74
+ #### Engineering approach (Modular mode)
75
+
76
+ The Modular mode also captures, records (in the lockfile) and writes into the
77
+ pointer file an **Engineering approach** the AI must follow:
78
+
79
+ - **Architecture** (single): `layered`, `modular-monolith`, `hexagonal`, `clean`,
80
+ `microservices`, `event-driven`, `cqrs`, `serverless`, `mvc` (or none).
81
+ - **Methodology** (single): `scrum`, `kanban`, `scrumban`, `waterfall`, `xp`, `lean` (or none).
82
+ - **Development practices** (multi): `tdd`, `bdd`, `atdd`, `sdd`, `ddd`.
83
+
84
+ The matching docs come from `skills/architecture/`, `skills/methodology/` and
85
+ `skills/practices/` in the SSOT and install under your tool's skills folder.
86
+
52
87
  ### AI environments
53
88
 
54
89
  During `init` you pick the AI tool the project targets. The CLI installs into
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kiroku-solutions/kiroku-ai",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Interactive CLI to bootstrap Kiroku AI Standards (AI Context as Code) into any project.",
5
5
  "type": "module",
6
6
  "bin": {