agentReagents — Agent Automation Reagents

Reusable scripts, templates, and configurations consumed by coding agents during ecoPrimals development sessions.

Owner: primalSpring (ecoPrimals ecosystem infra) License: AGPL-3.0-or-later

Purpose

Agents working on primals need repeatable patterns for common tasks: auditing compliance, generating handoffs, validating builds, synchronizing docs. Rather than each agent reinventing these, agentReagents provides composable reagents that any agent can pull and execute.

Reagent Categories

audit/

Compliance checking scripts for ecosystem standards.

# Check a primal against ecosystem standards
./audit/check-primal.sh /path/to/primal

# Verify SPDX headers on all .rs files
./audit/check-spdx.sh /path/to/primal

handoff/

Templates and generators for wateringHole handoff documents.

validation/

Build and binary validation helpers (complements benchScale).

sync/

Documentation synchronization — verify metrics match across root docs.

Usage Pattern

Agents pull agentReagents at the start of a session when validation or audit tasks are needed:

cd /path/to/ecoPrimals/infra/agentReagents
git pull --rebase origin main

# Run a reagent
./audit/check-spdx.sh /path/to/primal

Structure

agentReagents/
├── README.md
├── audit/
│   ├── check-primal.sh         # ecosystem standards compliance
│   └── check-spdx.sh           # SPDX header validation
├── handoff/
│   └── handoff-template.md     # wateringHole handoff template
├── validation/
│   └── check-metrics.sh        # doc metric consistency
└── sync/
    └── sync-root-docs.sh       # root doc synchronization helper

See Also

• infra/benchScale/ — cross-architecture binary validation
• infra/plasmidBin/ — binary distribution
• infra/wateringHole/ — ecosystem documentation