SilverSight/REBASE_RULES.md

REBASE RULES — SilverSight Agent / Rules Manifest

Purpose: This file is a rebase seed. When starting a fresh project map, copy only the files and rules listed here. Do not migrate runtime state, stale audits, completed assignment boards, or legacy deployment hacks.

Principle: Port the contracts and the rituals, not the state.

Status: Research Stack contained many legacy hacks (Hermes ports, Headroom proxy endpoints, old benchmark tables, repo-specific paths). Those have been stripped. The core conceptual bindings — Lean authority, no-Float compute, receipt boundaries, programming-choice flow, and the post-interaction ritual — are preserved here and in AGENTS.md.

---

1. Core Operating Contracts (MUST PORT)

These files are the source of truth for every agent, skill, and editor hook. They are actively maintained and cross-referenced throughout the stack.

File	Scope
AGENTS.md (this repo)	SilverSight master operating contract. Distilled from Research Stack; strips legacy deployment details and adapts rules to the library-method architecture.
0-Core-Formalism/lean/Semantics/AGENTS.md	Lean/Semantics local contract: blessed Compiler surface, build baselines, quarantine boundaries, proof-tactic lessons, current solidification anchors. ADAPT to formal/AGENTS.md in SilverSight.
4-Infrastructure/AGENTS.md	Infrastructure and shim contract: storage stack, hardware-witness boundaries, ENE schema, compute dispatch pattern. PORT ONLY IF infrastructure work continues; otherwise drop.
6-Documentation/docs/AGENTS.md	Strict LLM operating rules: anti-drift evidence standards, bind primitive, naming conventions, sigma levels, SI units, deletion criteria, PQC policy. ADAPT to docs/AGENTS.md if strict doc rules are needed.
5-Applications/text-to-cad/AGENTS.md	CAD harness contract: generated CAD/URDF source-of-truth, viewer handoff, repo policies. PORT ONLY IF CAD work continues.
scripts/qc-flag/AGENTS.md	Lean QC protocol: 7-check inspection protocol. ADAPT to tests/qc-flag/AGENTS.md if the protocol is adopted.
shared-data/artifacts/lean_expert_agent/AGENTS.md	Lean expert agent /inspect protocol and output format. ADAPT if a formal reviewer agent is wired up.
.github/RRC_OPERATING_CONTRACT.md	Rainbow Raccoon Compiler gate definition: ACCEPT / HOLD / QUARANTINE. ADAPT to SilverSight's receipt gate if RRC work continues.

Non-negotiable rules extracted from the contracts

1. Lean is the source of truth. Python and Verilog are extraction targets only.
2. Programming choice flow — before writing new logic, check this decision tree in order:
   • Admissibility / routing / alignment / gating decision? → Lean only.
   • Minting/stamping a top-level receipt or JSON bundle? → Lean stamps; Python formats/stores only.
   • Classifying rows / computing alignment scores? → Lean (formal/CoreFormalism/ or a new formal/*.lean module).
   • Supplying raw input features (expression text, IDs, weak_axes)? → Python shim OK, no admissibility logic, regenerable from source.
   • Float arithmetic in a compute path? → STOP. Use Q16_16.ofNat, Q16_16.ofRatio, or Q16_16.ofRawInt.
   • Advancing promotion status in shim space? → STOP. not_promoted until a Lean gate passes.
   • Pure I/O (read/write JSON, subprocess, format output)? → Python shim OK. Receipt output is stamped in Lean and stored by Python.
3. No Float in Lean compute paths. ofFloat is permitted only at JSON/sensor boundaries and must be immediately bracketed. Float is forbidden in Core/ entirely.
4. Post-interaction workflow (mandatory after any code/receipt/architecture change):
   • Update the nearest scoped AGENTS.md for every touched subtree.
   • Run the narrow Lean target first, then full lake build if Lean files touched.
   • Commit with an explicit file list; never git add ..
   • Run git status --branch --short --untracked-files=all.
5. Do Not Sweep: never run git add ., git checkout -- ., or git clean -fdx.
6. Secrets are runtime-only: use environment variables (OLLAMA_API_KEY, DEEPSEEK_API_KEY, etc.); never commit literal keys.
7. Legacy recovery is explicit: use RECOVER LEGACY INFORMATION: <path/commit/concept> only. Cross-repo cornfield ref: backup/distilled-with-vcd-history-2026-05-11.

---

2. Editor / Agent Configs (MUST PORT)

These files inject the contracts into editor/agent runtimes.

File	Purpose
.cursorrules	Cursor: ContextStream init()/context()/search() rules.
.devin/config.json	Devin: programming-choice reminder hook.
.devin/hooks.json	Devin: ContextStream hooks.
.devin/hooks/programming-choice-reminder.sh	Injects programming-choice flow + post-interaction checklist before every user message.
.claude/settings.json	Claude Code: ContextStream hooks.
.cursor/hooks.json	Cursor: ContextStream hooks.
.roo/mcp.json	Roo: MCP server definitions.
.mcp.json (root)	Minimal MCP config: filesystem, git, fetch, contextstream, lean, remote-lean-proof, sympy, wolfram, aws, github, headroom.
.contextstream/config.json	ContextStream workspace/project IDs.
.kilo/rules/contextstream.md	Kilo Code manual ContextStream rules (no hooks available).
.roo/rules/contextstream.md	Roo Code ContextStream rules.
.windsurf/rules/contextstream.md	Windsurf ContextStream rules.

ContextStream-first workflow (enforced or self-enforced in every editor)

• First message: init(folder_path=...) → context(user_message=...).
• Subsequent messages: context(user_message=...) FIRST.
• Before any file search: search(mode="auto") BEFORE Glob/Grep/Read/Explore/Task/EnterPlanMode.
• After edits: project(action="index") in editors without auto-indexing.
• Save transcripts: save_exchange=true in editors without auto-saving.

---

3. Skills (MUST PORT)

Skill	Path	Purpose
lean-proof	.devin/skills/lean-proof/SKILL.md	Mandatory for all Lean work: proof quality, Q16_16 contract, #eval witnesses, promotion gate.
contextstream-workflow	.github/skills/contextstream-workflow/SKILL.md	Persistent memory: plans, tasks, decisions, lessons.
research-stack-workflow	.github/skills/research-stack-workflow/SKILL.md	Token-efficient proof workflow; local inference first on neon.
headroom	.opencode/skills/headroom/SKILL.md	Context compression and cross-agent memory.
cad	5-Applications/text-to-cad/skills/cad/SKILL.md	Script-driven STEP/STL/DXF/GLB generation.
urdf	5-Applications/text-to-cad/skills/urdf/SKILL.md	URDF generation and validation.
rrc-compile	.claude/skills/rrc-compile/SKILL.md	RRC pipeline orchestrator.
rrc-scale-analysis	.claude/skills/rrc-scale-analysis/SKILL.md	RRC pre-flight Q16_16 scale-band analysis.

---

4. MCP Servers (MUST PORT)

From .mcp.json / .roo/mcp.json:

Server	Role
contextstream	Persistent memory / context / search
filesystem	Read/write proof artifacts and receipts
git	History, blame, diff
fetch	HTTP docs and RFCs
lean	Lean 4 / Mathlib typecheck bridge
remote-lean-proof	Hermes / OpenCode / Codex proof backend
sympy	Symbolic arithmetic verification
wolfram-alpha	Formula verification (needs WOLFRAM_APP_ID)
aws	AWS API access
github	PRs, issues, CI
headroom	Token / context compression

---

5. Conditional Items (PORT ONLY IF DOMAIN REMAINS ACTIVE)

File	Condition
.windsurf/lifeguard.yaml	Keep only if genetics / GCCL / Mass Number abstraction work continues. Contains safety doctrine for biological-equivalence claims, reverse-collapse, bounded recursion, and claim-state hygiene.
.opencode/agents/*.md	Keep only if the target sorry/theorem is still open in the new rebase. These are task-specific subagent prompts.
.claude/workflows/ground-disproved-theorems.js	Keep only if Claude Code still uses this workflow.

---

6. DROP — Do Not Port

Item	Reason
.consolidation-manifests/	Historical SHA256 manifests from 2026-05-04. Not load-bearing.
.headroom/*.db	Runtime memory databases; regenerate on first use.
.agents/plugins/marketplace.json	References a dormant ./plugins/substack-connector. Not load-bearing.
.github/copilot-instructions.md	Core rules are valid, but the "Current Project State" block is stale (2026-05-28). Port rules separately, not this file as authority.
.windsurf/SORRY_AUDIT.md	Stale audit (2026-05-28). Root AGENTS.md now reports 0 sorries in the active Compiler surface. Archive only.
.windsurf/ASSIGNMENTS.md	Dated 2026-04-19; all assignments marked COMPLETE and references old paths. Historical residue.
Staging manifests (stack_solidification_staging_manifest_2026-05-09.md, etc.)	Historical archives; referenced but not authoritative.
Cornfield / legacy branches	Do not merge or base work on them. Use only via explicit recovery trigger.

---

7. Minimal Rebase Checklist

Use this when standing up the new project map.

• Copy all files in Section 1 (Core Operating Contracts).
• Copy all files in Section 2 (Editor / Agent Configs).
• Copy all files in Section 3 (Skills).
• Copy/adapt .mcp.json and .roo/mcp.json with current server paths.
• Update .contextstream/config.json with new workspace/project IDs if they change.
• Review Section 5 conditional items and keep only active-domain rules.
• Verify Section 6 dropped items are not carried over.
• Run lake build Compiler and confirm job count matches the new baseline.
• Update build baseline and commit hash in 0-Core-Formalism/lean/Semantics/AGENTS.md.

---

8. Design Note for the New Map

When designing the new project layout, preserve these boundary rules:

• Lean owns decisions; Python owns I/O.
• Core/SilverSightCore.lean is the root authority and imports nothing.
• The Receipt is the sole Core/library boundary. Lean stamps; libraries format/store.
• python/ and qubo/ are I/O and optimization shims only. No admissibility logic in shim space.
• Research artifacts go outside the git tree unless promoted as durable receipts.
• Every new compression path needs two Lean theorems: eigensolid_convergence and receipt_invertible.
• No library imports another library. Libraries import Core/ only.

---

Generated from active Research Stack agent rules and contracts, stripped of legacy hacks. Principle: port contracts and rituals, not state. SilverSight master contract: AGENTS.md.