1 files changed, 77 insertions, 0 deletions
diff --git a/pairwise-tests/scripts/README.md b/pairwise-tests/scripts/README.md
new file mode 100644
index 0000000..87ea259
--- /dev/null
+++ b/pairwise-tests/scripts/README.md
@@ -0,0 +1,77 @@
+# Scripts
+
+This directory contains helper scripts for working with PICT models and test cases.
+
+## Available Scripts
+
+### pict_helper.py
+
+A Python utility for:
+- Generating PICT models from JSON configuration
+- Formatting PICT output as markdown tables
+- Parsing PICT output into JSON
+
+**Installation:**
+```bash
+pip install pypict --break-system-packages
+```
+
+**Usage:**
+
+1. **Generate PICT model from config:**
+   ```bash
+   python pict_helper.py generate config.json > model.txt
+   ```
+
+2. **Format PICT output as markdown:**
+   ```bash
+   python pict_helper.py format output.txt
+   ```
+
+3. **Parse PICT output to JSON:**
+   ```bash
+   python pict_helper.py parse output.txt
+   ```
+
+**Example config.json:**
+```json
+{
+    "parameters": {
+        "Browser": ["Chrome", "Firefox", "Safari"],
+        "OS": ["Windows", "MacOS", "Linux"],
+        "Memory": ["4GB", "8GB", "16GB"]
+    },
+    "constraints": [
+        "IF [OS] = \"MacOS\" THEN [Browser] <> \"IE\"",
+        "IF [Memory] = \"4GB\" THEN [OS] <> \"MacOS\""
+    ]
+}
+```
+
+## Future Scripts
+
+We welcome contributions for:
+- Test automation generators
+- Export to test management tools (JIRA, TestRail)
+- Integration with CI/CD pipelines
+- Coverage analysis tools
+- Constraint validation utilities
+
+## Contributing
+
+Have a useful script to share?
+
+1. Add your script to this directory
+2. Update this README with usage instructions
+3. Add comments and examples in your script
+4. Submit a pull request
+
+See [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelines.
+
+## Dependencies
+
+Current scripts use:
+- Python 3.7+
+- pypict (optional, for direct PICT integration)
+
+All dependencies should be clearly documented in each script.