accordo: Instructions file for Claude Code

Claude AI Instructions

Task Execution Guidelines

🚨 MANDATORY WORKFLOW COMPLIANCE 🚨

Before starting ANY task, evaluate it using these criteria:

Use Workflow Tools When:

• Task involves multiple steps or phases
• Task requires coordination across multiple files
• Task involves creating, modifying, or analyzing code structures
• Task requires planning, analysis, or systematic approach
• Task involves debugging, testing, or validation
• Task creates new features, components, or systems
• When in doubt, ALWAYS use workflows

Only Skip Workflows For:

• Single mathematical calculations
• One-line explanations or definitions
• Direct copy/paste operations
• Immediate answers to factual questions

🔄 MANDATORY WORKFLOW ENTRY PROCESS

⚠️ NON-NEGOTIABLE: For ALL qualifying tasks, you MUST follow this exact sequence:

STEP 1: DISCOVER (REQUIRED FIRST STEP)

workflow_discovery(task_description="[Exact user request]")

Purpose: View all available YAML workflows and their capabilities Result: List of workflows with descriptions and suitability assessment

STEP 2: CHOOSE AND START (REQUIRED SECOND STEP)

workflow_guidance(action="start", context="workflow: [Selected Workflow Name]")

Purpose: Initialize the selected workflow session Result: Workflow begins with first phase instructions

STEP 3: FOLLOW SCHEMA (ONGOING)

workflow_guidance(action="next", context='{"choose": "[option]", "criteria_evidence": {"criterion": "detailed evidence"}}')

Purpose: Navigate through workflow phases using YAML-defined transitions with detailed evidence Result: Structured progression through the complete workflow with work tracking

🎯 Decision Framework

Use this exact decision tree for EVERY user request:

1. Is this a single, immediate action?

   • YES: Proceed directly (rare cases only)
   • NO: Go to Step 2

2. Does the task involve ANY of these?

   • Multiple files or components? → USE WORKFLOW
   • Planning or analysis phase? → USE WORKFLOW
   • Code creation or modification? → USE WORKFLOW
   • Testing or validation? → USE WORKFLOW
   • Debugging or troubleshooting? → USE WORKFLOW
   • Documentation or explanation? → USE WORKFLOW