# 🤖 AI Agents Guidelines ## n8n-as-code Context Root This file is generated by `npx --yes n8nac update-ai`. It is bootstrap context only, not a configuration source of truth. - Context root: `/home/Hox/Documentos/comp_autos` - n8n version at generation time: Unknown - n8nac command: `npx --yes n8nac` - n8n-manager command: `npx --yes @n8n-as-code/n8n-manager` - n8n knowledge command: `npx --yes n8nac skills` Run workspace commands from this context root. Do not `cd` into the n8n-as-code source repository, n8n-manager source repository, plugin directory, or package directory to run `npx --yes n8nac workspace ...`, `npx --yes n8nac list`, `npx --yes n8nac pull`, `npx --yes n8nac push`, or `npx --yes n8nac update-ai`. --- ## Required Local Agent A VS Code and GitHub Copilot-compatible agent is generated here: - `.github/agents/n8n-architect.agent.md` A portable skill fallback is also generated for runtimes that do not read `.github/agents`: - `.agents/skills/n8n-architect/SKILL.md` If your agent runtime supports workspace agents, use the `.github/agents/*.agent.md` file. If it supports skills instead, load the skill file. Otherwise, treat these files as mandatory instructions. --- ## Source Of Truth Do not infer configuration from this file. It intentionally avoids storing the effective instance, project, sync folder, or workflow directory. n8nac backend resolution remains the only source of effective workspace state. - Workspace environments live in `n8nac-config.json` and are managed by `npx --yes n8nac env ...`. - Managed local runtime state and secrets live in n8n-manager storage and are managed by `npx --yes @n8n-as-code/n8n-manager ...`. - The effective context is resolved by the backend. Before any n8n workflow command, run migration dry-run first, then workspace status only after migration is not required or has been applied: ```bash cd /home/Hox/Documentos/comp_autos npx --yes n8nac workspace migrate --json npx --yes n8nac workspace status --json ``` Use the returned `workflowsPath` exactly as provided. It is the configured workflow directory for the active environment. Do not reconstruct `workflowsPath` from environment name/id, instance identifier, instance user identifier, project id, project name, or legacy sync fields. --- ## Safe Commands - Primary workspace, environment, sync, validation, push, and pull work: `npx --yes n8nac ...` - Local managed runtime lifecycle and tunnels only: `npx --yes @n8n-as-code/n8n-manager ...` - Workspace status and migration: `npx --yes n8nac workspace ...` - Workflow sync and validation: `npx --yes n8nac ...` - Node knowledge and schema lookup: `npx --yes n8nac skills ...` Never write `n8nac-config.json`, `~/.n8n-manager`, or n8n-manager secret files by hand.