How njm04/engineering-agents works
engineering-agents is a reusable toolkit for distributing engineering-agent instructions, standards, and platform-specific agent definitions into other repositories. The main workflow is install or sync: a user selects or detects an adapter, then the deployment engine prepares and writes the package-owned files while preserving protected project files. Separate capabilities generate this repository’s Codex agents and validate its canonical content and generated output. The graph follows the README and sampled scripts; unsampled content is represented at its exact directory level.
Main entry points: deployment.ts Deployment engine · validate.ts Repository validation · setup-repo.ts Local Codex setup · install.ts Install command
Components 14
Reusable guidance
- Agent roles
agents - Engineering standards
standards - Base templates
templates
Platform adapters
- Codex templates
adapters/codex - Copilot templates
adapters/copilot
Deployment
- Install command
scripts/install.ts - Sync command
scripts/sync.ts - Deployment engine
scripts/deployment.ts - Installed guidance and agents
Repository maintenance
- Local Codex setup
scripts/setup-repo.ts - Generated Codex agents
.codex/agents - Repository validation
scripts/validate.ts
Other components
- Project maintainer
- Target repository
Connections 16
- Project maintainer → Install command: installs into
README.md - Project maintainer → Sync command: updates in
README.md - Install command → Deployment engine: calls
scripts/install.ts - Sync command → Deployment engine: calls
scripts/sync.ts - Deployment engine → Agent roles: reads
scripts/deployment.ts - Deployment engine → Engineering standards: copies
scripts/deployment.ts - Deployment engine → Base templates: reads
scripts/deployment.ts - Deployment engine → Codex templates: renders from
scripts/deployment.ts - Deployment engine → Copilot templates: renders from
scripts/deployment.ts - Deployment engine → Target repository: writes to
scripts/deployment.ts - Deployment engine → Installed guidance and agents: deploys
README.md - Local Codex setup → Generated Codex agents: regenerates
scripts/setup-repo.ts - Local Codex setup → Deployment engine: uses generator
scripts/setup-repo.ts - Repository validation → Deployment engine: checks generated output
scripts/validate.ts - Repository validation → Agent roles: validates roles
scripts/validate.ts - Repository validation → Generated Codex agents: checks drift
scripts/validate.ts