sinapse-ai 5.0.8 → 6.0.1

package/docs/guides/agents/traces/pm-execution-trace.md

@@ -1,7 +1,7 @@
-# @pm (Morgan) - Execution Trace
+# @project-lead (Morgan) - Execution Trace
 
 > Traced from source code, not documentation.
-> Agent definition: `.sinapse-ai/development/agents/pm.md`
+> Agent definition: `.sinapse-ai/development/agents/project-lead.md`
 
 ## 1. Activation Trace
 
@@ -9,7 +9,7 @@
 
 | Order | File | Loader | Purpose |
 |-------|------|--------|---------|
-| 1 | `.sinapse-ai/development/agents/pm.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
+| 1 | `.sinapse-ai/development/agents/project-lead.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
 | 2 | `.sinapse-ai/core-config.yaml` | GreetingBuilder._loadConfig() | Core configuration |
 | 3 | `.sinapse-ai/data/agent-config-requirements.yaml` | AgentConfigLoader.loadRequirements() | Config sections: devStoryLocation, storyBacklog |
 | 4 | `.sinapse-ai/data/workflow-patterns.yaml` | WorkflowNavigator._loadPatterns() | Workflow state detection |
@@ -119,7 +119,7 @@ pm:
 
 | Task File | Used By | Status |
 |-----------|---------|--------|
-| `correct-course.md` | Delegated to @sinapse-master | EXISTS |
+| `correct-course.md` | Delegated to @sinapse-orqx | EXISTS |
 | `execute-checklist.md` | Checklist execution | EXISTS |
 
 ---
@@ -455,14 +455,14 @@ graph TD
 
 | Interaction | Direction | Trigger |
 |-------------|-----------|---------|
-| @pm -> @po | Provides | PRDs and strategic direction |
-| @pm -> @sm | Delegate | Story creation via `*draft` |
-| @pm -> @analyst | Delegate | Deep research via `*research` |
-| @pm -> @architect | Collaborate | Technical architecture decisions |
-| @pm -> @sinapse-master | Escalate | Course corrections via `*correct-course` |
-| @pm -> @devops | Delegate | Git push operations, PR creation |
-| @analyst -> @pm | Receives | Project brief for PRD creation |
-| @sinapse-master -> @pm | Receives | Framework modification requests |
+| @project-lead -> @product-lead | Provides | PRDs and strategic direction |
+| @project-lead -> @sprint-lead | Delegate | Story creation via `*draft` |
+| @project-lead -> @analyst | Delegate | Deep research via `*research` |
+| @project-lead -> @architect | Collaborate | Technical architecture decisions |
+| @project-lead -> @sinapse-orqx | Escalate | Course corrections via `*correct-course` |
+| @project-lead -> @devops | Delegate | Git push operations, PR creation |
+| @analyst -> @project-lead | Receives | Project brief for PRD creation |
+| @sinapse-orqx -> @project-lead | Receives | Framework modification requests |
 
 ### Delegation Rules (from agent definition)
 
@@ -485,7 +485,7 @@ PM must NEVER emulate other agents within its context window. When a task requir
 | ExecutorAssignment | `.sinapse-ai/core/orchestration/executor-assignment.js` | EXISTS |
 | PM Script | `.sinapse-ai/scripts/pm.sh` | EXISTS |
 
-**Delegates to @sm when:**
+**Delegates to @sprint-lead when:**
 - Story creation from epics
 - Sprint planning and story breakdown
 
@@ -498,7 +498,7 @@ PM must NEVER emulate other agents within its context window. When a task requir
 - Technical architecture decisions
 - Technology selection
 
-**Escalates to @sinapse-master when:**
+**Escalates to @sinapse-orqx when:**
 - Course corrections detected
 - Framework modifications needed
 

package/docs/guides/agents/traces/po-execution-trace.md

@@ -1,7 +1,7 @@
-# @po (Pax) - Execution Trace
+# @product-lead (Pax) - Execution Trace
 
 > Traced from source code, not documentation.
-> Agent definition: `.sinapse-ai/development/agents/po.md`
+> Agent definition: `.sinapse-ai/development/agents/product-lead.md`
 
 ## 1. Activation Trace
 
@@ -9,7 +9,7 @@
 
 | Order | File | Loader | Purpose |
 |-------|------|--------|---------|
-| 1 | `.sinapse-ai/development/agents/po.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
+| 1 | `.sinapse-ai/development/agents/product-lead.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
 | 2 | `.sinapse-ai/core-config.yaml` | GreetingBuilder._loadConfig() | Core configuration |
 | 3 | `.sinapse-ai/data/agent-config-requirements.yaml` | AgentConfigLoader.loadRequirements() | Config sections: devStoryLocation, prd, storyBacklog, templatesLocation |
 | 4 | `.sinapse-ai/data/workflow-patterns.yaml` | WorkflowNavigator._loadPatterns() | Workflow state detection |
@@ -116,7 +116,7 @@ po:
 | `*yolo` | (built-in) | full | No |
 | `*exit` | (built-in) | full | No |
 
-**NOTE:** `create-epic` and `create-story` have been REMOVED from @po. Epic creation is delegated to @pm, story creation is delegated to @sm.
+**NOTE:** `create-epic` and `create-story` have been REMOVED from @po. Epic creation is delegated to @project-lead, story creation is delegated to @sm.
 
 ---
 
@@ -535,28 +535,28 @@ graph TD
 
 | Interaction | Direction | Trigger |
 |-------------|-----------|---------|
-| @sm -> @po | Coordinates | Backlog prioritization and sprint planning |
-| @pm -> @po | Provides | Strategic direction, PRDs, requirements |
-| @po -> @sm | Delegate | Story creation via `*draft` |
-| @po -> @pm | Delegate | Epic creation via `*create-epic` |
-| @po -> @sinapse-master | Escalate | Course corrections via `*correct-course` |
-| @po -> @analyst | Delegate | Research via `*research` |
-| @po -> @devops | Delegate | Git push operations, PR creation |
-| @pm -> @po | Receives | Story validation requests via `*validate-story-draft` |
-| @sm -> @po | Receives | Backlog prioritization via `*backlog-prioritize` |
-| @qa -> @po | Receives | Quality gate review via `*backlog-review` |
+| @sprint-lead -> @product-lead | Coordinates | Backlog prioritization and sprint planning |
+| @project-lead -> @product-lead | Provides | Strategic direction, PRDs, requirements |
+| @product-lead -> @sprint-lead | Delegate | Story creation via `*draft` |
+| @product-lead -> @project-lead | Delegate | Epic creation via `*create-epic` |
+| @product-lead -> @sinapse-orqx | Escalate | Course corrections via `*correct-course` |
+| @product-lead -> @analyst | Delegate | Research via `*research` |
+| @product-lead -> @devops | Delegate | Git push operations, PR creation |
+| @project-lead -> @product-lead | Receives | Story validation requests via `*validate-story-draft` |
+| @sprint-lead -> @product-lead | Receives | Backlog prioritization via `*backlog-prioritize` |
+| @quality-gate -> @product-lead | Receives | Quality gate review via `*backlog-review` |
 
 ### Delegation Rules (from agent definition)
 
-**Delegates to @sm when:**
+**Delegates to @sprint-lead when:**
 - Story creation is needed (uses `*draft` command)
 - Sprint coordination requires SM facilitation
 
-**Delegates to @pm when:**
+**Delegates to @project-lead when:**
 - Epic creation is needed (uses `*create-epic` command)
 - Strategic direction or PRD creation is required
 
-**Delegates to @sinapse-master when:**
+**Delegates to @sinapse-orqx when:**
 - Course corrections are needed (uses `*correct-course` command)
 - Systemic issues require orchestrator-level intervention
 

package/docs/guides/agents/traces/qa-execution-trace.md

@@ -1,7 +1,7 @@
-# @qa (Quinn) - Execution Trace
+# @quality-gate (Quinn) - Execution Trace
 
 > Traced from source code, not documentation.
-> Agent definition: `.sinapse-ai/development/agents/qa.md`
+> Agent definition: `.sinapse-ai/development/agents/quality-gate.md`
 
 ## 1. Activation Trace
 
@@ -9,7 +9,7 @@
 
 | Order | File | Loader | Purpose |
 |-------|------|--------|---------|
-| 1 | `.sinapse-ai/development/agents/qa.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
+| 1 | `.sinapse-ai/development/agents/quality-gate.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
 | 2 | `.sinapse-ai/core-config.yaml` | GreetingBuilder._loadConfig() | Core configuration |
 | 3 | `.sinapse-ai/data/agent-config-requirements.yaml` | AgentConfigLoader.loadRequirements() | Config sections: qaLocation, dataLocation, storyBacklog |
 | 4 | `.sinapse-ai/data/workflow-patterns.yaml` | WorkflowNavigator._loadPatterns() | Workflow state detection |
@@ -337,10 +337,10 @@ flowchart TD
     D --> E[Generate actionable fix descriptions]
     E --> F[Map fixes to specific files/lines]
     F --> G["Output: QA_FIX_REQUEST.md for @dev"]
-    G --> H[Handoff to @dev for resolution]
+    G --> H[Handoff to @developer for resolution]
 ```
 
-**Cross-agent:** Generates `QA_FIX_REQUEST.md` consumed by @dev (Epic 6 - QA Loop).
+**Cross-agent:** Generates `QA_FIX_REQUEST.md` consumed by @developer (Epic 6 - QA Loop).
 
 ---
 
@@ -772,21 +772,21 @@ graph TD
 
 | Interaction | Direction | Trigger |
 |-------------|-----------|---------|
-| @dev -> @qa | Receives | Story marked "Ready for Review" triggers QA review |
-| @qa -> @dev | Handoff | `*create-fix-request` generates `QA_FIX_REQUEST.md` for @dev |
-| @coderabbit -> @qa | Receives | Automated code review findings consumed by QA analysis |
-| @qa -> @github-devops | Delegate | Git push operations, PR creation after QA approval |
-| @sm -> @qa | Receives | Sprint risk profiling requests |
-| @po -> @qa | Receives | Spec critique requests via `*critique-spec` |
+| @developer -> @quality-gate | Receives | Story marked "Ready for Review" triggers QA review |
+| @quality-gate -> @developer | Handoff | `*create-fix-request` generates `QA_FIX_REQUEST.md` for @developer |
+| @coderabbit -> @quality-gate | Receives | Automated code review findings consumed by QA analysis |
+| @quality-gate -> @github-devops | Delegate | Git push operations, PR creation after QA approval |
+| @sprint-lead -> @quality-gate | Receives | Sprint risk profiling requests |
+| @product-lead -> @quality-gate | Receives | Spec critique requests via `*critique-spec` |
 
 ### Delegation Rules (from agent definition)
 
-**Receives from @dev when:**
+**Receives from @developer when:**
 - Story is marked "Ready for Review"
 - Code is committed (not pushed yet)
-- @dev requests code quality feedback
+- @developer requests code quality feedback
 
-**Delegates to @dev when:**
+**Delegates to @developer when:**
 - QA findings require code fixes (`*create-fix-request`)
 - Self-healing loop identifies CRITICAL/HIGH issues needing fix
 
@@ -822,7 +822,7 @@ self_healing:
 **Git restrictions:**
 - ALLOWED: `git status`, `git log`, `git diff`, `git branch -a`
 - BLOCKED: `git push`, `git commit`, `gh pr create`
-- Redirect: QA reviews, doesn't commit. Use @dev for commits, @github-devops for push.
+- Redirect: QA reviews, doesn't commit. Use @developer for commits, @github-devops for push.
 
 **Story file permissions:**
 - ONLY authorized to update "QA Results" section of story files

package/docs/guides/agents/traces/{sinapse-master-execution-trace.md → sinapse-orqx-execution-trace.md}

@@ -1,7 +1,7 @@
-# @sinapse-master (Orion) - Execution Trace
+# @sinapse-orqx (Orion) - Execution Trace
 
 > Traced from source code, not documentation.
-> Agent definition: `.sinapse-ai/development/agents/sinapse-master.md`
+> Agent definition: `.sinapse-ai/development/agents/sinapse-orqx.md`
 
 ## 1. Activation Trace
 
@@ -9,7 +9,7 @@
 
 | Order | File | Loader | Purpose |
 |-------|------|--------|---------|
-| 1 | `.sinapse-ai/development/agents/sinapse-master.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
+| 1 | `.sinapse-ai/development/agents/sinapse-orqx.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
 | 2 | `.sinapse-ai/core-config.yaml` | GreetingBuilder._loadConfig() | Core configuration |
 | 3 | `.sinapse-ai/data/agent-config-requirements.yaml` | AgentConfigLoader.loadRequirements() | Config sections: dataLocation, registry |
 | 4 | `.sinapse-ai/data/workflow-patterns.yaml` | WorkflowNavigator._loadPatterns() | Workflow state detection |
@@ -29,7 +29,7 @@
 ```mermaid
 sequenceDiagram
     participant CC as Claude Code
-    participant AMd as sinapse-master.md
+    participant AMd as sinapse-orqx.md
     participant ACL as AgentConfigLoader
     participant GB as GreetingBuilder
     participant GPM as GreetingPreferenceManager
@@ -40,7 +40,7 @@ sequenceDiagram
 
     CC->>AMd: Load agent file (STEP 1)
     CC->>AMd: Adopt persona (STEP 2)
-    CC->>ACL: loadAgentDefinition('sinapse-master')
+    CC->>ACL: loadAgentDefinition('sinapse-orqx')
     ACL-->>CC: { agent: { name: 'Orion', icon: '👑' }, commands: [...33], ... }
 
     CC->>GB: new GreetingBuilder()
@@ -72,7 +72,7 @@ sequenceDiagram
 From `agent-config-requirements.yaml`:
 
 ```yaml
-sinapse-master:
+sinapse-orqx:
   config_sections:
     - dataLocation
     - registry
@@ -719,7 +719,7 @@ These are built-in commands handled by the agent framework, not external task fi
 | `*chat-mode` | Starts conversational assistance mode (freeform interaction) |
 | `*doc-out` | Outputs complete document content |
 | `*yolo` | Toggles confirmation skipping mode |
-| `*exit` | Exits sinapse-master mode, returns to base Claude Code |
+| `*exit` | Exits sinapse-orqx mode, returns to base Claude Code |
 | `*agent {name}` | Reads and displays info about a specialized agent (use `@` to transform into it) |
 | `*list-components` | Scans .sinapse-ai/ and lists all framework components (agents, tasks, workflows, templates, checklists) |
 | `*test-memory` | Tests memory layer connection and reports status |
@@ -731,7 +731,7 @@ These are built-in commands handled by the agent framework, not external task fi
 ```mermaid
 graph TD
     subgraph "Agent Definition"
-        AD[sinapse-master.md]
+        AD[sinapse-orqx.md]
     end
 
     subgraph "Activation Pipeline"
@@ -922,18 +922,18 @@ graph TD
 
 | Interaction | Direction | Trigger |
 |-------------|-----------|---------|
-| @sinapse-master -> @pm | Delegate | Epic/story creation (brownfield-create-epic, brownfield-create-story) |
-| @sinapse-master -> @analyst | Delegate | Brainstorming sessions (*brainstorm) |
-| @sinapse-master -> @qa | Delegate | Test suite creation (*create-suite) |
-| @sinapse-master -> @architect | Delegate | AI prompt generation (*generate-ai-prompt) |
-| @sinapse-master -> @dev | Handoff | Story implementation after story creation |
-| @sinapse-master -> @devops | Delegate | Git push operations, PR creation |
-| @sinapse-master -> any agent | Execute | Can execute any task from any agent directly |
-| Any agent -> @sinapse-master | Escalate | Cross-agent coordination, framework operations |
+| @sinapse-orqx -> @project-lead | Delegate | Epic/story creation (brownfield-create-epic, brownfield-create-story) |
+| @sinapse-orqx -> @analyst | Delegate | Brainstorming sessions (*brainstorm) |
+| @sinapse-orqx -> @quality-gate | Delegate | Test suite creation (*create-suite) |
+| @sinapse-orqx -> @architect | Delegate | AI prompt generation (*generate-ai-prompt) |
+| @sinapse-orqx -> @developer | Handoff | Story implementation after story creation |
+| @sinapse-orqx -> @devops | Delegate | Git push operations, PR creation |
+| @sinapse-orqx -> any agent | Execute | Can execute any task from any agent directly |
+| Any agent -> @sinapse-orqx | Escalate | Cross-agent coordination, framework operations |
 
 ### Delegation Rules (from agent definition)
 
-**Delegates to @pm when:**
+**Delegates to @project-lead when:**
 - Epic creation is needed (brownfield-create-epic)
 - Story creation within an epic (brownfield-create-story)
 - PRD management and backlog prioritization
@@ -942,7 +942,7 @@ graph TD
 - Brainstorming sessions are requested
 - Research and analysis tasks
 
-**Delegates to @qa when:**
+**Delegates to @quality-gate when:**
 - Test suite creation (*create-suite)
 - Quality gate execution
 
@@ -969,10 +969,10 @@ graph TD
 
 | Task Type | Recommended Agent |
 |-----------|-------------------|
-| Story implementation | @dev |
-| Code review | @qa |
-| PRD creation | @pm |
-| Story creation | @sm (or @pm for epics) |
+| Story implementation | @developer |
+| Code review | @quality-gate |
+| PRD creation | @project-lead |
+| Story creation | @sprint-lead (or @project-lead for epics) |
 | Architecture | @architect |
 | Database | @data-engineer |
 | UX/UI | @ux-design-expert |

package/docs/guides/agents/traces/sm-execution-trace.md

@@ -1,7 +1,7 @@
-# @sm (River) - Execution Trace
+# @sprint-lead (River) - Execution Trace
 
 > Traced from source code, not documentation.
-> Agent definition: `.sinapse-ai/development/agents/sm.md`
+> Agent definition: `.sinapse-ai/development/agents/sprint-lead.md`
 
 ## 1. Activation Trace
 
@@ -9,7 +9,7 @@
 
 | Order | File | Loader | Purpose |
 |-------|------|--------|---------|
-| 1 | `.sinapse-ai/development/agents/sm.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
+| 1 | `.sinapse-ai/development/agents/sprint-lead.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
 | 2 | `.sinapse-ai/core-config.yaml` | GreetingBuilder._loadConfig() | Core configuration |
 | 3 | `.sinapse-ai/data/agent-config-requirements.yaml` | AgentConfigLoader.loadRequirements() | Config sections: devStoryLocation, storyBacklog, dataLocation |
 | 4 | `.sinapse-ai/data/workflow-patterns.yaml` | WorkflowNavigator._loadPatterns() | Workflow state detection |
@@ -304,34 +304,34 @@ graph TD
 
 | Interaction | Direction | Trigger |
 |-------------|-----------|---------|
-| @po -> @sm | Receives | Backlog prioritization, story validation requests |
-| @pm -> @sm | Receives | Epic structure for story breakdown |
-| @sm -> @dev | Handoff | Completed stories for implementation |
-| @sm -> @devops | Delegate | Git push operations, PR creation after story completion |
-| @sm <-> @po | Collaborate | Sprint planning, backlog grooming |
+| @product-lead -> @sprint-lead | Receives | Backlog prioritization, story validation requests |
+| @project-lead -> @sprint-lead | Receives | Epic structure for story breakdown |
+| @sprint-lead -> @developer | Handoff | Completed stories for implementation |
+| @sprint-lead -> @devops | Delegate | Git push operations, PR creation after story completion |
+| @sprint-lead <-> @product-lead | Collaborate | Sprint planning, backlog grooming |
 
 ### Delegation Rules (from agent definition)
 
-**Coordinates with @po when:**
+**Coordinates with @product-lead when:**
 - Backlog prioritization and grooming
 - Sprint planning
-- Story validation (`@po *validate-story-draft`)
+- Story validation (`@product-lead *validate-story-draft`)
 
-**Receives from @pm when:**
+**Receives from @project-lead when:**
 - Epic structure is ready for story breakdown
 - Strategic direction for sprint goals
 
-**Hands off to @dev when:**
+**Hands off to @developer when:**
 - Story is drafted, validated, and ready for implementation
-- Developer receives story via `@dev *develop`
+- Developer receives story via `@developer *develop`
 
 **Delegates to @devops when:**
 - Git push operations to remote repository
 - Pull request creation and management
 - Remote branch operations
 
-**Escalates to @sinapse-master when:**
-- Course corrections needed (`@sinapse-master *correct-course`)
+**Escalates to @sinapse-orqx when:**
+- Course corrections needed (`@sinapse-orqx *correct-course`)
 
 **Git restrictions:**
 - ALLOWED: `git status`, `git log`, `git diff`, `git branch`, `git branch -d`, `git checkout -b`, `git checkout`, `git merge`

package/docs/guides/agents/traces/squad-creation-execution-trace.md

@@ -640,20 +640,20 @@ graph TD
 
 | Interaction | Direction | Trigger |
 |-------------|-----------|---------|
-| @squad-creator -> @dev | Handoff | Squad created, needs code implementation |
-| @squad-creator -> @qa | Handoff | Squad created, needs quality review |
+| @squad-creator -> @developer | Handoff | Squad created, needs code implementation |
+| @squad-creator -> @quality-gate | Handoff | Squad created, needs quality review |
 | @squad-creator -> @devops | Delegate | Publishing, deployment, git push operations |
-| @sinapse-master -> @squad-creator | Invokes | Component creation (agents, tasks, workflows) |
-| @pm -> @squad-creator | Receives | Requirements for new squads |
+| @sinapse-orqx -> @squad-creator | Invokes | Component creation (agents, tasks, workflows) |
+| @project-lead -> @squad-creator | Receives | Requirements for new squads |
 | @architect -> @squad-creator | Receives | Architecture decisions affecting squad structure |
 
 ### Collaboration Rules (from agent definition)
 
-**Delegates to @dev when:**
+**Delegates to @developer when:**
 - Squad code needs implementation
 - Custom scripts/tools within squad need development
 
-**Delegates to @qa when:**
+**Delegates to @quality-gate when:**
 - Squad implementation needs review
 - Quality validation beyond structural checks
 
@@ -663,10 +663,10 @@ graph TD
 - CI/CD pipeline configuration for squad testing
 
 **Cross-agent component creation:**
-- Creates agent definitions that @dev implements
-- Creates task workflows that @dev follows
+- Creates agent definitions that @developer implements
+- Creates task workflows that @developer follows
 - Creates templates that other agents consume
-- Creates checklists that @qa executes
+- Creates checklists that @quality-gate executes
 
 ---
 

package/docs/guides/agents/traces/ux-design-expert-execution-trace.md

@@ -893,11 +893,11 @@ graph TD
 | Interaction | Direction | Trigger |
 |-------------|-----------|---------|
 | @architect -> @ux-design-expert | Collaborate | Frontend architecture, user flows, component hierarchy |
-| @ux-design-expert -> @dev | Handoff | Design specs, component blueprints for implementation |
+| @ux-design-expert -> @developer | Handoff | Design specs, component blueprints for implementation |
 | @ux-design-expert -> @analyst | Collaborate | User research planning, data analysis |
 | @ux-design-expert -> @devops | Delegate | Git push operations, PR creation |
-| @po -> @ux-design-expert | Receives | Design stories, UX requirements |
-| @qa -> @ux-design-expert | Validate | Component quality checklists, accessibility audits |
+| @product-lead -> @ux-design-expert | Receives | Design stories, UX requirements |
+| @quality-gate -> @ux-design-expert | Validate | Component quality checklists, accessibility audits |
 
 ### Collaboration Rules (from agent definition)
 
@@ -906,7 +906,7 @@ graph TD
 - Component hierarchy and integration patterns
 - Technology stack decisions affecting UX
 
-**Hands off to @dev (Dex):**
+**Hands off to @developer (Dex):**
 - Design specifications and component blueprints
 - Token definitions and design system configurations
 - Component implementations with TypeScript + tests

package/docs/guides/api-reference.md

@@ -87,7 +87,7 @@ SINAPSE provides a unified API for interacting with specialized AI agents throug
 | `@data-engineer` | Dara   | Architect    | Database schema, migrations, queries     |
 | `@devops`        | Gage   | Optimizer    | CI/CD, deployment, git operations        |
 | `@ux-expert`     | Uma    | Creator      | UI/UX design, wireframes                 |
-| `@sinapse-master`   | Orion  | Orchestrator | Framework orchestration, meta-operations |
+| `@sinapse-orqx`   | Orion  | Orchestrator | Framework orchestration, meta-operations |
 
 ### Activation Behavior
 
@@ -116,8 +116,8 @@ When an agent is activated:
 You can activate an agent and execute a command in one step:
 
 ```bash
-@dev *develop story-1.2.3
-@qa *review story-1.2.3
+@developer *develop story-1.2.3
+@quality-gate *review story-1.2.3
 @architect *create-full-stack-architecture
 ```
 
@@ -165,7 +165,7 @@ Task execution with arguments: { story: "story-1.2.3" }
 
 ## Agent-Specific Commands
 
-### @dev (Developer)
+### @developer (Developer)
 
 **Story Development:**
 
@@ -228,7 +228,7 @@ Task execution with arguments: { story: "story-1.2.3" }
 
 ---
 
-### @qa (Quality Assurance)
+### @quality-gate (Quality Assurance)
 
 **Code Review:**
 
@@ -260,7 +260,7 @@ Task execution with arguments: { story: "story-1.2.3" }
 
 | Command               | Arguments    | Description                         |
 | --------------------- | ------------ | ----------------------------------- |
-| `*create-fix-request` | `{story-id}` | Generate QA_FIX_REQUEST.md for @dev |
+| `*create-fix-request` | `{story-id}` | Generate QA_FIX_REQUEST.md for @developer |
 
 **Test Strategy:**
 
@@ -303,7 +303,7 @@ Task execution with arguments: { story: "story-1.2.3" }
 
 ---
 
-### @pm (Product Manager)
+### @project-lead (Product Manager)
 
 **Document Creation:**
 
@@ -330,7 +330,7 @@ Task execution with arguments: { story: "story-1.2.3" }
 
 ---
 
-### @sm (Scrum Master)
+### @sprint-lead (Scrum Master)
 
 **Story Management:**
 
@@ -391,7 +391,7 @@ Task execution with arguments: { story: "story-1.2.3" }
 
 ---
 
-### @sinapse-master (Orchestrator)
+### @sinapse-orqx (Orchestrator)
 
 **Framework Development:**
 
@@ -445,7 +445,7 @@ Task execution with arguments: { story: "story-1.2.3" }
 
 ```bash
 # Start workflow
-@sinapse-master *workflow greenfield-fullstack
+@sinapse-orqx *workflow greenfield-fullstack
 
 # With parameters
 *workflow brownfield-service --target=./services/auth
@@ -471,7 +471,7 @@ phases:
     tasks:
       - create-full-stack-architecture
   - name: implementation
-    agent: dev
+    agent: developer
     tasks:
       - develop
 ```
@@ -551,7 +551,7 @@ phases:
     "currentStatus": "Draft",
     "requiredStatus": "Ready for Dev"
   },
-  "suggestions": ["Update story status to 'Ready for Dev'", "Contact @pm to approve story"]
+  "suggestions": ["Update story status to 'Ready for Dev'", "Contact @project-lead to approve story"]
 }
 ```
 
@@ -621,10 +621,10 @@ Claude Code is the primary supported IDE with full integration:
 **Agent Commands (Slash Commands):**
 
 ```
-/dev          → Activates @dev agent
-/qa           → Activates @qa agent
+/dev          → Activates @developer agent
+/qa           → Activates @quality-gate agent
 /architect    → Activates @architect agent
-/sinapse-master  → Activates @sinapse-master agent
+/sinapse-orqx  → Activates @sinapse-orqx agent
 ```
 
 **Directory Structure:**
@@ -710,7 +710,7 @@ alwaysApply: false
 
 ```bash
 # 1. Gather requirements
-@pm *gather-requirements
+@project-lead *gather-requirements
 
 # 2. Assess complexity
 @architect *assess-complexity story-1.2.3
@@ -719,10 +719,10 @@ alwaysApply: false
 @analyst *research-deps "authentication libraries"
 
 # 4. Write specification
-@pm *write-spec
+@project-lead *write-spec
 
 # 5. Critique specification
-@qa *critique-spec story-1.2.3
+@quality-gate *critique-spec story-1.2.3
 
 # 6. Create implementation plan
 @architect *create-plan story-1.2.3
@@ -731,10 +731,10 @@ alwaysApply: false
 @architect *create-context story-1.2.3
 
 # 8. Execute subtasks
-@dev *execute-subtask 1.1
+@developer *execute-subtask 1.1
 
 # 9. Review build
-@qa *review-build story-1.2.3
+@quality-gate *review-build story-1.2.3
 ```
 
 ### Example 3: Recovery Flow
@@ -766,10 +766,10 @@ alwaysApply: false
 @devops *create-worktree STORY-42
 
 # 2. Develop in isolation
-@dev *develop STORY-42
+@developer *develop STORY-42
 
 # 3. QA review
-@qa *review STORY-42
+@quality-gate *review STORY-42
 
 # 4. Merge back
 @devops *merge-worktree STORY-42
@@ -782,7 +782,7 @@ alwaysApply: false
 
 ```bash
 # 1. Activate master orchestrator
-@sinapse-master
+@sinapse-orqx
 
 # 2. Enable knowledge base
 *kb
@@ -833,7 +833,7 @@ What do you need?
 │  └─ @ux-expert
 │
 └─ Framework/Orchestration?
-   └─ @sinapse-master
+   └─ @sinapse-orqx
 ```
 
 ---
@@ -852,11 +852,11 @@ Each agent has a specific responsibility boundary. Using the correct agent ensur
 
 For complex features, follow the ADE spec pipeline:
 
-1. `@pm *gather-requirements` - Collect requirements
+1. `@project-lead *gather-requirements` - Collect requirements
 2. `@architect *assess-complexity` - Estimate effort
 3. `@analyst *research-deps` - Research constraints
-4. `@pm *write-spec` - Write specification
-5. `@qa *critique-spec` - Validate quality
+4. `@project-lead *write-spec` - Write specification
+5. `@quality-gate *critique-spec` - Validate quality
 
 ### 3. Track Everything