From 7bc6ad6144c526000ba80111611db7351c91cf4f Mon Sep 17 00:00:00 2001
From: d-klotz <danielfelipeklotz@gmail.com>
Date: Mon, 15 Dec 2025 15:44:54 -0300
Subject: [PATCH 1/2] fix(devtools): include test/ in npm package files

The devtools/index.js exports the test module, but the test/ directory
was not included in the package.json files array. This caused builds
to fail with:

Error: Cannot find module './test'

Add test/ to the files array to ensure it's published to npm.
---
 packages/devtools/package.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/devtools/package.json b/packages/devtools/package.json
index e7088058..83b9e292 100644
--- a/packages/devtools/package.json
+++ b/packages/devtools/package.json
@@ -10,6 +10,7 @@
     "infrastructure/",
     "migrations/",
     "management-ui/dist/",
+    "test/",
     "index.js",
     "README.md"
   ],

From 6641121014eee4f39ca48c72154c2db2b4fb588b Mon Sep 17 00:00:00 2001
From: d-klotz <danielfelipeklotz@gmail.com>
Date: Mon, 15 Dec 2025 15:45:31 -0300
Subject: [PATCH 2/2] docs: add PR guidelines to CLAUDE.md

Add documentation about creating pull requests for the Frigg Framework:
- Always target the 'next' branch
- Always add 'release' and 'prerelease' labels
- Ensure project compiles before creating PR
---
 CLAUDE.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 778ae5c2..a80ee2bd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -78,6 +78,66 @@ lerna publish                 # Publish all packages
 npm run test:api-module-managers  # Test API module managers with watch mode
 ```
 
+## Pull Request Guidelines
+
+When contributing to the Frigg Framework, follow these guidelines for creating pull requests:
+
+### Target Branch
+
+- **Always create PRs targeting the `next` branch** - Never PR directly to `main`
+- The `next` branch is used for pre-release versions and testing before stable releases
+
+### Required Labels
+
+Always add **both** of these labels to your PR:
+
+- `release` - Triggers a new release version
+- `prerelease` - Creates a pre-release version (e.g., `2.0.0-next.63`)
+
+These labels ensure automated versioning and npm publishing via GitHub Actions.
+
+### Pre-PR Checklist
+
+Before creating a pull request, ensure:
+
+1. **Project compiles successfully**:
+   ```bash
+   npm install
+   npm run test:all
+   ```
+
+2. **No linting errors**:
+   ```bash
+   npm run lint:fix
+   ```
+
+3. **Changes are tested** - Add or update tests for your changes
+
+### PR Workflow Example
+
+```bash
+# 1. Create feature branch from next
+git checkout next
+git pull origin next
+git checkout -b fix/your-fix-description
+
+# 2. Make changes and verify compilation
+npm install
+npm run test:all
+
+# 3. Commit and push
+git add .
+git commit -m "fix(package): description of the fix"
+git push -u origin fix/your-fix-description
+
+# 4. Create PR targeting next branch with required labels
+gh pr create --base next \
+  --title "fix(package): description" \
+  --body "## Summary\n- Your changes\n\n## Test plan\n- [ ] Tests pass" \
+  --label "release" \
+  --label "prerelease"
+```
+
 ## Core Package Architecture (@friggframework/core)
 
 ### Integration Base Class Pattern