chore: consolidate new foundation and archive v1 (#1495)

2026-09-07 12:32:57 -05:00
parent 9a5fbdbda7 5d27700026
commit 127a54fdff
3511 changed files with 727899 additions and 10 deletions
@@ -0,0 +1,21 @@
+## Campsite Rule (MANDATORY)
+
+If you modify a line containing a policy violation, you MUST either:
+
+1. **Fix the violation properly** in the same change, OR
+2. **Flag it as a deferred item** with documented rationale
+
+**"It was already there" is NEVER an acceptable justification** for perpetuating a violation in code you touched. Touching it makes it yours.
+
+Examples of violations you must fix when you touch the line:
+
+- `as unknown as Type` double assertions — use type guards instead
+- `any` types — narrow to `unknown` with validation or define a proper interface
+- Missing error handling — add it if you're modifying the surrounding code
+- Suppressed linting rules (`// eslint-disable`) — fix the underlying issue
+
+If the proper fix is too large for the current scope, you MUST:
+
+- Create a TODO comment with issue reference: `// TODO(#123): Replace double assertion with type guard`
+- Document the deferral in your PR/commit description
+- Never silently carry the violation forward
@@ -0,0 +1,15 @@
+## Code Review
+
+If you modify source code, independent code review is REQUIRED before completion.
+Run independent reviews:
+
+```bash
+# Code quality review (Codex)
+~/.config/mosaic/tools/codex/codex-code-review.sh --uncommitted
+
+# Security review (Codex)
+~/.config/mosaic/tools/codex/codex-security-review.sh --uncommitted
+```
+
+**Fallback:** If Codex is unavailable, use Claude's built-in review skills.
+See `~/.config/mosaic/guides/CODE-REVIEW.md` for the full review checklist.
@@ -0,0 +1,11 @@
+## Commits
+
+```
+<type>(#issue): Brief description
+
+Detailed explanation if needed.
+
+Fixes #123
+```
+
+Types: `feat`, `fix`, `docs`, `test`, `refactor`, `chore`
@@ -0,0 +1,19 @@
+## Conditional Documentation Loading
+
+**Load `~/.config/mosaic/guides/E2E-DELIVERY.md` first, then load the relevant guide before starting work:**
+
+| Task Type                                | Guide                                       |
+| ---------------------------------------- | ------------------------------------------- |
+| End-to-end implementation and validation | `~/.config/mosaic/guides/E2E-DELIVERY.md`   |
+| Bootstrapping a new project              | `~/.config/mosaic/guides/BOOTSTRAP.md`      |
+| Orchestrating autonomous tasks           | `~/.config/mosaic/guides/ORCHESTRATOR.md`   |
+| Frontend development                     | `~/.config/mosaic/guides/FRONTEND.md`       |
+| Backend/API development                  | `~/.config/mosaic/guides/BACKEND.md`        |
+| TypeScript strict typing                 | `~/.config/mosaic/guides/TYPESCRIPT.md`     |
+| Code review                              | `~/.config/mosaic/guides/CODE-REVIEW.md`    |
+| Authentication/Authorization             | `~/.config/mosaic/guides/AUTHENTICATION.md` |
+| Infrastructure/DevOps                    | `~/.config/mosaic/guides/INFRASTRUCTURE.md` |
+| QA/Testing                               | `~/.config/mosaic/guides/QA-TESTING.md`     |
+| Secrets management (Vault)               | `~/.config/mosaic/guides/VAULT-SECRETS.md`  |
+| Seat identity / git credentials          | `~/.config/mosaic/guides/SEAT-IDENTITY.md`  |
+| Reaching another agent (fleet comms)     | `~/.config/mosaic/guides/FLEET-COMMS.md`    |
@@ -0,0 +1,7 @@
+## Multi-Agent Coordination
+
+When multiple agents work on this project:
+
+1. `git pull --rebase` before editing
+2. `git pull --rebase` before pushing
+3. If conflicts, **alert the user** — don't auto-resolve data conflicts
@@ -0,0 +1,10 @@
+## Secrets Management
+
+**NEVER hardcode secrets.** Use `.env` files (gitignored) or a secrets manager.
+
+```bash
+# .env.example is committed (with placeholders)
+# .env is NOT committed (contains real values)
+```
+
+Ensure `.gitignore` includes `.env*` (except `.env.example`).