docs(gittensor): adoption guide (init, MCP wiring, decision workflow)

[dripsmvcp]

Summary

• Commits a small, cited, review-gated vouch knowledge base (.vouch/) to the repo as the durable memory layer for scoring/policy decisions, wires it for MCP agents, and documents the workflow. No change to subnet scoring code — this is a knowledge layer alongside it.

Why

Scoring rules, the repo allow-list, anti-sybil thresholds, and the emission split get decided and revised across PRs, Discord, and validator changes — and the why ends up scattered or lost. vouch keeps each decision as an atomic claim, cited to its source, behind a maintainer approval gate, with an explicit supersede trail. It complements Gittensory: Gittensory is the live-data layer (scores, queues, collision/reviewability); vouch is the durable-decision layer. vouch stores no live signals.

What changed

• .vouch/ — initialised with the built-in gittensor pack (vouch init --template gittensor): 1 source, 1 entity, 7 cited+approved starter claims (merged-PR rewards, PAT verification, scoring factors, sybil-resistance, repo allow-list policy, issue-solving multiplier, emission split). proposed/ and state.db are gitignored so drafts and the derived index stay out of history.
• .mcp.json — registers vouch serve so agents (Claude Code / Cursor / Codex) can query the KB for cited answers instead of guessing.
• CONTRIBUTING.md — a short note: record scoring/policy decisions in vouch, cite the PR, supersede what changes.

Acceptance (from the proposal)

• .vouch/ committed, seeded with the gittensor template, vouch doctor clean.
• Current scoring rubric + allow-list policy captured as cited, approved claims (starter claims seeded; supersede with exact spec/PR citations as they're confirmed).
• .mcp.json documented for agent users (pipx install vouch-kb).
• CONTRIBUTING note added.

What might break

Nothing in the subnet/scoring path — this only adds a .vouch/ directory, .mcp.json, and a CONTRIBUTING section. Contributors who don't use vouch are unaffected.

Notes for reviewers

The 7 seeded claims are starter-grade summaries of SN74 scoring as understood today (confidence ≤ 0.9). They're meant to be reviewed and vouch supersede-d against the live spec/validator PRs — that is the workflow, not a one-time import. Adoption guide: https://github.com/vouchdev/vouch/blob/test/docs/gittensor.md

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d3979db3-d994-43e8-8300-6fffd167e32a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}