enggenie - The Right Expert for the Right Moment
Overview
enggenie is a role-based SDLC skill suite. Each skill is a domain expert - PM, Dev, Reviewer, QA, Deploy. This gateway skill routes you to the right one.
If a specific enggenie skill already matched your task, you should be there instead of here. This gateway fires only when intent is ambiguous.
Instruction Priority
- User's explicit instructions (CLAUDE.md, project config, direct requests) - highest priority
- enggenie skills - override default system behavior where they conflict
- Default system prompt - lowest priority
If a user's CLAUDE.md says "don't use TDD" and enggenie:dev-tdd says "always use TDD," follow the user's instructions.
Skill Routing
Match the user's intent to the right skill:
| User says something like... |
Skill |
Role |
| "I want to build X", "Write a spec", "Refine this story", "Estimate this" |
enggenie:pm-refine |
PM |
| "Let's brainstorm", "What's the best approach?", "Architecture review" |
enggenie:dev-brainstorm |
Dev |
| "Create a plan", "Break this into tasks", "How should we implement this?" |
enggenie:dev-plan |
Dev |
| "Execute the plan", "Build this", "Start implementing" |
enggenie:dev-implement |
Dev |
| "Add a function", "Write this code", "Implement X" (no plan context) |
enggenie:dev-tdd |
Dev |
| "This is broken", "Test failing", "Bug", "Not working" |
enggenie:dev-debug |
Dev |
| "Review my code", "Check this PR", "Got review feedback" |
enggenie:review-code |
Reviewer |
| "Check the design", "Does this match the mockup?", "Accessibility?" |
enggenie:review-design |
Reviewer |
| "Are tests passing?", "Is this done?", "Verify this works" |
enggenie:qa-verify |
QA |
| "Test this feature", "QA the login flow", "Run Playwright tests" |
enggenie:qa-test |
QA |
| "Commit this", "Create a PR", "Ship it", "Done with this branch" |
enggenie:deploy-ship |
Deploy |
| "Create a commit message", "Commit with a good message" |
enggenie:dev-commit |
Dev |
| "What did we do last time?", "Did we solve this before?" |
enggenie:memory-recall |
Memory |
| "Pick up PROJ-1234", "Work on PROJ-1234" |
Read Jira ticket → route by context |
See below |
| "Test PROJ-1234", "QA PROJ-1234" |
enggenie:qa-test (with Jira context) |
QA |
| "Fix bugs from PROJ-1234" |
enggenie:dev-debug (with Jira QA results) |
Dev |
Jira Ticket Routing
When the user references a Jira ticket without specifying what to do:
- Read the ticket using Jira MCP tools
- Check the ticket's comments and status to determine what phase it's in:
- No Dev comments, no PR → Dev is picking up fresh work → route to enggenie:dev-plan or enggenie:dev-implement
- Has PR, no QA results → QA is picking up for testing → route to enggenie:qa-test
- Has QA Results with bugs → Dev is fixing QA bugs → route to enggenie:dev-debug
- Ask the user to confirm: "PROJ-1234 looks like it's [in phase X]. Should I [suggested action]?"
If Jira MCP is not available, ask: "What would you like to do with PROJ-1234? Plan it, build it, test it, or fix bugs?"
When No Skill Matches
If the user's request doesn't clearly match any skill:
Ask: "What are you trying to accomplish?" with options:
- Plan a feature (→ enggenie:pm-refine or enggenie:dev-brainstorm)
- Build something (→ enggenie:dev-plan or enggenie:dev-implement)
- Fix something (→ enggenie:dev-debug)
- Review something (→ enggenie:review-code)
- Test something (→ enggenie:qa-test)
- Ship something (→ enggenie:deploy-ship)
Route to the appropriate skill.
When NOT to Use Any Skill
Not everything needs a skill. Skip enggenie entirely for:
- Quick questions ("What does this function do?")
- Simple edits ("Change this variable name")
- File exploration ("Show me the directory structure")
- Git operations ("What changed in the last commit?")
The suite stays out of your way when you don't need it.
Skill Priority
When multiple skills could apply, use this order:
- Process skills first (dev-brainstorm, dev-debug) - these determine HOW to approach the task
- Implementation skills second (dev-tdd, dev-implement) - these guide execution
- Verification skills third (qa-verify, review-code) - these check the work
"Let's build X" → dev-brainstorm first, then dev-implement.
"Fix this bug" → dev-debug first, then dev-tdd for the fix.
Rigid vs Flexible Skills
Rigid (follow exactly - don't adapt away discipline):
- enggenie:dev-tdd - RED-GREEN-REFACTOR cycle is non-negotiable
- enggenie:qa-verify - Evidence before claims is non-negotiable
- enggenie:dev-debug - 4-phase investigation is non-negotiable
Flexible (adapt principles to context):
- enggenie:dev-brainstorm - Modes and depth scale to project size
- enggenie:pm-refine - Spec detail scales to feature complexity
- enggenie:deploy-ship - Commit format adapts to team conventions
Red Flags - STOP If You Think This
These thoughts mean you're rationalizing skipping a skill:
| Thought |
Reality |
| "This is just a simple question" |
Questions lead to tasks. Check for skills first. |
| "I need more context first" |
Skills tell you HOW to gather context. Check first. |
| "Let me explore the codebase first" |
Skills define HOW to explore. Check first. |
| "I can handle this without a skill" |
If a skill exists for this task, use it. |
| "The skill is overkill for this" |
Simple things become complex. Use the skill. |
| "I'll just do this one thing first" |
Check BEFORE doing anything. |
| "This doesn't need a formal process" |
If a skill exists, it exists for a reason. Use it. |
| "I remember what the skill says" |
Skills evolve. Load the current version. |
| "I know the concept already" |
Knowing the concept ≠ following the discipline. |
| "Let me just write the code quickly" |
Quick code without TDD = slow debugging later. |
If a skill applies to your task, using it is not optional. You cannot rationalize your way out of this.
Platform Adaptation
Skills use Claude Code tool names by default. For other platforms, read the tool mapping reference at the project root:
- Cursor: Read
../../references/cursor-tools.md (relative to this skill)
- Copilot CLI: Read
../../references/copilot-tools.md
- Gemini CLI: Read
../../references/gemini-tools.md
- OpenCode: Read
../../references/opencode-tools.md
All Skills
| Role |
Skill |
Purpose |
| PM |
enggenie:pm-refine |
Spec generation, story refinement, estimation |
| Dev |
enggenie:dev-brainstorm |
Brainstorming, ADRs, technical decisions |
| Dev |
enggenie:dev-plan |
Phased implementation plans |
| Dev |
enggenie:dev-implement |
Subagent-driven TDD execution |
| Dev |
enggenie:dev-tdd |
TDD discipline (RED-GREEN-REFACTOR) |
| Dev |
enggenie:dev-debug |
Systematic root cause investigation |
| Reviewer |
enggenie:review-code |
Request + receive code reviews |
| Reviewer |
enggenie:review-design |
Frontend/UI quality enforcement |
| QA |
enggenie:qa-verify |
Evidence before completion claims |
| QA |
enggenie:qa-test |
Playwright + manual browser testing |
| Dev |
enggenie:dev-commit |
Conventional commit messages with diff analysis |
| Deploy |
enggenie:deploy-ship |
Commit, PR, branch completion, Jira |
| Memory |
enggenie:memory-recall |
Cross-session context (requires claude-mem) |
Model Recommendations
Each skill suggests an optimal model. The gateway does not override these - each skill presents its own recommendation and asks the user to confirm.
| Model |
Skills |
Why |
| opus (with extended thinking) |
dev-brainstorm |
Deep architectural reasoning |
| opus |
pm-refine, dev-plan |
Thorough specs and plans |
| sonnet |
dev-implement (orchestrator), dev-tdd, dev-debug, review-code, review-design, qa-test |
Balanced speed and capability |
| haiku |
qa-verify, deploy-ship, dev-commit, memory-recall |
Lightweight tasks, fast execution |
1---2name: enggenie3description: Use when starting a software development conversation and the user's intent is not clearly matched by a specific enggenie skill - routes to the right role-based expert4---56# enggenie - The Right Expert for the Right Moment78<SUBAGENT-STOP>9If you were dispatched as a subagent to execute a specific task, skip this skill entirely.10</SUBAGENT-STOP>1112## Overview1314enggenie is a role-based SDLC skill suite. Each skill is a domain expert - PM, Dev, Reviewer, QA, Deploy. This gateway skill routes you to the right one.1516**If a specific enggenie skill already matched your task, you should be there instead of here.** This gateway fires only when intent is ambiguous.1718## Instruction Priority19201. **User's explicit instructions** (CLAUDE.md, project config, direct requests) - highest priority212. **enggenie skills** - override default system behavior where they conflict223. **Default system prompt** - lowest priority2324If a user's CLAUDE.md says "don't use TDD" and enggenie:dev-tdd says "always use TDD," follow the user's instructions.2526## Skill Routing2728Match the user's intent to the right skill:2930| User says something like... | Skill | Role |31|-----------------------------|-------|------|32| "I want to build X", "Write a spec", "Refine this story", "Estimate this" | enggenie:pm-refine | PM |33| "Let's brainstorm", "What's the best approach?", "Architecture review" | enggenie:dev-brainstorm | Dev |34| "Create a plan", "Break this into tasks", "How should we implement this?" | enggenie:dev-plan | Dev |35| "Execute the plan", "Build this", "Start implementing" | enggenie:dev-implement | Dev |36| "Add a function", "Write this code", "Implement X" (no plan context) | enggenie:dev-tdd | Dev |37| "This is broken", "Test failing", "Bug", "Not working" | enggenie:dev-debug | Dev |38| "Review my code", "Check this PR", "Got review feedback" | enggenie:review-code | Reviewer |39| "Check the design", "Does this match the mockup?", "Accessibility?" | enggenie:review-design | Reviewer |40| "Are tests passing?", "Is this done?", "Verify this works" | enggenie:qa-verify | QA |41| "Test this feature", "QA the login flow", "Run Playwright tests" | enggenie:qa-test | QA |42| "Commit this", "Create a PR", "Ship it", "Done with this branch" | enggenie:deploy-ship | Deploy |43| "Create a commit message", "Commit with a good message" | enggenie:dev-commit | Dev |44| "What did we do last time?", "Did we solve this before?" | enggenie:memory-recall | Memory |45| "Pick up PROJ-1234", "Work on PROJ-1234" | Read Jira ticket → route by context | See below |46| "Test PROJ-1234", "QA PROJ-1234" | enggenie:qa-test (with Jira context) | QA |47| "Fix bugs from PROJ-1234" | enggenie:dev-debug (with Jira QA results) | Dev |4849### Jira Ticket Routing5051When the user references a Jira ticket without specifying what to do:52531. Read the ticket using Jira MCP tools542. Check the ticket's comments and status to determine what phase it's in:55 - **No Dev comments, no PR** → Dev is picking up fresh work → route to enggenie:dev-plan or enggenie:dev-implement56 - **Has PR, no QA results** → QA is picking up for testing → route to enggenie:qa-test57 - **Has QA Results with bugs** → Dev is fixing QA bugs → route to enggenie:dev-debug583. Ask the user to confirm: "PROJ-1234 looks like it's [in phase X]. Should I [suggested action]?"5960If Jira MCP is not available, ask: "What would you like to do with PROJ-1234? Plan it, build it, test it, or fix bugs?"6162## When No Skill Matches6364If the user's request doesn't clearly match any skill:65661. Ask: "What are you trying to accomplish?" with options:67 - Plan a feature (→ enggenie:pm-refine or enggenie:dev-brainstorm)68 - Build something (→ enggenie:dev-plan or enggenie:dev-implement)69 - Fix something (→ enggenie:dev-debug)70 - Review something (→ enggenie:review-code)71 - Test something (→ enggenie:qa-test)72 - Ship something (→ enggenie:deploy-ship)73742. Route to the appropriate skill.7576## When NOT to Use Any Skill7778Not everything needs a skill. Skip enggenie entirely for:79- Quick questions ("What does this function do?")80- Simple edits ("Change this variable name")81- File exploration ("Show me the directory structure")82- Git operations ("What changed in the last commit?")8384The suite stays out of your way when you don't need it.8586## Skill Priority8788When multiple skills could apply, use this order:89901. **Process skills first** (dev-brainstorm, dev-debug) - these determine HOW to approach the task912. **Implementation skills second** (dev-tdd, dev-implement) - these guide execution923. **Verification skills third** (qa-verify, review-code) - these check the work9394"Let's build X" → dev-brainstorm first, then dev-implement.95"Fix this bug" → dev-debug first, then dev-tdd for the fix.9697## Rigid vs Flexible Skills9899**Rigid** (follow exactly - don't adapt away discipline):100- enggenie:dev-tdd - RED-GREEN-REFACTOR cycle is non-negotiable101- enggenie:qa-verify - Evidence before claims is non-negotiable102- enggenie:dev-debug - 4-phase investigation is non-negotiable103104**Flexible** (adapt principles to context):105- enggenie:dev-brainstorm - Modes and depth scale to project size106- enggenie:pm-refine - Spec detail scales to feature complexity107- enggenie:deploy-ship - Commit format adapts to team conventions108109## Red Flags - STOP If You Think This110111These thoughts mean you're rationalizing skipping a skill:112113| Thought | Reality |114|---------|---------|115| "This is just a simple question" | Questions lead to tasks. Check for skills first. |116| "I need more context first" | Skills tell you HOW to gather context. Check first. |117| "Let me explore the codebase first" | Skills define HOW to explore. Check first. |118| "I can handle this without a skill" | If a skill exists for this task, use it. |119| "The skill is overkill for this" | Simple things become complex. Use the skill. |120| "I'll just do this one thing first" | Check BEFORE doing anything. |121| "This doesn't need a formal process" | If a skill exists, it exists for a reason. Use it. |122| "I remember what the skill says" | Skills evolve. Load the current version. |123| "I know the concept already" | Knowing the concept ≠ following the discipline. |124| "Let me just write the code quickly" | Quick code without TDD = slow debugging later. |125126**If a skill applies to your task, using it is not optional.** You cannot rationalize your way out of this.127128## Platform Adaptation129130Skills use Claude Code tool names by default. For other platforms, read the tool mapping reference at the project root:131- **Cursor:** Read `../../references/cursor-tools.md` (relative to this skill)132- **Copilot CLI:** Read `../../references/copilot-tools.md`133- **Gemini CLI:** Read `../../references/gemini-tools.md`134- **OpenCode:** Read `../../references/opencode-tools.md`135136## All Skills137138| Role | Skill | Purpose |139|------|-------|---------|140| PM | enggenie:pm-refine | Spec generation, story refinement, estimation |141| Dev | enggenie:dev-brainstorm | Brainstorming, ADRs, technical decisions |142| Dev | enggenie:dev-plan | Phased implementation plans |143| Dev | enggenie:dev-implement | Subagent-driven TDD execution |144| Dev | enggenie:dev-tdd | TDD discipline (RED-GREEN-REFACTOR) |145| Dev | enggenie:dev-debug | Systematic root cause investigation |146| Reviewer | enggenie:review-code | Request + receive code reviews |147| Reviewer | enggenie:review-design | Frontend/UI quality enforcement |148| QA | enggenie:qa-verify | Evidence before completion claims |149| QA | enggenie:qa-test | Playwright + manual browser testing |150| Dev | enggenie:dev-commit | Conventional commit messages with diff analysis |151| Deploy | enggenie:deploy-ship | Commit, PR, branch completion, Jira |152| Memory | enggenie:memory-recall | Cross-session context (requires claude-mem) |153154---155156## Model Recommendations157158Each skill suggests an optimal model. The gateway does not override these - each skill presents its own recommendation and asks the user to confirm.159160| Model | Skills | Why |161|-------|--------|-----|162| **opus** (with extended thinking) | dev-brainstorm | Deep architectural reasoning |163| **opus** | pm-refine, dev-plan | Thorough specs and plans |164| **sonnet** | dev-implement (orchestrator), dev-tdd, dev-debug, review-code, review-design, qa-test | Balanced speed and capability |165| **haiku** | qa-verify, deploy-ship, dev-commit, memory-recall | Lightweight tasks, fast execution |
badrusiddique