@appweaver/create-weaver-app 1.0.24 → 1.0.25

package/create-weaver-app.js

@@ -158,24 +158,34 @@ program
             agentsDir = '.agents';
         }
         const guidelinesFileName = agent === 'claude' ? 'CLAUDE.md' : 'AGENTS.md';
-        // Copy skill and referenced files
+        // Copy skill and referenced files. The framework guidelines
+        // (GUIDELINES.md) are preserved inside the skills directory so that
+        // `weaver update` can keep them in sync without touching the project's
+        // own root guidelines file.
         const skillDir = node_path_1.default.join(__dirname, 'skill');
         const projectSkillPath = node_path_1.default.join(agentsDir, 'skills', 'appweaver');
         const projectSkillDir = node_path_1.default.join(destDir, projectSkillPath);
         await promises_1.default.cp(skillDir, projectSkillDir, {
             recursive: true
         });
-        // Move the project guidelines file to the project root
-        const guidelinesSkillPath = node_path_1.default.join(projectSkillDir, 'GUIDELINES.md');
-        const guidelinesFilePath = node_path_1.default.join(destDir, guidelinesFileName);
-        await promises_1.default.rename(guidelinesSkillPath, guidelinesFilePath);
-        // Update project guidelines reference paths to point in skills directory
-        const guidelinesContents = await promises_1.default.readFile(guidelinesFilePath, 'utf8');
-        const referencesPath = node_path_1.default
-            .join(projectSkillPath, 'references')
+        // Create a thin root guidelines file that references the framework
+        // guidelines from the skills directory. This file is never overwritten
+        // by `weaver update`, so it can be freely extended in the project.
+        const guidelinesPath = node_path_1.default
+            .join(projectSkillPath, 'GUIDELINES.md')
             .replace(/\\/g, '/');
-        const updatedGuidelinesContent = guidelinesContents.replace(/(\[.+]\()references\/(.+\))/g, `$1${referencesPath}/$2`);
-        await promises_1.default.writeFile(guidelinesFilePath, updatedGuidelinesContent, {
+        const guidelinesFilePath = node_path_1.default.join(destDir, guidelinesFileName);
+        const guidelinesReference = agent === 'claude'
+            ? `@${guidelinesPath}`
+            : `[Appweaver framework guidelines](${guidelinesPath})`;
+        const guidelinesContent = `# ${variables.NAME}\n\n` +
+            `${description}\n\n` +
+            `This is an [Appweaver](https://github.com/lmatosevic/appweaver) project. ` +
+            `Follow the framework conventions, architecture, and usage documented in the guidelines:\n\n` +
+            `${guidelinesReference}\n\n` +
+            `<!-- Add your own project-specific instructions below this line. ` +
+            `This file is not modified by \`weaver update\`. -->\n`;
+        await promises_1.default.writeFile(guidelinesFilePath, guidelinesContent, {
             encoding: 'utf8'
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appweaver/create-weaver-app",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "description": "Appweaver - the backend framework for AI-first development (@create-weaver-app)",
   "author": "Luka Matosevic",
   "license": "MIT",

package/skill/GUIDELINES.md

@@ -241,7 +241,7 @@ export async function createAdminUser(): Promise<void> {
     data: {
       firstName: 'Admin',
       lastName: 'Admin',
-      email: 'admin@appweaver.com',
+      email: 'admin@appweaver.co',
       roles: {
         connectOrCreate: [
           {

package/skill/SKILL.md

@@ -472,7 +472,7 @@ export async function createAdminUser(): Promise<void> {
     data: {
       firstName: 'Admin',
       lastName: 'Admin',
-      email: 'admin@appweaver.com',
+      email: 'admin@appweaver.co',
       phone: '01234435',
       roles: {
         connectOrCreate: [
@@ -554,7 +554,6 @@ weaver update                                 # update all @appweaver/* packages
 weaver update @appweaver/core @appweaver/cli  # update specific packages
 weaver update --targetVersion 1.2.3           # update to a specific version
 weaver update --noSkill                       # skip updating AI agent skill files (.claude, .agents, …)
-weaver update --noGuidelines                  # skip updating AI agent guideline files (AGENTS.md, CLAUDE.md)
 weaver update --force                         # force update despite peerDependency mismatches
 ```
 

package/skill/references/cli.md

@@ -205,10 +205,9 @@ Update the Appweaver packages.
 
 **Options:**
 
-| Option                            | Description                                                              | Default    |
-|-----------------------------------|-------------------------------------------------------------------------|------------|
-| `--targetVersion [targetVersion]` | The version to update the packages to                                   | `"latest"` |
+| Option                            | Description                                                                 | Default    |
+|-----------------------------------|-----------------------------------------------------------------------------|------------|
+| `--targetVersion [targetVersion]` | The version to update the packages to                                       | `"latest"` |
 | `--noSkill`                       | Skip updating AI agents skill files in agent dirs (`.claude`, `.agents`, …) | `false`    |
-| `--noGuidelines`                  | Skip updating AI agents guideline files (`AGENTS.md`, `CLAUDE.md`)       | `false`    |
-| `-f, --force`                     | Force update despite peerDependency version mismatches                  | `false`    |
-| `--verbose`                       | Print verbose output                                                    | `false`    |
+| `-f, --force`                     | Force update despite peerDependency version mismatches                      | `false`    |
+| `--verbose`                       | Print verbose output                                                        | `false`    |