nathan-standards

# Nathan Development Standards Standards and patterns for developing within the Nathan project - an n8n-Jira agent automation system. ## When to Use Invoke this skill when: - Creating or modifying n8n workflow JSON files - Writing Python code for the Nathan helpers or templating modules - Designing webhook command contracts - Building workflow registry configurations - Implementing spec-driven features via agent-os ## Project Architecture Nathan follows a layered architecture: ```text External Service (Jira) <-- n8n Workflows <-- Python Agent Service (credentials) (webhook calls) ``` **Core Principle**: n8n owns all external credentials. Python services call n8n webhooks with shared secret authentication. ## n8n Workflow Standards For detailed workflow patterns, load `references/n8n-workflow-patterns.md`. ### Standard Workflow Structure Every webhook workflow must follow this pattern: ```text Webhook --> Validate Secret --> Operation --> Respond to Webhook | | | v v v Unauthorized Error Response Success Response Response (401) (500) (200) ``` ### Required Node Pattern ```json { "id": "validate-secret", "name": "Validate Secret", "type": "n8n-nodes-base.if", "typeVersion": 2, "parameters": { "conditions": { "conditions": [{ "leftValue": "={{ $json.headers['x-n8n-secr...