sonamu 0.8.27 → 0.9.1

package/src/skills/sonamu/auth.md

@@ -10,6 +10,7 @@ description: Sonamu better-auth authentication system. Automatic entity generati
 ## Automatic Entity Generation
 
 **Source code:**
+
 - CLI: `modules/sonamu/src/bin/cli.ts` (auth_generate function)
 - Generation logic: `modules/sonamu/src/auth/auth-generator.ts`
 - Entity definitions: `modules/sonamu/src/auth/better-auth-entities.ts`
@@ -56,14 +57,15 @@ pnpm sonamu auth generate --plugins admin,2fa,username
 
 The 4 entities generated (`betterAuthV1` array):
 
-| Entity | Table | Key fields |
-|--------|--------|-----------|
-| User | users | id, name, email, email_verified, image |
-| Session | sessions | id, token, expires_at, user_id |
-| Account | accounts | id, provider_id, access_token, user_id |
-| Verification | verifications | id, identifier, value, expires_at |
+| Entity       | Table         | Key fields                             |
+| ------------ | ------------- | -------------------------------------- |
+| User         | users         | id, name, email, email_verified, image |
+| Session      | sessions      | id, token, expires_at, user_id         |
+| Account      | accounts      | id, provider_id, access_token, user_id |
+| Verification | verifications | id, identifier, value, expires_at      |
 
 **How it works:**
+
 - If the entity does not exist, it is created fresh
 - If the entity already exists, only missing fields are added
 - Fields with changed types are updated automatically
@@ -73,12 +75,12 @@ The 4 entities generated (`betterAuthV1` array):
 
 **Source code:** `modules/sonamu/src/auth/better-auth-entities.ts` (BASE_FIELD_MAPPINGS)
 
-| better-auth | Sonamu |
-|-------------|--------|
+| better-auth     | Sonamu           |
+| --------------- | ---------------- |
 | `emailVerified` | `email_verified` |
-| `createdAt` | `created_at` |
-| `userId` | `user_id` |
-| `expiresAt` | `expires_at` |
+| `createdAt`     | `created_at`     |
+| `userId`        | `user_id`        |
+| `expiresAt`     | `expires_at`     |
 
 ## Config Setup
 
@@ -102,12 +104,12 @@ server: {
 
 ## API Endpoints (Auto-registered)
 
-| Path | Method | Description |
-|------|--------|------|
-| `/api/auth/sign-up/email` | POST | Sign up |
-| `/api/auth/sign-in/email` | POST | Sign in |
-| `/api/auth/sign-out` | POST | Sign out |
-| `/api/auth/get-session` | GET | Get session |
+| Path                      | Method | Description |
+| ------------------------- | ------ | ----------- |
+| `/api/auth/sign-up/email` | POST   | Sign up     |
+| `/api/auth/sign-in/email` | POST   | Sign in     |
+| `/api/auth/sign-out`      | POST   | Sign out    |
+| `/api/auth/get-session`   | GET    | Get session |
 
 ## Accessing user/session from Context
 
@@ -119,9 +121,9 @@ import { Sonamu } from "sonamu";
 @api({ httpMethod: "GET", guards: ["user"] })
 async me(): Promise<UserSubsetA | null> {
   const { user, session } = Sonamu.getContext();
-  
+
   if (!user) return null;
-  
+
   // user.id, user.email, user.name, etc. are accessible
   return this.findById("A", user.id);
 }
@@ -134,6 +136,7 @@ async me(): Promise<UserSubsetA | null> {
 ### Built-in Guards
 
 Sonamu provides 3 default guards:
+
 - `query`: allows all users (including unauthenticated)
 - `user`: allows only authenticated users
 - `admin`: allows only users with admin privileges
@@ -202,35 +205,35 @@ import { Sonamu } from "sonamu";
 apiConfig: {
   guardHandler: (guard, request, api) => {
     const { user } = Sonamu.getContext();
-    
+
     switch (guard) {
       case "user":
         if (!user) {
           throw new Error("Login is required");
         }
         break;
-        
+
       case "admin":
         // Requires adding a role field to the User entity
         if (!user || (user as any).role !== "admin") {
           throw new Error("Only admins can access this");
         }
         break;
-      
+
       case "manager":
         // Custom guard: manager permission
         if (!user || !["admin", "manager"].includes((user as any).role)) {
           throw new Error("Manager permission is required");
         }
         break;
-      
+
       case "evaluator":
         // Custom guard: evaluator permission
         if (!user || !["admin", "evaluator"].includes((user as any).role)) {
           throw new Error("Evaluator permission is required");
         }
         break;
-        
+
       case "query":
         // Allow all users
         break;
@@ -278,6 +281,7 @@ Adding an enum:
 ## Checklist
 
 After setup, verify:
+
 - [ ] **[Before generate] Confirm with user whether plugins are needed**
   - If "later" → remember `plugins_deferred: true`, guide on optimal timing
 - [ ] Run `pnpm sonamu auth generate [--plugins ...]`
@@ -291,9 +295,11 @@ After setup, verify:
 ## Reference
 
 **Skills documentation:**
+
 - Detailed configuration: "server.auth details" section in `config.md`
 - Context API: "Context access" section in `api.md`
 
 **Official documentation:**
+
 - Korean: `modules/docs/ko/api-development/authentication/setup.mdx`
 - English: `modules/docs/en/api-development/authentication/setup.mdx`

package/src/skills/sonamu/cdd.md

@@ -118,8 +118,9 @@ pnpm cdd <command>
 | `cdd ac add <file> <test-name>` | Add an empty test skeleton to a test file. Use `--describe <group>` to specify a describe block |
 | `cdd ac list [file]` | Print the describe/test tree of a test file. Parses `test()`, `it()`, and `testAs()` patterns |
 | `cdd rules validate` | Validate the format of `contract/rules/*.rules.json` |
-| `cdd agents init [--force]` | Initialize CDD agent setup in the project (creates `.agents/`, `AGENTS.md`, and symlinks) |
+| `cdd agents init [--force]` | Initialize CDD agent setup + contract scaffold (creates `.agents/`, `AGENTS.md`, `contract/planning.md`, `contract/rules/web.rules.json`, `contract/rules/api.rules.json`) |
 | `cdd agents sync [--dry-run]` | Update CDD agent prompts to the latest version |
+| `cdd contract init [--force]` | Scaffold contract directory only (`planning.md`, `rules/web.rules.json`, `rules/api.rules.json`). Alias: `cdd agents contract init` |
 
 ### Common options
 

package/src/skills/sonamu/cone.md

@@ -12,11 +12,11 @@ During fixture generation, the LLM references `cone.note` to produce realistic,
 
 ## Role of Cone
 
-| Purpose | Description |
-|---------|-------------|
+| Purpose                | Description                                                           |
+| ---------------------- | --------------------------------------------------------------------- |
 | **Fixture generation** | LLM generates contextually appropriate test data based on `cone.note` |
-| **Scaffolding** | Uses cone information to generate model and view templates |
-| **Documentation** | Metadata describing Entity structure and the meaning of each field |
+| **Scaffolding**        | Uses cone information to generate model and view templates            |
+| **Documentation**      | Metadata describing Entity structure and the meaning of each field    |
 
 ---
 
@@ -24,32 +24,32 @@ During fixture generation, the LLM references `cone.note` to produce realistic,
 
 ### Entity cone
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `note` | string | Entity purpose, business context, and fixture generation guide |
-| `tags` | string[] | Classification tags |
+| Field  | Type     | Description                                                    |
+| ------ | -------- | -------------------------------------------------------------- |
+| `note` | string   | Entity purpose, business context, and fixture generation guide |
+| `tags` | string[] | Classification tags                                            |
 
 ### Prop cone
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `note` | string | **Highest priority.** Business meaning of the field, concrete examples, value ranges, format constraints. Input the LLM reads to generate data |
-| `fixtureGenerator` | string | **Fallback.** faker.js expression. Fallback when no API key is available |
-| `fixtureDefault` | any | Fixed default value |
-| `fixtureStrategy` | string | `"sequence"` — used when id is auto-assigned by a DB sequence |
-| `dataSource` | object | Strategy for fetching reference data for relation props |
+| Field              | Type   | Description                                                                                                                                    |
+| ------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `note`             | string | **Highest priority.** Business meaning of the field, concrete examples, value ranges, format constraints. Input the LLM reads to generate data |
+| `fixtureGenerator` | string | **Fallback.** faker.js expression. Fallback when no API key is available                                                                       |
+| `fixtureDefault`   | any    | Fixed default value                                                                                                                            |
+| `fixtureStrategy`  | string | `"sequence"` — used when id is auto-assigned by a DB sequence                                                                                  |
+| `dataSource`       | object | Strategy for fetching reference data for relation props                                                                                        |
 
 ### Subset cone
 
-| Field | Type | Description |
-|-------|------|-------------|
+| Field  | Type   | Description                                          |
+| ------ | ------ | ---------------------------------------------------- |
 | `note` | string | Subset purpose, included fields, and when it is used |
 
 ### Enum cone
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `note` | string | Meaning and usage context of the enum |
+| Field    | Type   | Description                            |
+| -------- | ------ | -------------------------------------- |
+| `note`   | string | Meaning and usage context of the enum  |
 | `values` | object | `{ note: string }` for each enum value |
 
 ---
@@ -97,10 +97,10 @@ pnpm sonamu cone gen Post --locale en
 
 #### Options
 
-| Option | Description |
-|--------|-------------|
-| `--all` | Generate cone for all Entities |
-| `--regenerate` | Overwrite existing cone (default: only generate for fields with no note) |
+| Option                  | Description                                                                          |
+| ----------------------- | ------------------------------------------------------------------------------------ |
+| `--all`                 | Generate cone for all Entities                                                       |
+| `--regenerate`          | Overwrite existing cone (default: only generate for fields with no note)             |
 | `--locale <ko\|en\|ja>` | Generation language (default: `i18n.defaultLocale` from `sonamu.config.ts`, or `ko`) |
 
 #### How it works
@@ -129,12 +129,12 @@ pnpm sonamu stub entity Post --no-cones
 
 #### Template cone vs LLM cone
 
-| Item | Template cone | LLM cone |
-|------|--------------|----------|
-| API key | Not required | Required |
+| Item    | Template cone                    | LLM cone                 |
+| ------- | -------------------------------- | ------------------------ |
+| API key | Not required                     | Required                 |
 | Quality | Defaults based on faker-mappings | Reflects project context |
-| Speed | Immediate | Takes a few seconds |
-| Upgrade | Can be upgraded with `cone gen` | — |
+| Speed   | Immediate                        | Takes a few seconds      |
+| Upgrade | Can be upgraded with `cone gen`  | —                        |
 
 ---
 
@@ -233,14 +233,14 @@ Using `fixtureStrategy: "sequence"` causes a `MAX(id::bigint)` error during fixt
 
 Specifies how reference data is fetched for relation props.
 
-| Strategy | Description |
-|----------|-------------|
+| Strategy | Description                      |
+| -------- | -------------------------------- |
 | `recent` | Most recent data (by created_at) |
-| `sample` | Uniform sampling |
-| `random` | Random sampling |
-| `ids` | Specific IDs |
-| `query` | Custom query |
-| `file` | Load from file |
+| `sample` | Uniform sampling                 |
+| `random` | Random sampling                  |
+| `ids`    | Specific IDs                     |
+| `query`  | Custom query                     |
+| `file`   | Load from file                   |
 
 ```json
 "dataSource": {
@@ -253,16 +253,16 @@ Specifies how reference data is fetched for relation props.
 
 **Source:** `modules/sonamu/src/testing/data-explorer.ts`
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `strategy` | string | — | Fetch strategy (see table above) |
-| `limit` | number | — | Maximum number of records to fetch |
-| `where` | object \| function | — | WHERE condition (object or Knex QueryBuilder function) |
-| `orderBy` | string | — | Sort criteria |
-| `ids` | number[] | — | Specific ID list for `ids` strategy |
-| `filePath` | string | — | File path for `file` strategy |
-| `useCache` | boolean | `false` | Whether to use caching |
-| `cacheTtl` | number | `300` | Cache TTL (in seconds) |
+| Option     | Type               | Default | Description                                            |
+| ---------- | ------------------ | ------- | ------------------------------------------------------ |
+| `strategy` | string             | —       | Fetch strategy (see table above)                       |
+| `limit`    | number             | —       | Maximum number of records to fetch                     |
+| `where`    | object \| function | —       | WHERE condition (object or Knex QueryBuilder function) |
+| `orderBy`  | string             | —       | Sort criteria                                          |
+| `ids`      | number[]           | —       | Specific ID list for `ids` strategy                    |
+| `filePath` | string             | —       | File path for `file` strategy                          |
+| `useCache` | boolean            | `false` | Whether to use caching                                 |
+| `cacheTtl` | number             | `300`   | Cache TTL (in seconds)                                 |
 
 **Example using a where condition:**
 
@@ -280,10 +280,10 @@ Specifies how reference data is fetched for relation props.
 
 Used in `fixture gen` to fetch related data alongside the target data.
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `includeRelations` | boolean | `true` | Whether to include related data |
-| `maxDepth` | number | `2` | Maximum depth for recursive traversal |
+| Option             | Type    | Default | Description                           |
+| ------------------ | ------- | ------- | ------------------------------------- |
+| `includeRelations` | boolean | `true`  | Whether to include related data       |
+| `maxDepth`         | number  | `2`     | Maximum depth for recursive traversal |
 
 ---
 

package/src/skills/sonamu/config.md

@@ -44,21 +44,21 @@ SLACK_CHANNEL_ID=C0123456789
 
 ### Environment Variable Reference
 
-| Variable | Required | Description |
-|-----|-----|------|
-| `DB_HOST` | ✓ | DB host (Docker: `0.0.0.0`, external DB: the relevant IP) |
-| `DB_PORT` | ✓ | DB port (default: `5432`) |
-| `DB_USER` | ✓ | DB username (default: `postgres`) |
-| `DB_PASSWORD` | ✓ | DB password |
-| `DATABASE_NAME` | ✓ | Database name |
-| `PROJECT_NAME` | ✓ | Project name (used in Docker, config) |
-| `CONTAINER_NAME` | | Docker container name |
-| `SESSION_SECRET` | | Session encryption key (required in production) |
-| `SESSION_SALT` | | Session salt (16 characters) |
-| `AWS_ACCESS_KEY_ID` | | Required when using S3 |
-| `AWS_SECRET_ACCESS_KEY` | | Required when using S3 |
-| `S3_REGION` | | S3 region (default: `ap-northeast-2`) |
-| `S3_BUCKET` | | S3 bucket name |
+| Variable                | Required | Description                                               |
+| ----------------------- | -------- | --------------------------------------------------------- |
+| `DB_HOST`               | ✓        | DB host (Docker: `0.0.0.0`, external DB: the relevant IP) |
+| `DB_PORT`               | ✓        | DB port (default: `5432`)                                 |
+| `DB_USER`               | ✓        | DB username (default: `postgres`)                         |
+| `DB_PASSWORD`           | ✓        | DB password                                               |
+| `DATABASE_NAME`         | ✓        | Database name                                             |
+| `PROJECT_NAME`          | ✓        | Project name (used in Docker, config)                     |
+| `CONTAINER_NAME`        |          | Docker container name                                     |
+| `SESSION_SECRET`        |          | Session encryption key (required in production)           |
+| `SESSION_SALT`          |          | Session salt (16 characters)                              |
+| `AWS_ACCESS_KEY_ID`     |          | Required when using S3                                    |
+| `AWS_SECRET_ACCESS_KEY` |          | Required when using S3                                    |
+| `S3_REGION`             |          | S3 region (default: `ap-northeast-2`)                     |
+| `S3_BUCKET`             |          | S3 bucket name                                            |
 
 ---
 
@@ -79,14 +79,30 @@ const port = 34900;
 
 export default defineConfig({
   projectName: process.env.PROJECT_NAME ?? "MyProject",
-  api: { /* API settings */ },
-  i18n: { /* i18n settings */ },
-  sync: { /* sync settings */ },
-  database: { /* DB settings */ },
-  logging: { /* logging settings (disable with false) */ },
-  test: { /* test settings */ },
-  server: { /* server settings */ },
-  slackConfirm: { /* Production migration Slack approval */ },
+  api: {
+    /* API settings */
+  },
+  i18n: {
+    /* i18n settings */
+  },
+  sync: {
+    /* sync settings */
+  },
+  database: {
+    /* DB settings */
+  },
+  logging: {
+    /* logging settings (disable with false) */
+  },
+  test: {
+    /* test settings */
+  },
+  server: {
+    /* server settings */
+  },
+  slackConfirm: {
+    /* Production migration Slack approval */
+  },
 });
 ```
 
@@ -190,6 +206,7 @@ pnpm sonamu auth generate
 ```
 
 Generated entities:
+
 - **User** - user (id, name, email, email_verified, image)
 - **Session** - session (token, expires_at, user_id)
 - **Account** - account (provider_id, access_token, etc.)
@@ -221,12 +238,12 @@ server: {
 
 Automatically registered under the `/api/auth/*` path:
 
-| Endpoint | Method | Description |
-|------------|--------|------|
-| `/api/auth/sign-up/email` | POST | Sign up |
-| `/api/auth/sign-in/email` | POST | Sign in |
-| `/api/auth/sign-out` | POST | Sign out |
-| `/api/auth/get-session` | GET | Get session |
+| Endpoint                  | Method | Description |
+| ------------------------- | ------ | ----------- |
+| `/api/auth/sign-up/email` | POST   | Sign up     |
+| `/api/auth/sign-in/email` | POST   | Sign in     |
+| `/api/auth/sign-out`      | POST   | Sign out    |
+| `/api/auth/get-session`   | GET    | Get session |
 
 ### 4. Accessing user/session from Context
 
@@ -243,12 +260,12 @@ async me(): Promise<UserSubsetA | null> {
 
 better-auth uses camelCase, Sonamu uses snake_case. Automatic mapping is applied:
 
-| better-auth | Sonamu |
-|-------------|--------|
+| better-auth     | Sonamu           |
+| --------------- | ---------------- |
 | `emailVerified` | `email_verified` |
-| `createdAt` | `created_at` |
-| `userId` | `user_id` |
-| `expiresAt` | `expires_at` |
+| `createdAt`     | `created_at`     |
+| `userId`        | `user_id`        |
+| `expiresAt`     | `expires_at`     |
 
 ---
 
@@ -277,8 +294,8 @@ declare module "sonamu" {
     query: true;
     admin: true;
     user: true;
-    manager: true;      // added
-    superadmin: true;   // added
+    manager: true; // added
+    superadmin: true; // added
   }
 }
 ```
@@ -370,9 +387,11 @@ export function canAccess(userRole: string, menu: keyof typeof menuPermissions)
 
 ```tsx
 // web/src/components/Sidebar.tsx
-{canAccess(user.role, "userManagement") && (
-  <MenuItem href="/admin/users">User Management</MenuItem>
-)}
+{
+  canAccess(user.role, "userManagement") && (
+    <MenuItem href="/admin/users">User Management</MenuItem>
+  );
+}
 ```
 
 ---
@@ -394,6 +413,7 @@ session: {
 ```
 
 **Production checklist:**
+
 - `SESSION_SECRET`: must be changed to a strong random string
 - `SESSION_SALT`: change to a 16-character random string
 - `cookie.domain`: change to the actual domain
@@ -480,6 +500,7 @@ cache: {
 ```
 
 **Available drivers:**
+
 - `memory` - in-memory cache (default)
 - `file` - file-based cache
 - `redis` - Redis cache
@@ -576,6 +597,7 @@ lifecycle: {
 ## Sonamu Local Development Environment Setup
 
 **When is this needed:**
+
 - When modifying the Sonamu framework source code during development
 - When linking a local Sonamu repository to a project for development
 
@@ -610,7 +632,7 @@ overrides:
 ```json
 {
   "dependencies": {
-    "sonamu": "^0.7.45"  // specify the latest published version
+    "sonamu": "^0.7.45" // specify the latest published version
   }
 }
 ```
@@ -694,17 +716,17 @@ Pass Fastify server options directly (excluding `logger`).
 
 ### Full Plugin List
 
-| Plugin | Type | Description |
-|----------|------|------|
-| `compress` | `boolean \| FastifyCompressOptions` | Response compression (@fastify/compress) |
-| `cors` | `boolean \| FastifyCorsOptions` | CORS configuration |
-| `formbody` | `boolean \| FastifyFormbodyOptions` | x-www-form-urlencoded parsing |
-| `multipart` | `boolean \| FastifyMultipartOptions` | File upload |
-| `qs` | `boolean \| QsPluginOptions` | Query string parsing |
-| `session` | session config | Session management |
-| `sse` | `boolean \| SsePluginOptions` | Server-Sent Events |
-| `static` | `boolean \| FastifyStaticOptions` | Static file serving |
-| `custom` | `(server: FastifyInstance) => void` | Custom plugin registration function |
+| Plugin      | Type                                 | Description                              |
+| ----------- | ------------------------------------ | ---------------------------------------- |
+| `compress`  | `boolean \| FastifyCompressOptions`  | Response compression (@fastify/compress) |
+| `cors`      | `boolean \| FastifyCorsOptions`      | CORS configuration                       |
+| `formbody`  | `boolean \| FastifyFormbodyOptions`  | x-www-form-urlencoded parsing            |
+| `multipart` | `boolean \| FastifyMultipartOptions` | File upload                              |
+| `qs`        | `boolean \| QsPluginOptions`         | Query string parsing                     |
+| `session`   | session config                       | Session management                       |
+| `sse`       | `boolean \| SsePluginOptions`        | Server-Sent Events                       |
+| `static`    | `boolean \| FastifyStaticOptions`    | Static file serving                      |
+| `custom`    | `(server: FastifyInstance) => void`  | Custom plugin registration function      |
 
 ## logging
 
@@ -742,6 +764,7 @@ slackConfirm: {
 5. Access Sonamu UI: http://localhost:34900/sonamu-ui
 
 Before production deployment:
+
 - [ ] Change `SESSION_SECRET`
 - [ ] Change `SESSION_SALT`
 - [ ] Change `cookie.domain` to the actual domain

package/src/skills/sonamu/create-sonamu.md

@@ -23,23 +23,23 @@ pnpm create sonamu [project-name] --yes
 
 ### General Options
 
-| Option | Description | Default |
-|------|------|--------|
-| `--yes`, `-y` | Use all options with default values | - |
-| `--skip-pnpm` | Skip pnpm install | false |
-| `--skip-docker` | Skip Docker setup | false |
-| `--pnpm y/n` | Whether to install pnpm | y |
-| `--docker y/n` | Whether to configure Docker | y |
+| Option          | Description                         | Default |
+| --------------- | ----------------------------------- | ------- |
+| `--yes`, `-y`   | Use all options with default values | -       |
+| `--skip-pnpm`   | Skip pnpm install                   | false   |
+| `--skip-docker` | Skip Docker setup                   | false   |
+| `--pnpm y/n`    | Whether to install pnpm             | y       |
+| `--docker y/n`  | Whether to configure Docker         | y       |
 
 ### Docker/DB Options
 
-| Option | Description | Default |
-|------|------|--------|
-| `--docker-project` | Docker project name | `[project-name]-docker` |
-| `--container-name` | Container name | `[project-name]-container` |
-| `--db-name` | Database name | `[project-name]` |
-| `--db-user` | DB user | `postgres` |
-| `--db-password` | DB password | `1234` |
+| Option             | Description         | Default                    |
+| ------------------ | ------------------- | -------------------------- |
+| `--docker-project` | Docker project name | `[project-name]-docker`    |
+| `--container-name` | Container name      | `[project-name]-container` |
+| `--db-name`        | Database name       | `[project-name]`           |
+| `--db-user`        | DB user             | `postgres`                 |
+| `--db-password`    | DB password         | `1234`                     |
 
 ## Usage Examples
 
@@ -97,20 +97,25 @@ pnpm create sonamu my_project \
 ## Next Steps After Creation
 
 1. Start the DB container (if Docker was configured)
+
    ```bash
    cd [project-name]/packages/api/
    pnpm docker:up
    ```
+
    > If a port conflict error occurs → see `database.md`
 
 2. Sync Skills
+
    ```bash
    cd [project-name]/packages/api
    pnpm sonamu skills sync
    ```
+
    > Will fail if sonamu is an npm version. See "Sonamu Link Setup" below.
 
 3. Start the dev server
+
    ```bash
    cd [project-name]/packages/api
    pnpm dev
@@ -137,6 +142,7 @@ Check the sonamu dependency in `packages/api/package.json`:
 ### How to change to a link
 
 1. Change the sonamu version to a link in `packages/api/package.json`:
+
    ```json
    "dependencies": {
      "sonamu": "link:/path/to/sonamu/modules/sonamu"
@@ -149,10 +155,10 @@ Check the sonamu dependency in `packages/api/package.json`:
 
 ### Link path examples
 
-| sonamu location | Link path |
-|------------|----------|
-| `~/Development/sonamu` | `link:~/Development/sonamu/modules/sonamu` |
-| Same directory as project | `link:../../sonamu/modules/sonamu` |
+| sonamu location           | Link path                                  |
+| ------------------------- | ------------------------------------------ |
+| `~/Development/sonamu`    | `link:~/Development/sonamu/modules/sonamu` |
+| Same directory as project | `link:../../sonamu/modules/sonamu`         |
 
 ## Renaming the Project (when creating a new project)
 
@@ -161,28 +167,34 @@ After generating the project, you need to replace the "Sonamu" text in the front
 **4 files to update:**
 
 1. **`packages/web/index.html`** - Browser tab title
+
 ```html
 <title>{project-name}</title>
 ```
 
 2. **`packages/web/src/routes/__root.tsx`** - TanStack Router head configuration (most important!)
+
 ```typescript
 head: () => ({
   meta: [{ title: "{project-name}" }],
 }),
 ```
+
 **Important:** If you don't update `__root.tsx`, the title will revert to "Sonamu" on HMR!
 
 3. **`packages/web/src/routes/index.tsx`** - Main page title
+
 ```tsx
-<h1 className="text-2xl font-bold mb-4">Welcome to {project-name}</h1>
+<h1 className="text-2xl font-bold mb-4">Welcome to {project - name}</h1>
 ```
 
 4. **`packages/web/src/components/Sidebar.tsx`** - Sidebar app name
+
 ```typescript
 const title = isAdmin ? "Admin" : "{project-name}";
 ```
 
 **How to verify:**
+
 - Check that the project name is shown in the browser tab
 - Confirm that the tab title does not change on file save via HMR (if it does, `__root.tsx` is missing)