Initial commit

skills/play-tight/references/patterns.md

@@ -0,0 +1,81 @@
+# Browser Automation Patterns
+
+## Common Extraction Patterns
+
+### GitHub PR Status Check
+
+```bash
+node scripts/navigate-and-extract.js "https://github.com/user/repo/pull/123" '{
+  "waitFor": ".merge-status-item",
+  "counts": {
+    "total_checks": ".merge-status-item",
+    "passing_checks": ".merge-status-item.text-green"
+  },
+  "checks": {
+    "has_conflicts": "text=conflicts",
+    "is_approved": ".review-status.approved"
+  },
+  "selectors": {
+    "title": ".js-issue-title"
+  }
+}'
+```
+
+### Form Field Discovery
+
+```bash
+# Step 1: Find form
+node scripts/check-element.js "https://example.com" "form#login"
+
+# Step 2: Find inputs
+node scripts/check-element.js "https://example.com" "input[name='username']"
+node scripts/check-element.js "https://example.com" "input[name='password']"
+node scripts/check-element.js "https://example.com" "button[type='submit']"
+```
+
+### Content Verification
+
+```bash
+# Check if specific text appears
+node scripts/get-text.js "https://example.com/docs" ".main-content"
+
+# Verify element visibility
+node scripts/check-element.js "https://example.com" "#success-message"
+```
+
+### CI/CD Dashboard Status
+
+```bash
+node scripts/navigate-and-extract.js "https://ci.example.com/build/123" '{
+  "waitFor": ".build-status",
+  "selectors": {
+    "status": ".build-status",
+    "branch": ".branch-name",
+    "commit": ".commit-hash"
+  },
+  "checks": {
+    "is_passing": ".status-success",
+    "is_running": ".status-running"
+  }
+}'
+```
+
+## Error Handling
+
+All scripts return JSON with error information:
+
+```json
+{
+  "found": false,
+  "error": "timeout navigating to page"
+}
+```
+
+Check `success`, `found`, or `error` fields in responses.
+
+## Performance Tips
+
+1. **Use waitFor**: Specify element to wait for in navigate-and-extract
+2. **Batch extractions**: Use navigate-and-extract for multiple elements
+3. **Headless mode**: All scripts run headless by default (fast)
+4. **Truncation**: Scripts automatically limit text length