Windsurf rules

1---
2name: research-first
3model: sonnet
4description: "Look-before-build — search registries, repo, existing skills, and web for prior art before implementing. Appends Prior Art to the spec. Use after survey-context and before elaborate-spec, when adding dependencies, or when the task may already be solved."
5---
6 
7# story: e03s01
8# story: e21s02
9 
10# Research First
11 
12> **HARD GATE** — Do NOT implement until prior art is searched. Minimum outcome: adopt, extend, compose, or build — with evidence.
13 
14## Process
15 
161. Read `specs/product/SCOPE_LATEST.yaml`, `specs/release-plan.yaml + epic shards`, and the current task statement.
172. Search in order: this repo → bigpowers skills (`search-skills`) → package registries → web docs.
183. **Check opensrc cache** — if the task integrates an external library, run `bash scripts/bp-opensrc-check.sh` (or `npx opensrc search <pkg>`) to find locally-cached source. Read the `src/` directory for API shapes before writing any integration code.
194. For each candidate: note name, URL/path, fit (adopt | extend | compose | build).
205. Append `## Prior Art` to `requirements/SCOPE_LATEST.yaml` notes or the active epic story.
21 
22## opensrc Integration
23 
24`opensrc` is a local cache of 200+ open-source repos and npm/PyPI packages. Query it before building any external integration to avoid re-inventing documented API shapes.
25 
26```bash
27# Check if a package is cached
28npx opensrc search &lt;package-name&gt;
29 
30# Or use the bundled helper (checks all deps from package.json or requirements.txt)
31bash scripts/bp-opensrc-check.sh [package.json|requirements.txt]
32```
33 
34If opensrc finds a match, read its `src/` or source directory and append findings to the **Prior Art** section:
35 
36```
37opensrc: found <pkg> v<version> — exports <key classes/functions>
38```
39 
40If opensrc is not installed or the package is not cached, fall through to web docs normally.
41 
42## Outcome matrix
43 
44| Verdict | Action |
45|---------|--------|
46| **adopt** | Use as-is; link in plan; no new code |
47| **extend** | Wrap or configure existing solution |
48| **compose** | Chain existing skills/modules |
49| **build** | New implementation — justify why others failed |
50 
51## Verify
52 
53→ verify: `grep -rq 'Prior Art' specs/product specs/release-plan.yaml specs/epics 2>/dev/null`
54 
55See [REFERENCE.md](REFERENCE.md) for search commands and registry checklist.
56 
57---
58 
59# Research First — Reference
60 
61## Search commands
62 
63```bash
64# Repo prior art
65rg -l &quot;&lt;keyword&gt;&quot; --glob '!node_modules' .
66find . -maxdepth 3 -name &quot;SKILL.md&quot; | xargs grep -l &quot;&lt;intent&gt;&quot;
67 
68# Installed packages (if package.json exists)
69cat package.json | jq '.dependencies,.devDependencies' 2&gt;/dev/null
70```
71 
72## Registry checklist
73 
74- [ ] npm / PyPI / crates.io (if applicable)
75- [ ] Existing bigpowers skill (`bash scripts/build-skill-index.sh && rg "<intent>" specs/SKILL-SEARCH-INDEX_LATEST.md`)
76- [ ] Project `docs/` and `specs/adr/`
77- [ ] Official library documentation (quote one API detail)
78 
79## Prior Art template
80 
81```markdown
82## Prior Art
83 
84| Candidate | Source | Verdict | Notes |
85|-----------|--------|---------|-------|
86| ... | ... | adopt/extend/compose/build | ... |
87```
88