# BRO skill — Bluehand Research Object

Human-first object, machine-projectable structure. Canonical contract: `research/contracts/cursor_contract_bro_v0_7.md`.

## Edit path

1. Change `research/registry.json` (single source of truth)
2. Run `bun run research:compile`
3. Verify: `bun run verify:local`

## Required envelope (public)

- `bro.human_orientation` — purpose, problem, why_now, reader_takeaway
- `bro.stakeholder_alignment` — best_for, recruiter/grant relevance
- `bro.category_sets` — topic, capability, method, constraint, failure_mode
- `bro.public_boundary` — public_claims, do_not_infer, implementation_boundary

## Non-goals

- No second registry outside `research/registry.json`
- No strict lineage mandate on the public library
- No treating summaries/embeddings as evidence without lineage

## Projections

| Surface | Path |
|---------|------|
| HTML brief | `/research/<slug>/` |
| PDF | `/bluehand-*.pdf` when published |
| Discovery | `llms.txt`, `sitemap.xml`, JSON-LD via prerender |

Contract version in registry: `RL-CONTRACT-v0.2`.
