@ryuenn3123/agentic-senior-core 2.0.10 → 2.0.12

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.0.10
+Generated by Agentic-Senior-Core CLI v2.0.12
 Timestamp: 2026-04-08T14:58:53.570Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.0.10
+Generated by Agentic-Senior-Core CLI v2.0.12
 Timestamp: 2026-04-08T14:58:53.570Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/README.md

@@ -42,20 +42,39 @@ AI:  *Creates properly layered modules with Zod validation, typed errors,
 
 The npm package is already published. For most users, this is the default path.
 
+**Step 1: Navigate to your project folder**
+```bash
+cd /path/to/your-project
+```
+
+**Step 2: Run initialization (does not require install)**
+
+Use `npx` or `npm exec` — both download the package temporarily, run it in your project folder, then clean up automatically.
+
 ```bash
-npm exec --yes @ryuenn3123/agentic-senior-core launch
-npm exec --yes @ryuenn3123/agentic-senior-core init
 npx @ryuenn3123/agentic-senior-core init
+# or
+npm exec --yes @ryuenn3123/agentic-senior-core init
 ```
 
-If you prefer a global install:
+**Alternative: Global install (optional)**
+
+If you want the tool available system-wide without repeating `npx`:
 
 ```bash
 npm install -g @ryuenn3123/agentic-senior-core
+# Then from any project folder:
 agentic-senior-core init
 ```
 
-Use team defaults with profile packs:
+| Approach | Installation | Where to Run | Use Case |
+|----------|--------------|---|---|
+| **npx (default)** | None — temporary download | Inside your project folder | Clearest workflow; no system pollution |
+| **Global install** | System-wide | From anywhere | Convenience if using frequently across many projects |
+
+> Note: Both approaches do the same thing: create `.cursorrules`, `.instructions.md`, `.agent-context/` **in your current project folder**. The only difference is convenience. Use `npx` if unsure — it's clearer and doesn't clutter your system.
+
+**Use team defaults with profile packs:**
 
 ```bash
 npx @ryuenn3123/agentic-senior-core init --profile-pack startup
@@ -118,10 +137,22 @@ npx @ryuenn3123/agentic-senior-core init --newbie
 
 ### Important behavior
 
+- `init` creates governance files **in your project folder** (the folder where you run the command).
 - `init` does not copy repository workflows from this project into your target repository.
 - MCP server registration and trust/start are manual in IDE settings.
 - MCP workspace scaffold is opt-in via `--mcp-template` and creates `.vscode/mcp.json`.
 
+**What files are created?**
+```
+your-project/
+├── .cursorrules          (agent instructions for Cursor)
+├── .windsurfrules        (agent instructions for Windsurf)
+├── .instructions.md      (canonical governance and AI behavior policy)
+├── .agent-context/       (blueprints, skills, rules, profiles, state maps)
+└── .vscode/
+    └── mcp.json          (only if --mcp-template is used)
+```
+
 ### MCP Setup in VS Code (No File Picker)
 
 If you are looking for a file picker in the MCP UI, that is expected because VS Code uses MCP server registration, not generic JSON file import.
@@ -134,10 +165,10 @@ npx @ryuenn3123/agentic-senior-core init --mcp-template
 
 2. Open Command Palette and run `MCP: Open Workspace Folder Configuration`.
 3. Confirm the file is `.vscode/mcp.json` with server `agentic-senior-core`.
-4. The generated server command is `npx -y @ryuenn3123/agentic-senior-core mcp`.
+4. The generated server command is `node ./scripts/mcp-server.mjs` with `cwd` set to `${workspaceFolder}`.
 5. Open Chat Customizations > MCP Servers, then trust/start the server.
 
-If logs repeatedly show `Waiting for server to respond to initialize request`, upgrade to the latest package version and regenerate the workspace config with `--mcp-template`.
+If logs repeatedly show `Waiting for server to respond to initialize request`, upgrade to the latest package version, regenerate the workspace config with `--mcp-template`, and restart the MCP server.
 
 ### CLI Command Reference
 
@@ -374,7 +405,7 @@ Release checklist:
 2. Add matching release notes in `CHANGELOG.md`.
 3. Push to `main`.
 
-Important notes:
+Important notes for maintainers and forks:
 - If the npm version already exists, publish will fail.
 - Publish requires valid `NPM_TOKEN` in repository secrets.
 

package/lib/cli/utils.mjs

@@ -138,8 +138,9 @@ export async function copyGovernanceAssetsToTarget(
       servers: {
         'agentic-senior-core': {
           type: 'stdio',
-          command: 'npx',
-          args: ['-y', '@ryuenn3123/agentic-senior-core', 'mcp'],
+          command: 'node',
+          cwd: '${workspaceFolder}',
+          args: ['./scripts/mcp-server.mjs'],
         },
       },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "2.0.10",
+  "version": "2.0.12",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {

package/scripts/validate.mjs

@@ -730,6 +730,12 @@ async function validateMcpConfiguration() {
     fail('Workspace MCP server command must use Node');
   }
 
+  if (workspaceServerConfig?.cwd === '${workspaceFolder}') {
+    pass('Workspace MCP server cwd uses ${workspaceFolder}');
+  } else {
+    fail('Workspace MCP server cwd must be ${workspaceFolder}');
+  }
+
   if (Array.isArray(workspaceServerConfig?.args) && workspaceServerConfig.args.includes('./scripts/mcp-server.mjs')) {
     pass('Workspace MCP server points to scripts/mcp-server.mjs');
   } else {