@kiroku-solutions/kiroku-ai 0.2.0 → 0.2.2
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.
- package/README.md +64 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -45,9 +45,72 @@ pnpm --dir CLI start init
|
|
|
45
45
|
|
|
46
46
|
| Command | Description |
|
|
47
47
|
| ---------------- | --------------------------------------------------------------------------- |
|
|
48
|
-
| `init` |
|
|
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
|
+
| `scaffold` | Generates a runnable starter project for the recorded stack (Phase 2). |
|
|
52
|
+
|
|
53
|
+
### Setup modes
|
|
54
|
+
|
|
55
|
+
`init` starts by asking how much control you want:
|
|
56
|
+
|
|
57
|
+
| Mode | What it asks |
|
|
58
|
+
| ------------- | --------------------------------------------------------------------------------- |
|
|
59
|
+
| **Quickstart**| Pick one predefined stack (see presets below), then just the AI tool. |
|
|
60
|
+
| **Guided** | The classic stack questionnaire (scope → frontend → backend → db → deploy → devops).|
|
|
61
|
+
| **Modular** | Guided **plus** Architecture, Methodology and Development practices, and per-agent selection. |
|
|
62
|
+
|
|
63
|
+
#### Quickstart presets
|
|
64
|
+
|
|
65
|
+
| Preset id | Stack |
|
|
66
|
+
| ------------------- | --------------------------------------- |
|
|
67
|
+
| `nextjs-supabase` | Next.js + Supabase (fullstack, Vercel) |
|
|
68
|
+
| `astro-fastapi` | Astro + FastAPI (fullstack, Postgres) |
|
|
69
|
+
| `fastapi-supabase` | FastAPI + Supabase (backend API) |
|
|
70
|
+
| `sveltekit-postgres`| SvelteKit + Postgres (fullstack, Vercel)|
|
|
71
|
+
| `dotnet-postgres` | .NET API + Postgres (backend) |
|
|
72
|
+
|
|
73
|
+
Presets live in [`src/presets.mjs`](./src/presets.mjs) — add or edit entries there.
|
|
74
|
+
|
|
75
|
+
#### Engineering approach (Modular mode)
|
|
76
|
+
|
|
77
|
+
The Modular mode also captures, records (in the lockfile) and writes into the
|
|
78
|
+
pointer file an **Engineering approach** the AI must follow:
|
|
79
|
+
|
|
80
|
+
- **Architecture** (single): `layered`, `modular-monolith`, `hexagonal`, `clean`,
|
|
81
|
+
`microservices`, `event-driven`, `cqrs`, `serverless`, `mvc` (or none).
|
|
82
|
+
- **Methodology** (single): `scrum`, `kanban`, `scrumban`, `waterfall`, `xp`, `lean` (or none).
|
|
83
|
+
- **Development practices** (multi): `tdd`, `bdd`, `atdd`, `sdd`, `ddd`.
|
|
84
|
+
|
|
85
|
+
The matching docs come from `skills/architecture/`, `skills/methodology/` and
|
|
86
|
+
`skills/practices/` in the SSOT and install under your tool's skills folder.
|
|
87
|
+
|
|
88
|
+
### Scaffolding a starter project (Phase 2)
|
|
89
|
+
|
|
90
|
+
After `init` you can optionally generate a **runnable starter repo** for your
|
|
91
|
+
stack (it also asks at the end of `init`, defaulting to no):
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
kiroku-ai scaffold # reads .kiroku-ai/lockfile.json
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Generators used (official where they exist; our own templates otherwise):
|
|
98
|
+
|
|
99
|
+
| Stack piece | How it's generated | Needs |
|
|
100
|
+
| ----------- | -------------------------------------------------------------- | ------- |
|
|
101
|
+
| Next.js | `npx create-next-app@latest <dir> --yes --skip-install --disable-git` | `npx` |
|
|
102
|
+
| Astro | `npm create astro@latest <dir> -- --template minimal -y --no-install --no-git` | `npm` |
|
|
103
|
+
| SvelteKit | `npx sv create <dir> --template minimal --types ts --no-install` | `npx` |
|
|
104
|
+
| .NET | `dotnet new webapi -o <dir>` | `dotnet`|
|
|
105
|
+
| FastAPI | template `CLI/templates/scaffold/fastapi/` | — |
|
|
106
|
+
| Java | template `CLI/templates/scaffold/java/` | — |
|
|
107
|
+
|
|
108
|
+
For **fullstack** projects you pick the layout (`apps/web`+`apps/api`,
|
|
109
|
+
`frontend`+`backend`, or custom names); single-scope projects scaffold at the
|
|
110
|
+
root. Dependencies are **not** installed automatically — a next-steps note tells
|
|
111
|
+
you how. If a required toolchain (e.g. `dotnet`) is missing, that piece is
|
|
112
|
+
skipped with a clear message and the rest still runs. Existing non-empty target
|
|
113
|
+
folders are never overwritten.
|
|
51
114
|
|
|
52
115
|
### AI environments
|
|
53
116
|
|