@hailer/mcp 1.2.1 → 1.3.9

package/.claude/commands/help:agents.md

@@ -1,182 +0,0 @@
----
-description: Help for working with skills and general-purpose sub-agents
----
-
-# Skills & Roles Help
-
-Display how to work with the skill-based model and general-purpose sub-agents.
-
-## Output
-
-```
-╭─────────────────────────────────────────╮
-│    HAILER MCP - SKILLS & WORKFLOWS      │
-╰─────────────────────────────────────────╯
-
-The new model: General-purpose sub-agents + skills. No named agents.
-Load the right skills for the domain, spawn a sub-agent with them.
-
-HOW IT WORKS:
-
-  1. You ask Claude to do something
-  2. Claude picks the relevant skills for context
-  3. Claude spawns a general-purpose sub-agent with skill instructions
-  4. Sub-agent executes using domain knowledge from skills
-  5. Claude interprets result and reports back
-
-─────────────────────────────────────────────────────────────────────────
-
-SKILL CATALOG:
-
-  Workspace & Config:
-    sdk-ws-config-skill        - Understanding workflows, fields, phases, type generation
-    sdk-function-fields        - Creating calculated fields
-    sdk-activity-patterns      - Creating/updating activities
-    sdk-insight-queries        - Writing insight queries
-    sdk-document-templates     - Creating PDF/CSV templates
-
-  App Development:
-    hailer-app-builder         - Building Hailer apps (React/Chakra)
-    hailer-design-system       - Theme, colors, icons, components, UI/UX patterns
-    hailer-apps-pictures       - Working with images in apps
-    publish-hailer-app         - Publishing to production
-    hailer-api-client          - Making REST API calls
-
-  Integrations:
-    hailer-monolith-automations - Webhook handlers, scheduled jobs, phase cascade bots
-    zapier-hailer-patterns      - Zapier integrations
-    integration-patterns        - General integration patterns
-    hailer-api-client           - Using HailerApiClient
-
-  Testing & Quality:
-    testing-patterns           - vitest/playwright patterns
-    lsp-setup                  - Code inspection tools
-    api-documentation-patterns - API endpoint documentation
-    tool-builder               - Building MCP tools
-
-  Error Handling:
-    tool-parameter-usage       - MCP validation errors
-    tool-response-verification - Tool failures
-    optional-parameters        - Optional param errors
-    json-only-output          - JSON formatting issues
-
-─────────────────────────────────────────────────────────────────────────
-
-ROLE-BASED WORKFLOWS:
-
-  Data Operations:
-    • Data Reader       - Read workflows, fields, activities (LOCAL FIRST)
-    • Activity Writer   - Create/update activities
-    • Data Analyzer     - Query patterns, anomalies, analysis
-    • Access Controller - Manage app access
-
-  Configuration:
-    • Workflow Config   - Manage workflows, fields, phases
-    • Function Fields   - Calculated fields + nameFunction
-    • SQL Insights      - SQL-like reports
-    • Template Designer - PDF/CSV document templates
-
-  Development:
-    • App Builder       - Build Hailer apps (production)
-    • UI Designer       - Design specs (layout, components)
-    • Code Builder      - Build MCP tools, backends
-    • Activity Mover    - Phase cascade microservices
-    • Automation Builder - Webhooks, scheduled jobs
-
-  Quality:
-    • Code Reviewer     - Code review, security
-    • Test Runner       - Run tests, verify builds
-    • Code Inspector    - Find dead code, type errors
-    • Config Auditor    - Audit configuration
-    • Code Simplifier   - Refactor for clarity
-
-  Meta:
-    • Skill Builder     - Create skills from patterns
-    • Documentation Generator - API endpoint docs
-    • Publisher         - Publish to marketplace
-    • Reviewer          - PR review
-
-─────────────────────────────────────────────────────────────────────────
-
-COMMON WORKFLOWS:
-
-  Add a field:
-    Data Reader (get IDs) → Workflow Config (create field) → (push)
-    → Data Reader (verify)
-
-  Create an activity:
-    Data Reader (get schema) → Activity Writer (create)
-
-  Build an app:
-    Data Reader (discover schema) → UI Designer (design spec)
-    → App Builder (build) → Test Runner (verify)
-
-  Create a report:
-    Data Reader (get schema) → Function Fields (if needed)
-    → SQL Insights (build queries)
-
-  Review code:
-    Code Reviewer (find issues) → Code Fixer (fix) → Code Reviewer (verify)
-
-─────────────────────────────────────────────────────────────────────────
-
-HOW TO SPAWN SUB-AGENTS:
-
-  With skills:
-    Task(prompt="Load <skill-name> for understanding the domain.
-    
-    Your mission: [detailed task description]")
-
-  Multiple skills:
-    Task(prompt="Load <skill-1> and <skill-2> skills.
-    
-    Your mission: [detailed task description]")
-
-  Example:
-    Task(prompt="Load sdk-ws-config-skill for workspace understanding.
-    
-    List all workflows and their fields for the Customer workflow.")
-
-─────────────────────────────────────────────────────────────────────────
-
-DATA OPERATION RULES:
-
-  Read First: Always check workspace/ before API calls
-    - workflow/ directory has all structural data (IDs, field types, phases)
-    - API only needed for live activity data, counts, discussion messages
-
-  Refresh Often: `npm run pull` updates workspace/ from Hailer
-    - After pushing new config, pull to get new IDs
-    - Between pipeline steps
-
-  ID Format: Field IDs, workflow IDs, phase IDs come from workspace/
-    - Never guess IDs - always read them from workspace/ files
-    - Always verify types match before using in code
-
-  Activity Updates: Use correct wrapper format
-    - Correct: `{type: "string", value: "x"}`
-    - Wrong: Raw value `"x"`
-
-─────────────────────────────────────────────────────────────────────────
-
-SQUAD WORKFLOWS:
-
-  Pre-built multi-step orchestrations:
-    /app-squad         - Build apps end-to-end
-    /review-squad      - Code review + auto-fix
-    /config-squad      - Workflow config + functions + insights
-    /hotfix-squad      - Test → fix → security review
-    /debug-squad       - Parallel investigation
-    /crud-squad        - Schema discovery → CRUD → verify
-    /data-squad        - Build reports (discover → functions → insights)
-
-  Large-scale parallel:
-    /swarm <desc>      - Auto-select roles, split work across workers
-
-─────────────────────────────────────────────────────────────────────────
-
-SEE ALSO:
-  /stats         - Task statistics
-  /help:skills   - Skill details
-  /help:commands - All commands
-```

package/.claude/commands/help:commands.md

@@ -1,78 +0,0 @@
----
-description: All slash commands for Hailer MCP
----
-
-# Commands Reference
-
-Display all available commands to the user.
-
-## Output
-
-```
-╭─────────────────────────────────────────╮
-│       HAILER MCP - ALL COMMANDS         │
-╰─────────────────────────────────────────╯
-
-HELP SYSTEM
-  /help               Show all help topics
-  /help:agents        Agent usage, relationships, tool access
-  /help:commands      This reference
-  /help:plugins       Plugin system guide
-  /help:tools         MCP tools reference
-  /help:faq           Common questions
-
-PLUGINS
-  /marketplace-setup       Clone/update marketplace repo
-  /list-plugins            List available plugins
-  /install-plugin <name>   Install a plugin
-  /uninstall-plugin <name> Remove a plugin
-  /publish-plugin          Publish to marketplace
-  /publish                 Publish (alias)
-  /version-check           Show out-of-sync plugins
-
-WORKSPACE
-  /ws-pull           Pull workspace config from Hailer (read-only)
-
-DEVELOPMENT
-  /tool-builder      Enter MCP tool building mode
-  /stats             View agent usage statistics
-  /stats recent      Show last 20 agent calls
-  /health            Run project health check
-
-PLANNING
-  /autoplan <desc>       Quick project planning with PRDs
-  /plan-workspace <desc> Thorough workspace discovery (10 phases)
-  /prd <feature>         Create PRD for a feature
-  /project-status        Sync DEVELOPMENT.md with PRD statuses
-
-SQUADS (multi-agent commands)
-  /review-squad [files]    Parallel+Loop: Code Reviewer + LSP Inspector + Test Runner + Code Editor
-  /cleanup-squad [files]   Parallel: Config Auditor + Code Simplifier + LSP Inspector
-  /app-squad <desc>        Pipeline+Loop: Data Reader → UI Designer → App Builder → Test Runner (build verify)
-  /config-squad <desc>     Pipeline: Workflow Config → Function Fields → SQL Insights
-  /crud-squad <desc>       Pipeline: Data Reader → Activity Writer → Data Reader (verify)
-  /data-squad <desc>       Pipeline: Data Reader → Function Fields → SQL Insights
-  /integration-squad <desc> Pipeline: Data Reader → Monolith Automations → Test Runner
-  /doc-squad <desc>        Pipeline: LSP Inspector → API Documenter
-  /hotfix-squad <desc>     Pipeline+Loop: Test Runner → Code Editor → Code Reviewer (max 3 iter)
-  /debug-squad <desc>      Parallel+Loop: Data Reader + SQL Insights + Code Reviewer + Test Runner (--debate for competing hypotheses)
-  /audit-squad             Parallel: Code Reviewer + Permissions Auditor + Tool Security Auditor (security audit)
-  /onboard-squad <desc>    Pipeline+Loop: Workflow Config → Function Fields → App Builder → Config Auditor (bootstrap)
-  /janitor-squad           Parallel+Loop: LSP Inspector + Config Auditor + SQL Insights → Code Editor (cleanup)
-  /swarm <desc>            Swarm: orchestrator picks agents, splits work, dispatches parallel workers
-
-SESSION
-  /recap [focus]     Resume session - load handoff, status, learnings
-  /save <message>    Save changes to git (local commit)
-  /restore           Restore to a previous save point
-  /handoff           Create session handoff for next session
-  /learn <cat> <desc> Capture learning and apply fix (cat: skill/X, pattern, bug, gotcha)
-
-───────────────────────────────────────────
-Examples:
-  /plan-workspace "CRM system"  Thorough discovery for new project
-  /autoplan "Add invoicing"     Quick planning for feature
-  /prd "customer portal"        Create PRD for feature
-  /save "Add customer form"     Local git commit
-  /learn skill/data-reader "Check enums first"
-```

package/.claude/commands/help:faq.md

@@ -1,79 +0,0 @@
----
-description: Frequently asked questions for Hailer MCP
----
-
-# FAQ
-
-Display frequently asked questions to the user.
-
-## Output
-
-```
-╭─────────────────────────────────────────╮
-│     HAILER MCP - FAQ                    │
-╰─────────────────────────────────────────╯
-
-Q: Why is Claude failing at Hailer tasks?
-A: Check two things:
-   1. Run /mcp-list to verify Claude is connected to the Hailer MCP
-   2. Make sure you're running Claude from the correct project folder
-      (the one with CLAUDE.md and .claude/ folder)
-
-Q: Why do I need to restart Claude Code after installing a plugin?
-A: Claude Code reloads configuration at startup. New skills and hooks
-   won't be active until restart. Use 'claude -c' to keep context.
-
-Q: What's the difference between /plugin install and /install-plugin?
-A: /plugin install - Claude's built-in plugin system (global)
-   /install-plugin - Our local marketplace system (per-project)
-
-Q: Can I create my own skills?
-A: Yes! Add a SKILL.md file to .claude/skills/<name>/ following the
-   skill structure. See existing skills for examples.
-
-Q: How do I publish my skill or hook to the marketplace?
-A: Use /publish-plugin. It creates a PR that gets reviewed.
-   See /help plugins for details.
-
-Q: Why does Claude spawn sub-agents instead of doing work directly?
-A: Sub-agents with focused skills produce better results for domain-
-   specific tasks by loading only the relevant context.
-
-Q: What happens if a sub-agent fails?
-A: The orchestrator receives an error and reports the failure.
-   It should identify root cause and fix it, never apply bandaids.
-
-Q: How does Claude decide which skills to use?
-A: Check the skill catalog in CLAUDE.md. Skills are loaded based on
-   the task domain (workspace config, app building, testing, etc.).
-
-Q: Can I use MCP tools directly without agents?
-A: Yes! Tools like list_workflows, create_activity, etc. are
-   available directly. Agents just provide structured workflows.
-
-Q: Where is configuration stored?
-A: - Skills: .claude/skills/
-   - Hooks: .claude/hooks/
-   - Commands: .claude/commands/
-   - Settings: .claude/settings.json
-   - Instructions: CLAUDE.md
-
-Q: How do I update an installed plugin?
-A: Uninstall and reinstall:
-   /uninstall-plugin <name>
-   /install-plugin <name>
-
-Q: What's the difference between /autoplan and /plan-workspace?
-A: /autoplan - Quick planning, creates DEVELOPMENT.md + PRDs
-   /plan-workspace - Thorough 10-phase discovery for complex workspaces
-   Use /autoplan for features, /plan-workspace for new projects.
-
-Q: How do PRDs and DEVELOPMENT.md work together?
-A: DEVELOPMENT.md is the big picture (roadmap, status, decisions).
-   PRDs (docs/prd-*.md) are detailed requirements for each feature.
-   DEVELOPMENT.md roadmap links to individual PRDs.
-
-MORE HELP:
-  /help plugins  - Plugin system
-  /help agents   - Agent usage
-```

package/.claude/commands/help:plugins.md

@@ -1,50 +0,0 @@
----
-description: Plugin system help for Hailer MCP
----
-
-# Plugin System Help
-
-Display plugin system instructions to the user.
-
-## Output
-
-```
-HAILER MCP - PLUGIN SYSTEM
-
-The plugin system lets you install community agents from the marketplace.
-
-COMMANDS:
-
-  /marketplace-setup
-    Clone or pull the marketplace repo to ./hailer-marketplace
-    Only needed once. Commands will prompt you if missing.
-
-  /list-plugins
-    List all available plugins (auto-pulls latest).
-
-  /install-plugin <name>
-    Install a plugin to .claude/ folder.
-    Example: /install-plugin my-custom-plugin
-
-  /uninstall-plugin <name>
-    Remove a plugin from .claude/ folder.
-
-  /publish-plugin
-    Publish your plugin to marketplace (creates PR).
-
-PLUGIN TYPES:
-
-  Agents   AI specialists (.claude/agents/)
-  Skills   On-demand docs (.claude/skills/)
-  Hooks    Event scripts (.claude/hooks/)
-
-WORKFLOW:
-
-  1. /list-plugins            # See what's available
-  2. /install-plugin <name>   # Install what you need
-  3. Restart: claude -c       # Load new agents
-
-SEE ALSO:
-  /help agents   - How to use installed agents
-  /help faq      - Common questions
-```

package/.claude/commands/help:skills.md

@@ -1,87 +0,0 @@
----
-description: Skills reference for Hailer MCP
----
-
-# Skills Reference
-
-Display skills reference to the user.
-
-## Output
-
-```
-╭─────────────────────────────────────────╮
-│     HAILER MCP - SKILLS REFERENCE       │
-╰─────────────────────────────────────────╯
-
-Skills are reusable knowledge files (.claude/skills/<name>/SKILL.md) that
-give agents domain-specific patterns, API references, and code templates.
-
-HOW SKILLS WORK:
-
-  Auto-injected: Agents declare skills in their frontmatter. The
-  SubagentStart hook injects them automatically when the agent spawns.
-
-  On-demand: The orchestrator tells an agent to load a skill via the
-  Skill tool. Load skills before spawning sub-agents or doing domain-specific work.
-
-─────────────────────────────────────────────────────────────────────────
-
-SDK SKILLS (core patterns):
-  sdk-activity-patterns    - Field value formats, dates, users, links
-  sdk-document-templates   - PDF/CSV template structure + generation
-  sdk-function-fields      - Calculated fields in Hailer workflows
-  sdk-insight-queries      - SQL query patterns for insights, cross-workflow JOINs
-  sdk-ws-config-skill      - Workflow config: fields, phases, schemas, type generation, project setup
-
-HAILER PLATFORM SKILLS:
-  hailer-api-client        - @hailer/cli auth, requests, signals, direct HTTP API endpoints
-  hailer-app-builder       - Build apps with @hailer/app-sdk
-  hailer-apps-pictures     - Fetch and display images from Hailer
-  hailer-design-system     - Chakra UI theme, colors, icons, components, UI/UX patterns
-  hailer-monolith-automations - Webhooks, scheduled jobs in monolith, phase cascade bots
-  hailer-permissions-system - Users, teams, access control
-  hailer-project-protocol  - Full SDK workflow reference
-
-INTEGRATION SKILLS:
-  integration-patterns     - Activity movers, webhooks, SCIM, Kafka
-  zapier-hailer-patterns   - Zapier triggers, actions, Zap configs
-TOOL & AGENT SKILLS:
-  agent-structure          - Template for creating new agents
-  delegation-routing       - Full routing table + chaining patterns
-  tool-builder             - Building MCP tools for Hailer server
-  mcp-direct-tools         - MCP tools not assigned to agents
-
-QUALITY & FIX SKILLS (auto-loaded on errors):
-  tool-parameter-usage     - Extract IDs, correct parameter formats
-  tool-response-verification - Verify MCP results before reporting
-  optional-parameters      - Omit optional params vs empty values
-  json-only-output         - Fix agents adding prose after JSON
-  testing-patterns         - vitest, playwright, build verification
-
-REFERENCE SKILLS:
-  api-documentation-patterns - API endpoint documentation standards
-  chrome-mcp-reference     - Browser automation reference
-  lsp-setup                - Language Server Protocol setup
-  publish-hailer-app       - App publishing to production
-
-─────────────────────────────────────────────────────────────────────────
-
-ON-DEMAND SKILL LOADING:
-
-  Tell the orchestrator which skill a sub-agent needs:
-  "Load hailer-apps-pictures for the app builder sub-agent"
-  → Sub-agent gets image handling patterns
-
-  "Load sdk-insight-queries for this SQL query"
-  → Sub-agent gets insight patterns including JOIN syntax for cross-workflow data
-
-  Skill content is loaded by the orchestrator and pasted directly
-  into the sub-agent prompt — agents never load skills themselves.
-
-─────────────────────────────────────────────────────────────────────────
-
-SEE ALSO:
-  /help agents   - Which agents use which skills
-  /help commands - All slash commands
-  /help tools    - MCP tools reference
-```

package/.claude/commands/help:tools.md

@@ -1,75 +0,0 @@
----
-description: MCP tools reference for Hailer MCP
----
-
-# MCP Tools Reference
-
-Display MCP tools reference to the user.
-
-## Output
-
-```
-╭─────────────────────────────────────────╮
-│      HAILER MCP - TOOLS REFERENCE       │
-╰─────────────────────────────────────────╯
-
-MCP tools provide direct access to Hailer APIs. These are used by
-agents but can also be called directly.
-
-WORKFLOW TOOLS:
-  list_workflows          - List all workflows in workspace
-  list_workflows_minimal  - Compact workflow list with counts
-  list_workflow_phases    - Get phases for a workflow
-  get_workflow_schema     - Get field definitions for a workflow
-  install_workflow        - Create workflow from template
-
-ACTIVITY TOOLS:
-  list_activities         - List activities in a workflow phase
-  show_activity_by_id     - Get single activity details
-  create_activity         - Create new activity (single or bulk)
-  update_activity         - Update activity (single or bulk)
-  count_activities        - Count activities in workflow
-
-DISCUSSION TOOLS:
-  list_my_discussions        - List discussions you're in
-  fetch_discussion_messages  - Read messages from discussion
-  add_discussion_message     - Post to a discussion
-  join_discussion            - Join a discussion
-  leave_discussion           - Leave a discussion
-  invite_discussion_members  - Invite users to discussion
-
-INSIGHT TOOLS:
-  list_insights      - List all insights
-  create_insight     - Create SQL-like insight
-  preview_insight    - Test insight query
-  get_insight_data   - Execute insight and get results
-  update_insight     - Modify existing insight
-
-APP TOOLS:
-  list_apps              - List apps in workspace
-  create_app             - Create app entry
-  update_app             - Update app properties
-  scaffold_hailer_app    - Generate app from template
-  publish_hailer_app     - Deploy app to production
-
-FILE TOOLS:
-  upload_files     - Upload files to Hailer
-  download_file    - Download file from Hailer
-
-USER TOOLS:
-  search_workspace_users - Find users by name
-
-TEMPLATE TOOLS:
-  list_templates     - List marketplace templates
-  get_template       - Get template details
-  install_template   - Install template to workspace
-  publish_template   - Publish workspace as template
-
-USAGE:
-  Tools are called via the MCP protocol. The orchestrator and
-  agents use them automatically based on your requests.
-
-SEE ALSO:
-  /help agents   - How agents use these tools
-  /help commands - Slash commands available
-```

package/.claude/commands/hotfix-squad.md

@@ -1,112 +0,0 @@
----
-description: Quick bug fix with test creation, code editing, and security review
-argument-hint: "bug description"
-allowed-tools: Task, Bash
----
-# Hotfix Squad
-
-Sequential pipeline with iterative loop: Reproduce bug, apply fix, verify, review. Loops back if review fails.
-
-**Roles:**
-1. **Test Runner** - Test runner (create failing test, verify fix)
-2. **Code Editor** - Code editor (apply minimal fix)
-3. **Code Reviewer** - Code review (security audit of the fix)
-
-**Goal:** $ARGUMENTS
-
-## Protocol
-
-### Step 1: Reproduce Bug
-
-Spawn a test runner to create a test that demonstrates the bug:
-
-```
-Task(prompt="Load testing-patterns skill for writing focused tests.\n\nCreate a test that reproduces this bug: $ARGUMENTS.\n\nThe test should:\n- Fail with the current code (red)\n- Clearly demonstrate the bug\n- Be minimal and focused\n\nDo NOT fix the bug yet. Just create the failing test and report the failure.")
-```
-
-Wait for result. The test should be failing (RED state).
-
-### Step 2: Fix-Verify-Review Loop
-
-Track iteration count. Max **3 iterations** before escalating to user with remaining issues.
-
-**Set:** `iteration = 1`
-
-#### Step 2a: Apply Fix
-
-Spawn a code editor with accumulated context from all previous iterations:
-
-```
-Task(prompt="Fix the bug in: $ARGUMENTS.\n\nContext:\nTest runner created a failing test that reproduces the bug:\n[PASTE TEST CODE AND FAILURE OUTPUT]\n\n[IF iteration > 1: Include ALL accumulated feedback:\n- Test runner's latest test results (pass/fail details)\n- Code Reviewer's feedback (if review was reached in previous iteration)\n- What was already tried and why it didn't fully work\nThis prevents repeating previous mistakes.]\n\nMake the MINIMAL change needed to make the test pass (GREEN state). Do not refactor or improve surrounding code.")
-```
-
-#### Step 2b: Verify Fix
-
-Run the test to confirm the fix works:
-
-```
-Task(prompt="Load testing-patterns skill for test execution.\n\nRe-run the test for: $ARGUMENTS. Confirm it now passes with the code editor's fix. Also run any related tests to check for regressions.")
-```
-
-If tests FAIL:
-- If `iteration < 3`: increment iteration, go back to **Step 2a** with the test failure output
-- If `iteration >= 3`: escalate to user (see Step 3)
-
-#### Step 2c: Security Review
-
-Tests passed. Spawn a code reviewer to audit the fix:
-
-```
-Task(prompt="Security review of the hotfix for: $ARGUMENTS.\n\nFix applied by code editor:\n[PASTE CODE EDITOR'S CHANGES]\n\nIteration: [iteration] of 3\n\nCheck for:\n- Security vulnerabilities\n- Data validation issues\n- Authentication/authorization concerns\n- Edge cases that could be exploited\n\nReturn verdict: APPROVED or REQUEST_CHANGES with specific issues to fix.")
-```
-
-**If APPROVED:** proceed to Step 3 (report).
-
-**If REQUEST_CHANGES:**
-- If `iteration < 3`: increment iteration, go back to **Step 2a** with Code Reviewer's feedback
-- If `iteration >= 3`: escalate to user (see Step 3)
-
-### Step 3: Report
-
-```markdown
-## Hotfix Squad Complete
-
-### Loop Summary
-- Iterations: [count] of 3 max
-- Final status: FIXED / ESCALATED
-
-### Test Runner
-- Bug reproduced: YES
-- Test status before fix: FAILED
-- Test status after fix: PASSED / STILL FAILING
-- Regressions found: [yes/no]
-
-### Code Editor
-- Files modified: [list]
-- Lines changed: [count]
-- Approach: [brief description]
-
-### Code Reviewer
-- Verdict: APPROVED / REQUEST_CHANGES
-- Critical issues: [count]
-- Warnings: [count]
-- [If REQUEST_CHANGES: list remaining issues]
-
-### Next Steps
-[If FIXED:]
-- Deploy to staging
-- Monitor error logs
-
-[If ESCALATED after 3 iterations:]
-- Manual intervention needed
-- Remaining issues: [list from security reviewer/test runner]
-- Attempted fixes: [summary of what was tried]
-```
-
-## Notes
-
-- RED -> GREEN -> REVIEW loop ensures quality
-- Fix must be minimal - no refactoring
-- Max 3 iterations prevents infinite loops
-- Each iteration passes previous feedback to the code editor so it doesn't repeat mistakes
-- Security check is mandatory before reporting success