Michael Chus 1977730d93 Add hardware-ingest-json and submodule-integration contracts; expand go-database cursor safety
Synthesized from bible-local reviews across bee, logpile, core, chart, PriceForge:
- rules/patterns/hardware-ingest-json/contract.md — Reanimator JSON ingest schema v2.10
- rules/patterns/submodule-integration/contract.md — read-only submodule principle
- go-database: add driver-level violation symptoms for cursor safety rule

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-12 10:17:50 +03:00
2026-03-01 16:56:00 +03:00

Bible

Shared engineering rules library for Go web projects.

Add as a git submodule to any project — agents (Claude, Codex) will read the rules automatically.

Agents start at AGENT-BOOTSTRAP.md — it defines the read path, always-on contracts, and the task router. Nothing in this README duplicates it.

Usage

# Add to a project
git submodule add https://git.mchus.pro/mchus/bible.git bible

# Update to latest rules
git submodule update --remote bible

Structure

AGENT-BOOTSTRAP.md         — first file agents should read; contains the full contract router
rules/patterns/<topic>/    — one contract.md per topic (plus optional README.md with examples)
rules/ai/AGENT.template.md — template for new projects; copy as both CLAUDE.md and AGENTS.md
scripts/lint.sh            — consistency checks (router coverage, broken links)

Project Setup

Each project needs:

  • bible/ — this submodule
  • bible-local/ — project-specific architecture (data model, API, ADL)
  • CLAUDE.md + AGENTS.md — copies of rules/ai/AGENT.template.md pointing agents to the bootstrap

See rules/patterns/go-project-bible/contract.md for what goes in bible-local/.

Description
No description provided
Readme 540 KiB
Languages
CSS 55%
HTML 39.1%
Shell 5.9%