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 @@ +{}