From a8c482523483981c94e69f5fa33bdba00cd721bf Mon Sep 17 00:00:00 2001 From: zemion Date: Mon, 6 Jul 2026 14:29:01 +0200 Subject: [PATCH] Sync Repo-README-USE-WITH-CODEX from project files --- Repo-README-USE-WITH-CODEX.-.md | 34 +++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 Repo-README-USE-WITH-CODEX.-.md diff --git a/Repo-README-USE-WITH-CODEX.-.md b/Repo-README-USE-WITH-CODEX.-.md new file mode 100644 index 0000000..4328d5b --- /dev/null +++ b/Repo-README-USE-WITH-CODEX.-.md @@ -0,0 +1,34 @@ + + +> Mirrored from `/mnt/DATA/git/comiaunicaty/README_USE_WITH_CODEX.md`. +> Origin: `repository`. +> Active tasks and changing state belong in Gitea issues; this wiki page is durable project context. + +--- +# How to use this package with Codex + +This package contains a Codex-ready build brief for a browser-first group coordination platform. + +Recommended use: + +1. Create an empty Git repository. +2. Copy `AGENTS.md`, `CODEX_TASK.md`, `PRODUCT_SPEC.md`, `ARCHITECTURE_CONTRACTS.md`, and `ACCEPTANCE_TESTS.md` into the repository root. +3. Open the repo in Codex. +4. Ask Codex: + +```text +Read AGENTS.md and CODEX_TASK.md. Implement the full product described in PRODUCT_SPEC.md, ARCHITECTURE_CONTRACTS.md, and ACCEPTANCE_TESTS.md. Build a runnable monorepo. Do not stop at a prototype shell; deliver working vertical slices first, then deepen features until the acceptance tests pass. +``` + +Alternative: paste the contents of `CODEX_TASK.md` directly into Codex after adding the other files to the repo. + +The intended result is a monorepo with: + +```text +backend/ FastAPI app, DB models, API routes, seed data, tests +frontend/ React/Vite app, mobile-first UI, client API layer, tests +docker-compose.yml +README.md +``` + +The project deliberately excludes full federation, native apps, unofficial WhatsApp bridges, and production-grade end-to-end encryption. It includes local/self-hosted servers, a home-server model, and cross-server aggregation through scoped server connections.