@yeongjaeyou/claude-code-config 0.21.1 → 0.21.2

package/.claude/guidelines/work-guidelines.md

@@ -176,7 +176,7 @@ When Built-in LSP returns "No LSP server available" error:
 - **MUST** execute code after writing, not just write and report
 - For Python scripts: run with appropriate interpreter
 - For tests: run pytest or equivalent
-- For notebooks: execute cells via `mcp__ide__executeCode`
+- For notebooks: add/edit cells with NotebookEdit, user executes in Jupyter
 
 #### Error-Free Loop
 1. Write code
@@ -223,12 +223,9 @@ If pip install errors occur, try in order:
 3. `pip install --no-cache-dir -r requirements.txt` (install packages one by one)
 
 ### Jupyter Notebook Editing
-- **ALWAYS** use the `edit_notebook` tool exclusively for editing .ipynb files
-- **NEVER** use `search_replace`, `write`, or any other text editing tools on .ipynb files
-- After modifying .ipynb files, verify:
-  - JSON syntax validity
-  - Original cell execution order/outputs preserved (unless explicitly instructed to clear)
-  - Changes are correct, no missing functions/imports/dependencies
+- Use `edit-notebook` skill for .ipynb editing guidelines
+- NotebookEdit tool only, no text editing tools
+- After modification: verify cell order and outputs preserved
 
 ### Output Standards
 - **Minimal Output**: Avoid unnecessary print statements in code - only include meaningful debug output when explicitly requested

package/.claude/skills/edit-notebook/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/.claude/skills/edit-notebook/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: edit-notebook
+description: Safely edit Jupyter Notebook (.ipynb) files. Use when (1) adding/modifying/deleting cells in .ipynb files, (2) working with notebook structure, (3) any .ipynb file modification. Triggered by notebook editing requests.
+---
+
+# Notebook Editing
+
+Edit Jupyter Notebook files using NotebookEdit tool only.
+
+## Rules
+
+### Tool Selection
+- .ipynb = NotebookEdit only
+- Edit, Write, search_replace 사용 금지
+
+### Cell Insertion: cell_id Tracking (Required)
+
+NotebookEdit returns inserted cell's id. Track it for sequential insertion:
+
+```
+NotebookEdit(edit_mode="insert", cell_type="code", new_source="...")
+-> Returns cell_id='abc123'
+
+NotebookEdit(edit_mode="insert", cell_id="abc123", cell_type="code", new_source="...")
+-> Returns cell_id='def456'
+
+NotebookEdit(edit_mode="insert", cell_id="def456", ...)
+```
+
+**cell_id omitted**: Cell inserted at BEGINNING -> reverse order bug
+
+### Execution Policy
+- NotebookEdit = edit only, no execution
+- After adding cells: "Please run the cells in Jupyter"
+- Do NOT use mcp__ide__executeCode (causes notebook state corruption)
+
+### Post-Edit Verification
+- Read first 30 lines to verify cell order
+- Confirm existing outputs preserved
+
+## edit_mode Options
+
+| Mode | Purpose | cell_id |
+|------|---------|---------|
+| replace | Update existing cell | Required |
+| insert | Add new cell | Recommended (omit = top insertion) |
+| delete | Remove cell | Required |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeongjaeyou/claude-code-config",
-  "version": "0.21.1",
+  "version": "0.21.2",
   "description": "Claude Code CLI custom commands, agents, and skills",
   "bin": {
     "claude-code-config": "./bin/cli.js"

package/.claude/commands/edit-notebook.md

@@ -1,79 +0,0 @@
----
-description: Safely edit Jupyter Notebook (.ipynb) files
----
-
-# Notebook Editing
-
-Safely edit Jupyter Notebook files using the correct tools.
-
-## Required Rules
-
-1. **Tool usage**: Use only the `NotebookEdit` tool
-   - Do not use text editing tools like `Edit`, `Write`, `search_replace`
-   - .ipynb files are JSON structures and require dedicated tools
-
-2. **Cell insertion order**: Ensure correct order when creating new notebooks
-   - **Important**: Cells are inserted at the beginning if `cell_id` is not specified
-   - **Method 1 (recommended)**: Track previous cell's cell_id for sequential insertion
-     ```
-     Insert first cell -> Returns cell_id='abc123'
-     Insert second cell with cell_id='abc123' -> Inserted after first cell
-     Insert third cell with cell_id='def456' -> Inserted after second cell
-     ```
-   - **Method 2**: Insert in reverse order (from last cell to first)
-   - **Never**: Insert sequentially without cell_id (causes reverse order)
-
-3. **Source format**: Source may be saved as string when using NotebookEdit
-   - **Problem**: `"line1\\nline2"` (string) -> `\n` displayed literally in Jupyter
-   - **Correct**: `["line1\n", "line2\n"]` (list of strings)
-   - **Solution**: When creating new notebooks, directly write JSON using Python
-
-4. **Post-edit verification**: Always verify after modifications
-   - Validate JSON syntax
-   - Confirm cell execution order is preserved (check first 30 lines with Read)
-   - Check for missing functions/imports/dependencies
-   - Preserve cell outputs unless explicitly instructed otherwise
-
-5. **Key Insights verification**: Verify outputs before documenting
-   - **Required steps**:
-     1. Read notebook output cells (use Read tool)
-     2. Read generated data files (CSV, JSON, etc.)
-     3. Check visualizations/images if any
-   - **Never**: Write insights based only on code flow
-   - **Required**: Document data source (e.g., "Source: outputs/analysis.csv")
-
-## Guidelines
-
-- **Use dedicated tool only**: Never use editing tools other than NotebookEdit
-- **Preserve structure**: Maintain existing cell order and outputs
-- **Verification required**: Immediately verify changes after editing
-- **Follow CLAUDE.md**: Adhere strictly to project guidelines
-
-## Path Compatibility
-
-Notebooks in `notebooks/` cannot use project-root relative paths directly.
-
-```python
-# First code cell - set PROJECT_ROOT
-from pathlib import Path
-
-PROJECT_ROOT = Path.cwd().parent
-if not (PROJECT_ROOT / 'outputs').exists():
-    PROJECT_ROOT = Path.cwd()
-
-# Use PROJECT_ROOT for all file paths
-data = np.load(PROJECT_ROOT / 'outputs/data.npz')
-```
-
-## Computation Efficiency
-
-### Avoid
-- Repeated model loading across cells
-- Re-running inference when results exist
-- Computing without caching
-
-### Required patterns
-1. **Cache-first**: Load cached results if exist, compute only if missing
-2. **Single instance**: Load model once in early cell, reuse throughout
-3. **Filter over recompute**: Filter cached results instead of re-running with different parameters
-