chore: remove redundant agent artifacts + lab artifacts

[mikasenghaas]

Summary

Trim agent-facing scaffolding to the essentials: a single hand-maintained AGENTS.md, with CLAUDE.md reduced to an @AGENTS.md pointer (matching prime-rl). No more generation step.

AGENTS.md — keep only the repo-root file; remove the scoped guides:

• environments/AGENTS.md, tests/AGENTS.md, verifiers/envs/AGENTS.md
• assets/lab/AGENTS.md, assets/lab/environments/AGENTS.md (Prime Lab sources)

Generation removed — AGENTS.md is now canonical and edited directly:

• Delete scripts/sync.py and its sync-agents-md pre-commit hook.
• Delete the now-dead assets/agents/ source fragments (common_, repo_development_, end_user_best_practices.md).
• CLAUDE.md -> @AGENTS.md; docs/v0/development.md guidance updated (no more "run sync.py").

Editor / agent configs:

• .codex/environments/environment.toml (autogenerated Codex sandbox config; already gitignored)
• .cursor/BUGBOT.md

Skills:

• skills/train-with-environments/SKILL.md
• skills/browse-environments/SKILL.md

Breaking

The prime CLI (prime lab setup / prime lab sync) pulls several of these from this repo at a pinned commit (prime_cli/lab_setup.py: VERIFIERS_REF), so shipped CLIs are unaffected. Impact lands only when a future prime release bumps VERIFIERS_REF past this change:

• assets/lab/AGENTS.md and assets/lab/environments/AGENTS.md are fetched by exact URL (AGENTS_MD_SRC / ENVS_AGENTS_MD_SRC) — a bumped ref would 404. Before bumping, update prime_cli/lab_setup.py to stop fetching these (drop the two sources, their writes, and the doctor checks).
• skills/browse-environments and skills/train-with-environments are discovered by enumerating the repo's skills/ tree (SKILL_SOURCES), so removal is graceful — a bumped ref installs two fewer skills, no error.

scripts/sync.py was not consumed by the prime CLI (repo-internal only). assets/lab/CLAUDE.md remains as a static Prime Lab source (no longer generated). sync-docs.yml is unrelated (docs -> public-docs) and untouched.

Verification

• uv run pre-commit run --all-files passes.
• find . -name AGENTS.md (outside .git) returns only ./AGENTS.md.
• No remaining references to scripts/sync.py or assets/agents/ in the repo.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation and contributor tooling only; runtime behavior is unchanged. Prime Lab consumers need a coordinated CLI update before bumping the verifiers pin.

Overview
Replaces the generated agent-doc pipeline with a single hand-edited root AGENTS.md and a CLAUDE.md that only references @AGENTS.md. scripts/sync.py, assets/agents/ source fragments, the sync-agents-md pre-commit hook, and mirrored AGENTS.md files under environments/, tests/, verifiers/envs/, and assets/lab/ are removed.

AGENTS.md is rewritten into short sections (writing/running code, docs, skills, testing), emphasizing v1-only, uv run, and uv run init / uv run eval instead of older prime-centric wording. docs/v0/development.md now tells contributors to edit agent guidance directly rather than run sync.

Also drops .cursor/BUGBOT.md, .codex/environments/environment.toml, and the browse-environments / train-with-environments skills; assets/lab/CLAUDE.md no longer points readers at removed lab AGENTS.md files.

Breaking (on a future Prime CLI ref bump): pinned prime lab fetches for assets/lab/AGENTS.md and assets/lab/environments/AGENTS.md would 404 until prime_cli/lab_setup.py stops requesting them; skill removal is benign (fewer skills installed).

^{Reviewed by Cursor Bugbot for commit c92de04e78f6e3ca57e317bae35da479eb077bbb. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Remove generated agent artifact infrastructure and replace with hand-authored AGENTS.md

• Deletes scripts/sync.py and the modular source files under assets/agents/ that were used to generate AGENTS.md, CLAUDE.md, and related guides.
• Replaces the generated AGENTS.md with a concise, hand-authored guide covering coding, testing, and docs policies; CLAUDE.md is reduced to a single @AGENTS.md reference.
• Removes the sync-agents-md pre-commit hook and updates docs/v0/development.md to reflect that AGENTS.md should now be edited directly.
• Deletes several scattered AGENTS.md files under assets/lab/, environments/, skills/, tests/, and verifiers/envs/.

^{Macroscope summarized 1defa44.}

[macroscopeapp]

Approvability

Verdict: Approved

Removes redundant agent guidance files, documentation artifacts, and the sync script that generated them. Changes affect only documentation and developer tooling with no runtime impact.

^{You can customize Macroscope's approvability policy. Learn more.}