@simplysm/claude 13.0.0-beta.49 → 13.0.0-beta.51

package/README.md

@@ -34,7 +34,7 @@ Updates also trigger reinstallation (`pnpm up @simplysm/claude`).
   claude/
     sd-statusline.js          # Status line script
     rules/
-      sd-context7.md          # Context7 MCP rule
+      sd-simplysm-docs.md     # Local README documentation rule
     agents/
       sd-code-reviewer.md     # Code review agent
       sd-code-simplifier.md   # Code simplification agent
@@ -303,12 +303,13 @@ Reviews a library's public API for developer experience (DX) quality. Uses confi
 
 ## Rules
 
-### sd-context7
+### sd-simplysm-docs
 
-Configures Context7 MCP for looking up `@simplysm/*` package documentation. The library ID is pre-configured as `/kslhunter/simplysm`.
+Instructs Claude to read `@simplysm/*` package documentation from local `node_modules/` README.md files. Includes an embedded package list so Claude can immediately identify which package to look up.
 
 ```
-query-docs(libraryId="/kslhunter/simplysm", query="<your question>")
+# Claude automatically reads when needing @simplysm/* docs:
+node_modules/@simplysm/{package-name}/README.md
 ```
 
 ## Status Line

package/claude/rules/sd-language.md

@@ -0,0 +1,7 @@
+# Language
+
+Respond in the **system's configured language** (set via Claude Code's language setting).
+
+- Technical terms, code identifiers (variable names, function names, etc.), and library names should remain as-is
+- Show English error messages and logs in their original form, but provide explanations in the system language
+- Files in `.claude/` folder and each package's `README.md` are written in English for consistent documentation

package/claude/rules/sd-naming-conventions.md

@@ -0,0 +1,13 @@
+# Function Naming Conventions
+
+- Do not use `Async` suffix on function names — Async is the default
+- When both sync and async versions exist, use `Sync` suffix on the sync function
+
+```typescript
+// Good
+async function readFile() { ... }      // Async (default)
+function readFileSync() { ... }        // Sync version
+
+// Bad
+async function readFileAsync() { ... } // Async suffix prohibited
+```

package/claude/rules/sd-simplysm-docs.md

@@ -0,0 +1,52 @@
+# @simplysm Package Documentation
+
+When you need API details, usage examples, or component props for `@simplysm/*` packages,
+read the package's README.md from node_modules.
+
+## How to use
+
+Read the package README directly:
+
+```
+node_modules/@simplysm/{package-name}/README.md
+```
+
+If not found (pnpm hoisting), try:
+
+```
+packages/*/node_modules/@simplysm/{package-name}/README.md
+```
+
+## When to use
+
+**MANDATORY**: Read the relevant README BEFORE any of the following:
+
+- Writing new code that uses `@simplysm/*` APIs
+- Fixing type errors or bugs in code that uses `@simplysm/*` APIs
+- Making assumptions about type mappings (e.g., DB column types → TypeScript types)
+- Refactoring or migrating code that depends on `@simplysm/*` packages
+
+Do NOT guess API behavior or type mappings — always verify from the README first.
+
+## Available Packages
+
+| Package | Description |
+|---------|-------------|
+| `core-common` | Common utilities, custom types (DateTime, DateOnly, Time, Uuid) |
+| `core-browser` | Browser-specific extensions |
+| `core-node` | Node.js utilities (filesystem, workers) |
+| `orm-common` | ORM query builder, table schema definitions |
+| `orm-node` | DB connectors (MySQL, MSSQL, PostgreSQL) |
+| `service-common` | Service protocol, type definitions |
+| `service-client` | WebSocket client |
+| `service-server` | Fastify-based HTTP/WebSocket server |
+| `solid` | SolidJS UI components + Tailwind CSS |
+| `excel` | Excel (.xlsx) read/write |
+| `storage` | FTP/SFTP client |
+| `sd-cli` | Build, lint, typecheck CLI tool |
+| `claude` | Claude Code skills/agents (auto-installs via postinstall) |
+| `eslint-plugin` | Custom ESLint rules |
+| `capacitor-plugin-auto-update` | Auto update |
+| `capacitor-plugin-broadcast` | Broadcast |
+| `capacitor-plugin-file-system` | File system |
+| `capacitor-plugin-usb-storage` | USB storage |

package/claude/rules/sd-workflow-rules.md

@@ -0,0 +1,3 @@
+# Workflow Rules
+
+- **No auto-proceeding after skill completion**: When the user explicitly invokes a skill, report the result and **stop** once the skill finishes. Do not guess the next step and proceed arbitrarily. Wait for explicit user instructions if further work is needed.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysm/claude",
   "sideEffects": false,
-  "version": "13.0.0-beta.49",
+  "version": "13.0.0-beta.51",
   "description": "Simplysm Claude Code skills/agents — auto-installs via postinstall",
   "author": "김석래",
   "repository": {

package/claude/rules/sd-context7.md

@@ -1,28 +0,0 @@
-# Simplysm Documentation via Context7 MCP
-
-When you need to look up usage examples or API details for `@simplysm/*` packages, use the Context7 MCP tools.
-
-The simplysm library is registered as `/kslhunter/simplysm` on Context7.
-
-**IMPORTANT**: Context7 documentation is only available for **v13+ (beta onwards)**. v12 and earlier versions have NO documentation on Context7. If working with v12 code, do NOT rely on Context7 — read the source code directly instead.
-
-## How to use
-
-Skip `resolve-library-id` (the ID is already known) and call `query-docs` directly:
-
-```
-query-docs(libraryId="/kslhunter/simplysm", query="<your question>")
-```
-
-## Example queries
-
-- `query-docs(libraryId="/kslhunter/simplysm", query="How to define ORM table with columns and primary key")`
-- `query-docs(libraryId="/kslhunter/simplysm", query="SolidJS Select component usage")`
-- `query-docs(libraryId="/kslhunter/simplysm", query="ServiceClient WebSocket RPC call")`
-- `query-docs(libraryId="/kslhunter/simplysm", query="DateTime custom type usage")`
-
-## When to use
-
-- Before writing code that uses an unfamiliar `@simplysm/*` API
-- When unsure about component props, method signatures, or configuration options
-- When looking for usage patterns or code examples within the framework