Skip to content

Commit 071fdd1

Browse files
author
Bryan Howard
committed
Update CLAUDE.md with Windows command requirements and current project state
- Move Windows-only platform requirements to top with explicit forbidden/required commands - Add release notes rule to prevent marketing language - Update test file count from 18+ to 50+ reflecting current test suite - Add virtual environments concept to Key Concepts - Remove duplicate platform requirement sections - Update architecture notes from subprocess to single process execution Generated with [Claude Code](https://claude.ai/code)
1 parent 0d60178 commit 071fdd1

File tree

1 file changed

+29
-23
lines changed

1 file changed

+29
-23
lines changed

CLAUDE.md

Lines changed: 29 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,35 @@
11
# CLAUDE.md
22

3+
## CRITICAL WINDOWS-ONLY PLATFORM REQUIREMENTS
4+
5+
**ABSOLUTE RULE**: This is a Windows-only codebase. Claude Code MUST NEVER use Linux commands.
6+
7+
**FORBIDDEN Linux Commands - NEVER USE THESE:**
8+
- `ls`, `grep`, `find`, `chmod`, `./script.sh`, `/usr/bin/bash`, `cat`, `head`, `tail`, `rm`, `mv`, `cp`
9+
10+
**REQUIRED Windows Commands - ALWAYS USE THESE:**
11+
- `dir` (not `ls`)
12+
- `findstr` (not `grep`)
13+
- `where` (not `find`)
14+
- `del` (not `rm`)
15+
- `move` (not `mv`)
16+
- `copy` (not `cp`)
17+
- `type` (not `cat`)
18+
- `script.bat` (not `./script.sh`)
19+
- `python` (not `python3`)
20+
21+
**File Operations:**
22+
- Use Windows paths: `E:\HOME\PyFlowGraph\`
23+
- Execute batch files directly: `run.bat` (not `./run.bat`)
24+
- Use backslashes `\` or forward slashes `/` for paths
25+
326
## Project Overview
427

528
PyFlowGraph: Universal node-based visual scripting editor built with Python and PySide6. "Code as Nodes" philosophy with automatic pin generation from Python function signatures.
629

730
## Commands
831

9-
**Running**: `run.bat` (Windows) or `./run.sh` (Linux/macOS)
32+
**Running**: `run.bat`
1033
**Testing**: `run_test_gui.bat` - Professional GUI test runner
1134
**Dependencies**: `pip install PySide6`
1235

@@ -31,6 +54,7 @@ PyFlowGraph: Universal node-based visual scripting editor built with Python and
3154
**Node Function Parsing**: Automatic pin generation from Python function signatures with type hints
3255
**Data Flow Execution**: Data-driven (not control-flow), single process architecture, direct object references
3356
**Graph Persistence**: Clean JSON format, saved to `examples/` directory
57+
**Virtual Environments**: Graphs can specify dependencies and use isolated `venvs/` environments
3458

3559
## File Organization
3660

@@ -55,7 +79,7 @@ PyFlowGraph/
5579
- **Coverage-driven test generation** for missing tests
5680
- **Token-efficient reporting** optimized for Claude Code
5781

58-
**Current Suite**: 18+ test files covering node system, pins, connections, execution, file formats
82+
**Current Suite**: 50+ test files covering node system, pins, connections, execution, file formats
5983
**GUI Runner**: `run_test_gui.bat` - Professional PySide6 interface with real-time status
6084
**Coverage**: Core components, command system, integration scenarios
6185

@@ -74,26 +98,12 @@ PyFlowGraph/
7498

7599
## Development Notes
76100

77-
- **WINDOWS-ONLY CODEBASE**: This project runs exclusively on Windows
78101
- PySide6 Qt-based GUI with Font Awesome icons
79-
- Isolated subprocess execution for security
102+
- Single process execution for performance
80103
- No Claude attribution in commits or code comments
81104
- **NEVER use emojis in any code, tests, or temporary files - causes encoding issues**
82105
- Clean, professional, technical documentation only
83106

84-
## Windows Platform Requirements
85-
86-
**CRITICAL**: This is a Windows-only codebase. Claude Code MUST use Windows-compatible commands:
87-
88-
- **Shell Commands**: Use `cmd`, `powershell`, or Windows batch commands only
89-
- **File Operations**: Use Windows paths with backslashes `\` or forward slashes `/`
90-
- **Batch Files**: Execute `.bat` files directly (e.g., `run.bat`, `run_test_gui.bat`)
91-
- **Python Execution**: Use `python` command (not `python3`)
92-
- **Path Separators**: Use Windows-style paths `E:\HOME\PyFlowGraph\`
93-
94-
**FORBIDDEN Linux Commands**:
95-
- Do NOT use: `ls`, `grep`, `find`, `chmod`, `./script.sh`, `/usr/bin/bash`
96-
- Use instead: `dir`, `findstr`, `where`, `attrib`, `script.bat`, `cmd.exe`
97107

98108
## Code Standards
99109

@@ -120,9 +130,5 @@ NEVER use emojis in any code, tests, or temporary files - causes Windows encodin
120130

121131
**CRITICAL GIT COMMIT RULE**: NEVER commit changes unless the user explicitly asks to commit. Always wait for the user to test and verify changes work before committing. Do NOT commit automatically after making changes - this is forbidden.
122132

123-
**WINDOWS-ONLY PLATFORM REQUIREMENTS**:
124-
- NEVER use Linux commands: `ls`, `grep`, `find`, `chmod`, `/usr/bin/bash`, `./script.sh`
125-
- ALWAYS use Windows commands: `dir`, `findstr`, `where`, `attrib`, `cmd.exe`, `script.bat`
126-
- Execute batch files directly: `run.bat`, `run_test_gui.bat` (not `./run.bat`)
127-
- Use Windows paths: `E:\HOME\PyFlowGraph\` or forward slashes for compatibility
128-
- Use `python` command (not `python3`)
133+
**RELEASE NOTES RULE**: Write professional, technical release notes. Never use marketing language, excessive emojis, or promotional tone. Focus on factual changes, technical details, and concrete improvements. Avoid words like "revolutionary", "breakthrough", "amazing", etc.
134+

0 commit comments

Comments
 (0)