Michael Chus
421d004faf
Each rule now has one owning contract; others point to it: validation and multi-step rules live in forms-validation (modal-workflows references them), pagination metadata lives in go-api (table-management references it), the async task flow lives in go-background-tasks (go-api references it), backup git-safety checks live in backup-management (go-database references it). Remove the leftover Vapor/Aqua baseline mention and stale kit/patterns paths, compress the batch-file-upload ADR narrative, and drop content-free pattern READMEs. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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 submodulebible-local/— project-specific architecture (data model, API, ADL)CLAUDE.md+AGENTS.md— copies ofrules/ai/AGENT.template.mdpointing agents to the bootstrap
See rules/patterns/go-project-bible/contract.md for what goes in bible-local/.