Resources
Production Best Practices
Team workflows, version pinning, and operational guidelines.
Project-Scoped Installs
Prefer project-scoped installs for teams: apm.yml and apm.lock.yaml make setup reproducible across environments and CI.
Version Pinning
apm install mubaidr/gem-team#v1.20.0 --target copilot
Housekeeping
- Keep
apm_modules/out of git (add to.gitignore). - Run
apm auditbefore releases and in CI. - Review generated files before committing large updates.
Approval-Gated Operations
These require explicit approval before execution:
- Production deployment
- Infrastructure provisioning
- Data migration
- Destructive operations
AGENTS.md vs. Plan Context
| Purpose | Location |
|---|---|
| Stable project rules & conventions | AGENTS.md |
| Task-specific execution context | docs/plan/{plan_id}/ |