From eb7c3739cedac59daecaa1d3c79fb71fab1300a2 Mon Sep 17 00:00:00 2001 From: Michael Chus Date: Sun, 1 Mar 2026 16:38:01 +0300 Subject: [PATCH] Add shared bible submodule, rename local bible to bible-local MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add bible.git as submodule at bible/ - Rename bible/ → bible-local/ (project-specific architecture) - Update CLAUDE.md to reference both bible/ and bible-local/ - Add AGENTS.md for Codex with same structure Co-Authored-By: Claude Sonnet 4.6 --- .gitmodules | 3 +++ AGENTS.md | 11 +++++++++ CLAUDE.md | 29 +++++++++-------------- bible | 1 + {bible => bible-local}/01-overview.md | 0 {bible => bible-local}/02-architecture.md | 0 {bible => bible-local}/03-database.md | 0 {bible => bible-local}/04-api.md | 0 {bible => bible-local}/05-config.md | 0 {bible => bible-local}/06-backup.md | 0 {bible => bible-local}/07-dev.md | 0 {bible => bible-local}/09-vendor-spec.md | 0 {bible => bible-local}/README.md | 0 package-lock.json | 6 +++++ package.json | 1 + 15 files changed, 33 insertions(+), 18 deletions(-) create mode 100644 .gitmodules create mode 100644 AGENTS.md create mode 160000 bible rename {bible => bible-local}/01-overview.md (100%) rename {bible => bible-local}/02-architecture.md (100%) rename {bible => bible-local}/03-database.md (100%) rename {bible => bible-local}/04-api.md (100%) rename {bible => bible-local}/05-config.md (100%) rename {bible => bible-local}/06-backup.md (100%) rename {bible => bible-local}/07-dev.md (100%) rename {bible => bible-local}/09-vendor-spec.md (100%) rename {bible => bible-local}/README.md (100%) create mode 100644 package-lock.json create mode 100644 package.json diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..fa8f9e7 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "bible"] + path = bible + url = https://git.mchus.pro/mchus/bible.git diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..3da2aa1 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,11 @@ +# QuoteForge — Instructions for Codex + +## Shared Engineering Rules +Read `bible/` — shared rules for all projects (CSV, logging, DB, tables, background tasks, code style). +Start with `bible/kit/patterns/` for specific contracts. + +## Project Architecture +Read `bible-local/` — QuoteForge specific architecture. +Read order: `bible-local/README.md` → relevant files for the task. + +Every architectural decision specific to this project must be recorded in `bible-local/`. diff --git a/CLAUDE.md b/CLAUDE.md index 0bab65c..425ff90 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,24 +1,17 @@ -# QuoteForge - Claude Code Instructions +# QuoteForge — Instructions for Claude -## Bible +## Shared Engineering Rules +Read `bible/` — shared rules for all projects (CSV, logging, DB, tables, background tasks, code style). +Start with `bible/kit/patterns/` for specific contracts. -The **[bible/](bible/README.md)** is the single source of truth for this project's architecture, schemas, patterns, and rules. Read it before making any changes. +## Project Architecture +Read `bible-local/` — QuoteForge specific architecture. +Read order: `bible-local/README.md` → relevant files for the task. -**Rules:** -- Every architectural decision must be recorded in `bible/` in the same commit as the code. -- Bible files are written and updated in **English only**. -- Before working on the codebase, check `releases/memory/` for the latest release notes. - -## Quick Reference +Every architectural decision specific to this project must be recorded in `bible-local/`. ```bash -# Verify build -go build ./cmd/qfs && go vet ./... - -# Run -go run ./cmd/qfs -make run - -# Build -make build-release +go build ./cmd/qfs && go vet ./... # verify +go run ./cmd/qfs # run +make build-release # release build ``` diff --git a/bible b/bible new file mode 160000 index 0000000..8f28cfe --- /dev/null +++ b/bible @@ -0,0 +1 @@ +Subproject commit 8f28cfeac283c9f1b70c4d512e0ab432a6c8d6fa diff --git a/bible/01-overview.md b/bible-local/01-overview.md similarity index 100% rename from bible/01-overview.md rename to bible-local/01-overview.md diff --git a/bible/02-architecture.md b/bible-local/02-architecture.md similarity index 100% rename from bible/02-architecture.md rename to bible-local/02-architecture.md diff --git a/bible/03-database.md b/bible-local/03-database.md similarity index 100% rename from bible/03-database.md rename to bible-local/03-database.md diff --git a/bible/04-api.md b/bible-local/04-api.md similarity index 100% rename from bible/04-api.md rename to bible-local/04-api.md diff --git a/bible/05-config.md b/bible-local/05-config.md similarity index 100% rename from bible/05-config.md rename to bible-local/05-config.md diff --git a/bible/06-backup.md b/bible-local/06-backup.md similarity index 100% rename from bible/06-backup.md rename to bible-local/06-backup.md diff --git a/bible/07-dev.md b/bible-local/07-dev.md similarity index 100% rename from bible/07-dev.md rename to bible-local/07-dev.md diff --git a/bible/09-vendor-spec.md b/bible-local/09-vendor-spec.md similarity index 100% rename from bible/09-vendor-spec.md rename to bible-local/09-vendor-spec.md diff --git a/bible/README.md b/bible-local/README.md similarity index 100% rename from bible/README.md rename to bible-local/README.md diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..99c5667 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,6 @@ +{ + "name": "QuoteForge", + "lockfileVersion": 3, + "requires": true, + "packages": {} +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..0967ef4 --- /dev/null +++ b/package.json @@ -0,0 +1 @@ +{}