docs: add agent guardrails and make check

Author: rexleimo

AGENTS.md

@@ -0,0 +1,51 @@
+# LoopForge (meos) Agent Notes
+
+These instructions apply to the `meos/` repository.
+
+## Public vs internal docs boundary
+
+- **Public docs** are built only from `docs-site/` (see `mkdocs.yml` `docs_dir: docs-site`).
+- Keep maintainer maps, strategy notes, and competitor references **out** of `docs-site/`.
+- Internal references live under:
+  - `docs/internal/` (start here: `docs/internal/index.md`)
+  - `docs/plans/`
+  - `docs/internal/competitive/`
+
+## Plans and writeups
+
+- Design / decision writeups: `docs/plans/YYYY-MM-DD-<topic>-design.md`
+- Implementation plans: `docs/plans/YYYY-MM-DD-<topic>.md`
+- Prefer small, focused commits; keep behavior changes separate from refactors/docs when possible.
+
+## Verification (evidence before claims)
+
+Before claiming something “works”, “passes”, “is done”, or before pushing a release tag, run fresh verification:
+
+- `make check`
+
+If you can’t use `make`, run the underlying commands:
+
+- `cargo fmt --all --check`
+- `cargo test --workspace --locked`
+- `python3 -m mkdocs build --strict` (when docs change)
+
+## Versioning + changelog rule
+
+If an iteration is marked “needs version bump”, the same change set must include:
+
+- `Cargo.toml` `[workspace.package].version`
+- matching section in `CHANGELOG.md`
+
+The PR/commit is not releasable if only one of them changes.
+
+## Docs toolchain
+
+Docs deps are pinned in `requirements-docs.txt`. Recommended local setup:
+
+- `make docs-venv` (creates `.venv-docs/` and installs deps)
+- `make docs`
+
+## Release preflight (maintainers)
+
+- `loopforge release check --tag vX.Y.Z`
+- Avoid publishing competitor content: release check treats this as a blocker.

Makefile

@@ -0,0 +1,32 @@
+.PHONY: help fmt fmt-check test docs docs-venv check
+
+help:
+	@echo "LoopForge (meos) common targets:"
+	@echo "  make fmt         - cargo fmt"
+	@echo "  make fmt-check   - cargo fmt --check"
+	@echo "  make test        - cargo test (workspace, locked)"
+	@echo "  make docs        - mkdocs build --strict (uses .venv-docs if present)"
+	@echo "  make docs-venv   - create .venv-docs and install docs deps"
+	@echo "  make check       - fmt-check + test + docs"
+
+fmt:
+	cargo fmt --all
+
+fmt-check:
+	cargo fmt --all --check
+
+test:
+	cargo test --workspace --locked
+
+docs:
+	@if [ -x .venv-docs/bin/python ]; then \
+		.venv-docs/bin/python -m mkdocs build --strict; \
+	else \
+		python3 -m mkdocs build --strict; \
+	fi
+
+docs-venv:
+	python3 -m venv .venv-docs
+	.venv-docs/bin/pip install -r requirements-docs.txt
+
+check: fmt-check test docs