setup-house
use this when a team has no house/ folder yet
- License 许可
- MIT
- 所属仓库
- 0xRayAI/xray
- 最近更新
- 2026-11-13
- Stars
- ★ 2
- Forks
- 3
01 前言 Front Matter
- name
- setup-house
- description
- use this when a team has no house/ folder yet
03 SKILL.md 正文
Set up a house
The operating page is the same for every team. Your house is who you are, where you post, and what you allow.
- Run
grok-bot house init. It copiestemplates/house/into./house, includingwatchers/andfleet/, and refuses if a target file already exists. The board ishouse/WAVEBOARD.mdwhenLIVE_URLis unset, and Bifrost (GET /cards) whenLIVE_URLis set. Readhouse/ATTENTION_STATE.mdin either case. The copiedbifrost-waves.jsonis an empty wave list. If the board is stillops/WAVEBOARD.md, or an existing HOUSE.md has no Cadence section, rungrok-bot house init --migrate. That moves the board tohouse/WAVEBOARD.md, startsATTENTION_STATE.mdand any missing watcher or fleet files, appends the template Cadence block when HOUSE.md lacks it, and leaves a file you already changed (including a ledger). When both boards exist andhouse/WAVEBOARD.mdis not the untouched template, migrate exits 1 and writes nothing. - Fill HOUSE.md from what the owner has already said. Ask the owner only for what's missing, one question at a time. Set
name:to the owner name andOP-PROC:to the procedure file (grok-bot/OP-PROC.mdunless the house has an overlay). Delete the Cadence section if this house has no code loop. Otherwise name the four watcher owners and set the stall thresholds. ROLE-MAP.md is an optional roster (role, seat name, agent id). Leave it blank until you have ids. The label and the BOOT line live under that table. - Show the owner the filled HOUSE.md. Nothing in Allowed counts until they approve it. Paste the same Ask first and Allow lines into AUTO-REVIEW.md. That file is the only house file that enforces them.
- Run
grok-bot doctoruntil it passes. A HOUSE.md line that is exactlywallet offskips Open Wallet, Clearing, and hangar pay steps. - Tell every seat to read
house/on its next wake. Each new seat runsseat-labelin its own chat, then uses~/bin/gh-<seat>instead of plaingh. Board rule. On every owner message runlive-inbox <seat> --prompt --from owner --note "<gist>". Ack a handled line withlive-inbox <seat> --ack <id>, orlive-inbox <seat> --ack allonce every open line is handled. A cloud agent run useslive-inbox <seat> --turn start --tag "bc-<first8> <track>"besidelive-inbox <seat> --cloud launch --agent <bc-id> --tag <card>on first start or--cloud replyon resume, andlive-inbox <seat> --turn end --tag "bc-<first8>"besidelive-inbox <seat> --cloud finished --agent <bc-id> --tag <card>(cancel is--cloud cancel). The tag is owner/repo#n or xray#n. The cloud agent does not post that line.--from owneris required today. Kanban note. The live page shows a read-only kanban above Activity. Columns are open, review, fix, merge, retest, and done. The deep link is?card=. History note. Every activity line is archived to history. The word owner is the owner via LIVE_OWNER or the owner-name.
Change the house when the owner says a rule twice. Don't put rules there that belong on the operating page.
04 同仓库更多 Skills
xray-orchestrator
Main orchestration skill for xray agents. Provides commands to coordinate agent work and invoke xray APIs through the local HTTP API server.
ui-ux-design
User interface and user experience design with mobile-first approach, cognitive simplicity, and accessibility-first principles
testing-strategy
Design comprehensive testing strategies and optimize test coverage
testing-best-practices
Testing best practices and quality assurance
tech-writer
Documentation writer for API docs, READMEs, ADRs, changelogs, and developer experience
strategist
Strategic guidance and complex problem-solving with architectural decision-making and risk analysis