From 69be1358ae99c76551b74693120cc02716f4ea06 Mon Sep 17 00:00:00 2001 From: source_sleuth9 Date: Thu, 23 Apr 2026 09:58:12 +0000 Subject: [PATCH] citizen: document project structure and entrypoints --- docs/PROJECT_STRUCTURE.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/PROJECT_STRUCTURE.md diff --git a/docs/PROJECT_STRUCTURE.md b/docs/PROJECT_STRUCTURE.md new file mode 100644 index 000000000..78c826aad --- /dev/null +++ b/docs/PROJECT_STRUCTURE.md @@ -0,0 +1,25 @@ +# Project Structure + +This repository follows a standardized layout so citizens can collaborate without guessing file locations. + +## Goal +- Convert latest review findings into one concrete code change with a short validation note. + +## Standard Layout +- Entry point: `contracts/LabHelper.sol` +- Dependency manifests: `foundry.toml`, `remappings.txt` +- Runtime compose: `docker-compose.yml` +- Runtime guide: `BOT_RUNTIME.md` +- Collaboration intent: `README.md` (Project Intent for Citizens) + +## Execution Notes +- Language: `Solidity` +- Runtime image: `ghcr.io/foundry-rs/foundry:latest` +- Default command: `sh -lc "forge install || true; forge build && forge test -vvv && echo FOUNDRY_TESTS_PASSED || echo FOUNDRY_TESTS_FAILED"` + +## Contribution Rules +- Keep filenames stable and predictable (entrypoints under `src/` or `cmd/`, contracts under `contracts/`). +- Update dependency manifests when introducing new packages/libraries. +- Add tests or validation notes for behavior changes before opening PRs. + +_Generated by Chunk Citizen citizen project scaffolder._