Deduplicate README structure list and add consistency lint

README no longer mirrors the contract list; the bootstrap router is the
single source of truth. scripts/lint.sh checks router coverage, dead
bootstrap references, and machine-local absolute paths.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-12 09:44:40 +03:00
parent c8f072661f
commit 80e87cdc1f
2 changed files with 42 additions and 18 deletions

View File

@@ -33,26 +33,16 @@ git submodule update --remote bible
## Structure
```
AGENT-BOOTSTRAP.md — first file agents should read
rules/patterns/ — shared engineering rule contracts
go-logging/ — slog, server-side only
go-database/ — cursor safety, soft delete, GORM, N+1
go-api/ — REST conventions, error format, status codes
go-background-tasks/ — Task Manager pattern, polling
go-code-style/ — layering, error wrapping, startup sequence
go-project-bible/ — how to write and maintain a project bible
bom-decomposition/ — one BOM row to many component/LOT mappings
import-export/ — CSV Excel-compatible format, streaming export
table-management/ — toolbar, filtering, pagination
modal-workflows/ — state machine, htmx pattern, confirmation
forms-validation/ — validation, multi-step flows
controls-selection/ — buttons, checkboxes, segmented filters
rules/ai/claude/
CLAUDE.template.md — base CLAUDE.md template for new projects
rules/ai/codex/
AGENTS.template.md — base AGENTS.md template for new projects
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/claude/ — CLAUDE.template.md for new projects
rules/ai/codex/ — AGENTS.template.md for new projects
scripts/lint.sh — consistency checks (router coverage, broken links)
```
The list of contracts is not duplicated here. The single source of truth for what exists
and when to read it is the router in `AGENT-BOOTSTRAP.md`.
## Project Setup
Each project needs: