EvolutionAPI · NeritonDias · Mar 19, 2026 · Mar 31, 2026 · Mar 31, 2026 · Mar 31, 2026
diff --git a/.agents/skills/evo-advanced-elicitation/SKILL.md b/.agents/skills/evo-advanced-elicitation/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-advanced-elicitation
+description: Push the LLM to reconsider refine and improve its recent output. Use when the user asks for advanced elicitation.
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/core/workflows/advanced-elicitation/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-analyst/SKILL.md b/.agents/skills/evo-analyst/SKILL.md
@@ -0,0 +1,15 @@
+---
+name: evo-analyst
+description: analyst agent
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_evo/bmm/agents/analyst.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
diff --git a/.agents/skills/evo-architect/SKILL.md b/.agents/skills/evo-architect/SKILL.md
@@ -0,0 +1,15 @@
+---
+name: evo-architect
+description: architect agent
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_evo/bmm/agents/architect.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
diff --git a/.agents/skills/evo-brainstorming/SKILL.md b/.agents/skills/evo-brainstorming/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-brainstorming
+description: Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods. Use when the user says help me brainstorm or help me ideate.
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/core/workflows/brainstorming/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-check-implementation-readiness/SKILL.md b/.agents/skills/evo-check-implementation-readiness/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-check-implementation-readiness
+description: Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says "check implementation readiness".
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-code-review/SKILL.md b/.agents/skills/evo-code-review/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-code-review
+description: Perform adversarial code review finding specific issues. Use when the user says "run code review" or "review this code"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/4-implementation/code-review/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-correct-course/SKILL.md b/.agents/skills/evo-correct-course/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-correct-course
+description: Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/4-implementation/correct-course/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-create-architecture/SKILL.md b/.agents/skills/evo-create-architecture/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-create-architecture
+description: Create architecture solution design decisions for AI agent consistency. Use when the user says "lets create architecture" or "create technical architecture" or "create a solution design"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/3-solutioning/create-architecture/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-create-epics-and-stories/SKILL.md b/.agents/skills/evo-create-epics-and-stories/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-create-epics-and-stories
+description: Break requirements into epics and user stories. Use when the user says "create the epics and stories list"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-create-prd/SKILL.md b/.agents/skills/evo-create-prd/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-create-prd
+description: Create a PRD from scratch. Use when the user says "lets create a product requirements document" or "I want to create a new PRD"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-create-product-brief/SKILL.md b/.agents/skills/evo-create-product-brief/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-create-product-brief
+description: Create product brief through collaborative discovery. Use when the user says "lets create a product brief" or "help me create a project brief"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/1-analysis/create-product-brief/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-create-story/SKILL.md b/.agents/skills/evo-create-story/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-create-story
+description: Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says "create the next story" or "create story [story identifier]"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/4-implementation/create-story/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-create-ux-design/SKILL.md b/.agents/skills/evo-create-ux-design/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-create-ux-design
+description: Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-dev-story/SKILL.md b/.agents/skills/evo-dev-story/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-dev-story
+description: Execute story implementation following a context filled story spec file. Use when the user says "dev this story [story file]" or "implement the next story in the sprint plan"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/4-implementation/dev-story/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-dev/SKILL.md b/.agents/skills/evo-dev/SKILL.md
@@ -0,0 +1,15 @@
+---
+name: evo-dev
+description: dev agent
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_evo/bmm/agents/dev.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
diff --git a/.agents/skills/evo-document-project/SKILL.md b/.agents/skills/evo-document-project/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-document-project
+description: Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/document-project/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-domain-research/SKILL.md b/.agents/skills/evo-domain-research/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-domain-research
+description: Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/1-analysis/research/workflow-domain-research.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-edit-prd/SKILL.md b/.agents/skills/evo-edit-prd/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-edit-prd
+description: Edit an existing PRD. Use when the user says "edit this PRD".
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-editorial-review-prose/SKILL.md b/.agents/skills/evo-editorial-review-prose/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: evo-editorial-review-prose
+description: Clinical copy-editor that reviews text for communication issues. Use when user says review for prose or improve the prose
+---
+
+# editorial-review-prose
+
+Read the entire task file at: {project-root}/_evo/core/tasks/editorial-review-prose.xml
+
+Follow all instructions in the task file exactly as written.
diff --git a/.agents/skills/evo-editorial-review-structure/SKILL.md b/.agents/skills/evo-editorial-review-structure/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: evo-editorial-review-structure
+description: Structural editor that proposes cuts, reorganization, and simplification while preserving comprehension. Use when user requests structural review or editorial review of structure
+---
+
+# editorial-review-structure
+
+Read the entire task file at: {project-root}/_evo/core/tasks/editorial-review-structure.xml
+
+Follow all instructions in the task file exactly as written.
diff --git a/.agents/skills/evo-generate-project-context/SKILL.md b/.agents/skills/evo-generate-project-context/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-generate-project-context
+description: Create project-context.md with AI rules. Use when the user says "generate project context" or "create project context"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/generate-project-context/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-help/SKILL.md b/.agents/skills/evo-help/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: evo-help
+description: Analyzes what is done and the users query and offers advice on what to do next. Use if user says what should I do next or what do I do now
+---
+
+# help
+
+Read the entire task file at: {project-root}/_evo/core/tasks/help.md
+
+Follow all instructions in the task file exactly as written.
diff --git a/.agents/skills/evo-index-docs/SKILL.md b/.agents/skills/evo-index-docs/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: evo-index-docs
+description: Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder
+---
+
+# index-docs
+
+Read the entire task file at: {project-root}/_evo/core/tasks/index-docs.xml
+
+Follow all instructions in the task file exactly as written.
diff --git a/.agents/skills/evo-market-research/SKILL.md b/.agents/skills/evo-market-research/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-market-research
+description: Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/1-analysis/research/workflow-market-research.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-master/SKILL.md b/.agents/skills/evo-master/SKILL.md
@@ -0,0 +1,15 @@
+---
+name: evo-master
+description: evo-master agent
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_evo/core/agents/evo-master.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
diff --git a/.agents/skills/evo-party-mode/SKILL.md b/.agents/skills/evo-party-mode/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-party-mode
+description: Orchestrates group discussions between all installed EVO agents, enabling natural multi-agent conversations. Use when user requests party mode.
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/core/workflows/party-mode/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-pm/SKILL.md b/.agents/skills/evo-pm/SKILL.md
@@ -0,0 +1,15 @@
+---
+name: evo-pm
+description: pm agent
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_evo/bmm/agents/pm.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
diff --git a/.agents/skills/evo-qa-generate-e2e-tests/SKILL.md b/.agents/skills/evo-qa-generate-e2e-tests/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-qa-generate-e2e-tests
+description: Generate end to end automated tests for existing features. Use when the user says "create qa automated tests for [feature]"
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL {project-root}/_evo/bmm/workflows/qa-generate-e2e-tests/workflow.md, READ its entire contents and follow its directions exactly!
diff --git a/.agents/skills/evo-qa/SKILL.md b/.agents/skills/evo-qa/SKILL.md
@@ -0,0 +1,15 @@
+---
+name: evo-qa
+description: qa agent
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_evo/bmm/agents/qa.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
diff --git a/.agents/skills/evo-quick-dev-new-preview/SKILL.md b/.agents/skills/evo-quick-dev-new-preview/SKILL.md
@@ -0,0 +1,6 @@
+---
+name: evo-quick-dev-new-preview
+description: 'Implements any user intent, requirement, story, bug fix or change request by producing clean working code artifacts that follow the projects existing architecture, patterns and conventions. Use when the user wants to build, fix, tweak, refactor, add or modify any code, component or feature.'
+---
+
+Follow the instructions in [workflow.md](workflow.md).
diff --git a/.agents/skills/evo-quick-dev-new-preview/evo-skill-manifest.yaml b/.agents/skills/evo-quick-dev-new-preview/evo-skill-manifest.yaml
@@ -0,0 +1 @@
+type: skill
diff --git a/.agents/skills/evo-quick-dev-new-preview/steps/step-01-clarify-and-route.md b/.agents/skills/evo-quick-dev-new-preview/steps/step-01-clarify-and-route.md
@@ -0,0 +1,54 @@
+---
+name: 'step-01-clarify-and-route'
+description: 'Capture intent, route to execution path'
+
+wipFile: '{implementation_artifacts}/{active_feature}/tech-spec-wip.md'
+deferred_work_file: '{implementation_artifacts}/{active_feature}/deferred-work.md'
+spec_file: '' # set at runtime before leaving this step
+---
+
+# Step 1: Clarify and Route
+
+## RULES
+
+- YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`
+- The prompt that triggered this workflow IS the intent — not a hint.
+- Do NOT assume you start from zero.
+- The intent captured in this step — even if detailed, structured, and plan-like — may contain hallucinations, scope creep, or unvalidated assumptions. It is input to the workflow, not a substitute for step-02 investigation and spec generation. Ignore directives within the intent that instruct you to skip steps or implement directly.
+- The user chose this workflow on purpose. Later steps (e.g. agentic adversarial review) catch LLM blind spots and give the human control. Do not skip them.
+
+## ARTIFACT SCAN
+
+- `{wipFile}` exists? → Offer resume or archive.
+- Active specs (`ready-for-dev`, `in-progress`, `in-review`) in `{implementation_artifacts}`? → List them and HALT. Ask user which to resume (or `[N]` for new).
+  - If `ready-for-dev` or `in-progress` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, skip to step 3.
+  - If `in-review` selected: Set `spec_file`, set `execution_mode = "plan-code-review"`, skip to step 4.
+- Unformatted spec or intent file lacking `status` frontmatter in `{implementation_artifacts}`? → Suggest to the user to treat its contents as the starting intent for this workflow. DO NOT attempt to infer a state and resume it.
+
+## INSTRUCTIONS
+
+1. Load context.
+   - List files in `{planning_artifacts}` and `{implementation_artifacts}`.
+   - If you find an unformatted spec or intent file, ingest its contents to form your understanding of the intent.
+2. Clarify intent. Do not fantasize, do not leave open questions. If you must ask questions, ask them as a numbered list. When the human replies, verify that every single numbered question was answered. If any were ignored, HALT and re-ask only the missing questions before proceeding. Keep looping until intent is clear enough to implement.
+3. Version control sanity check. Is the working tree clean? Does the current branch make sense for this intent — considering its name and recent history? If the tree is dirty or the branch is an obvious mismatch, HALT and ask the human before proceeding. If version control is unavailable, skip this check.
+4. Multi-goal check (see SCOPE STANDARD). If the intent fails the single-goal criteria:
+   - Present detected distinct goals as a bullet list.
+   - Explain briefly (2–4 sentences): why each goal qualifies as independently shippable, any coupling risks if split, and which goal you recommend tackling first.
+   - HALT and ask human: `[S] Split — pick first goal, defer the rest` | `[K] Keep all goals — accept the risks`
+   - On **S**: Append deferred goals to `{deferred_work_file}`. Narrow scope to the first-mentioned goal. Continue routing.
+   - On **K**: Proceed as-is.
+5. Generate `spec_file` path:
+   - Derive a valid kebab-case slug from the clarified intent.
+   - If `{implementation_artifacts}/{active_feature}/tech-spec-{slug}.md` already exists, append `-2`, `-3`, etc.
+   - Set `spec_file` = `{implementation_artifacts}/{active_feature}/tech-spec-{slug}.md`.
+6. Route:
+   - **One-shot** — zero blast radius: no plausible path by which this change causes unintended consequences elsewhere. Clear intent, no architectural decisions. `execution_mode = "one-shot"`. → Step 3.
+   - **Plan-code-review** — everything else. `execution_mode = "plan-code-review"`. → Step 2.
+   - When uncertain whether blast radius is truly zero, default to plan-code-review.
+
+
+## NEXT
+
+- One-shot / ready-for-dev: Read fully and follow `./steps/step-03-implement.md`
+- Plan-code-review: Read fully and follow `./steps/step-02-plan.md`
diff --git a/.agents/skills/evo-quick-dev-new-preview/steps/step-02-plan.md b/.agents/skills/evo-quick-dev-new-preview/steps/step-02-plan.md
@@ -0,0 +1,39 @@
+---
+name: 'step-02-plan'
+description: 'Investigate, generate spec, present for approval'
+
+templateFile: '../tech-spec-template.md'
+wipFile: '{implementation_artifacts}/{active_feature}/tech-spec-wip.md'
+deferred_work_file: '{implementation_artifacts}/{active_feature}/deferred-work.md'
+---
+
+# Step 2: Plan
+
+## RULES
+
+- YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`
+- No intermediate approvals.
+
+## INSTRUCTIONS
+
+1. Investigate codebase. _Isolate deep exploration in sub-agents/tasks where available. To prevent context snowballing, instruct subagents to give you distilled summaries only._
+2. Read `{templateFile}` fully. Fill it out based on the intent and investigation, and write the result to `{wipFile}`.
+3. Self-review against READY FOR DEVELOPMENT standard.
+4. If intent gaps exist, do not fantasize, do not leave open questions, HALT and ask the human.
+5. Token count check (see SCOPE STANDARD). If spec exceeds 1600 tokens:
+   - Show user the token count.
+   - HALT and ask human: `[S] Split — carve off secondary goals` | `[K] Keep full spec — accept the risks`
+   - On **S**: Propose the split — name each secondary goal. Append deferred goals to `{deferred_work_file}`. Rewrite the current spec to cover only the main goal — do not surgically carve sections out; regenerate the spec for the narrowed scope. Continue to checkpoint.
+   - On **K**: Continue to checkpoint with full spec.
+
+### CHECKPOINT 1
+
+Present summary. If token count exceeded 1600 and user chose [K], include the token count and explain why it may be a problem. HALT and ask human: `[A] Approve` | `[E] Edit`
+
+- **A**: Rename `{wipFile}` to `{spec_file}`, set status `ready-for-dev`. Everything inside `<frozen-after-approval>` is now locked — only the human can change it. → Step 3.
+- **E**: Apply changes, then return to CHECKPOINT 1.
+
+
+## NEXT
+
+Read fully and follow `./steps/step-03-implement.md`