# Reoclo Agent Recipes
# https://docs.reoclo.com/agents/llms.txt
#
# This file lists machine-readable recipes for AI coding assistants
# integrating Reoclo into CI workflows — External Deployments and Secrets.
# Convention: Recipe: <name> / URL: <url> / Summary: <one line>

Recipe: inject-secrets-in-ci
URL: https://docs.reoclo.com/agents/recipes/inject-secrets-in-ci/
Summary: Replace per-secret CI provider secrets with one automation key plus `reoclo run`, which injects Secrets Manager values into a command as env vars. Note `reoclo run` is a CLI command, NOT the reoclo/run@v2 Action.

Recipe: enhance-github-workflow-for-reoclo
URL: https://docs.reoclo.com/agents/recipes/enhance-github-workflow-for-reoclo/
Summary: Add reoclo/deploy-sync@v2 to an existing workflow that already runs docker compose up or docker run on a Reoclo-managed server.

Recipe: set-up-external-deployment
URL: https://docs.reoclo.com/agents/recipes/set-up-external-deployment/
Summary: Full setup from scratch — generate an API key, wire the GitHub secret, and write the workflow for a repo with no existing Reoclo integration.

Recipe: prepare-deploy-folder
URL: https://docs.reoclo.com/agents/recipes/prepare-deploy-folder/
Summary: Create /srv/reoclo/<app-name>/ with the right reoclo-deploy group + setgid inheritance so reoclo/run@v2 can deploy without chown-after-every-edit friction.

Recipe: diagnose-deployment-failure
URL: https://docs.reoclo.com/agents/recipes/diagnose-deployment-failure/
Summary: Map sync errors (403, 401, 409, 400, per-item not-authorized) to root causes and fixes.

Recipe: interpret-drift-warning
URL: https://docs.reoclo.com/agents/recipes/interpret-drift-warning/
Summary: Explain status: drift_recovered in a sync result and confirm no action is needed (stub — feature ships in a future release).