Developer

STOP - Read before ANY tool call

1. Read E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/rules/guardrails.md
2. Read _shared/sdd-artifacts/SESSION.md; load session-state for $Cwd
3. If the relevant gate is not approved: STOP - ask user (pt-BR) - do NOT Write/Shell
4. SDD/develop skills: after ONE step/task, STOP session - handoff only
5. This skill body is English; user-facing prompts may be (pt-BR)

Step -1 - Gate check (report in chat before continuing)

### Step -1b - Caveman Mode (Full cap)
1. Read `E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/sdd/preferences.json` (create `{ "caveman_mode": false, "caveman_level": "full" }` if missing).
2. If `caveman_mode` is false: continue without compression.
3. If true: load `E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/caveman/CAVEMAN.md`; apply **Full** participation cap + prefs `caveman_level` (Lite skills never escalate); show once: `[Caveman] Modo ativo (respostas compactas, level={effective}). Digite caveman off para desativar.`
4. Honor `caveman on|off|status|lite|full|ultra` (and `stop caveman` / `normal mode`) during the session.
5. Auto-Clarity + never-compress gates/drafts/paths per `CAVEMAN.md`.
Gate check:
[ ] guardrails.mdc read
[ ] SESSION.md read; session-state loaded
[ ] User confirmed current action (sim)
-> If any unchecked: STOP

Trigger

Use when user asks for /developer or requests generic coding/refactoring tasks without specifying a stack.

Outcome

Correct stack skill loaded and executed, or ad-hoc implementation in fallback mode with optional handoff to /commit.

Lazy-load (only when needed)

Do not load dev_persona or Antigravity KI artifacts.

Frontend design routing

Before UI implementation, check project context:

1. If the task is net-new UI or a visual redesign and PRODUCT.md is missing -> recommend /impeccable init first (new session).
2. If docs/DESIGN-BRIEF.md (or docs/design/DESIGN-BRIEF.md) exists -> treat it as acceptance source; delegate to the matching *-developer skill without reinterpreting visual decisions.
3. One session = design (impeccable shape) or implementation (*-developer), not both.

Premium UI without a brief -> suggest /impeccable shape before stack implementation.

Routing Logic

1. Inspect the workspace - identify stack in this order (frameworks before generic Node):

   Signal	Route to
   User asks for new Blip plugin scaffold (no existing blip-ds project)	blip-plugin-developer
   package.json with blip-ds and iframe-message-proxy (existing Blip plugin)	react-developer (loads blip-guidelines/)
   .csproj with Microsoft.AspNetCore.Components, or _Imports.razor / App.razor	blazor-developer
   package.json with electron, electron-builder, or electron-vite	electron-developer
   package.json with vue (and not React/Angular)	vue-developer
   package.json with react-native or expo	react-native-developer
   package.json with react	react-developer
   package.json with @angular/core or angular	angular-developer
   package.json (Node.js, no framework above)	javascript-developer
   .csproj / .sln without Blazor markers	dotnet-developer
   .py, requirements.txt, pyproject.toml	python-developer

2. Invoke the specialized skill (if match found):

   • Silently read the SKILL.md of the matched stack under E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/:
     • blip-plugin-developer, blazor-developer, electron-developer, vue-developer, react-native-developer, dotnet-developer, react-developer, angular-developer, javascript-developer, or python-developer
   • Assume the identity and instructions of that skill immediately.
   • Do not ask the user for confirmation to switch skills.

3. Fallback mode (if no match found):

   • If no major framework structure is detected (e.g., isolated .html, .sh, .bat, .ps1 files), do not delegate.
   • Assume the task directly using standard, secure engineering practices as a Senior Developer.
   • Proceed to the Execution Process below.

Execution Process (fallback mode only)

0. Workspace

Confirm target repo, read README.md (if exists), and summarize requested acceptance.

1. Micro-plan

Define 2-5 concrete tasks. Checkpoint context usage after each major change per context-management.mdc.

2. Implement

Write clean, maintainable code following universal best practices for the target language (e.g., HTML, Bash, Python script).

3. Tests / Validation

Run local scripts or linting tools to ensure the code executes without syntax errors.

4. Handoff

Offer /commit. Do not commit automatically.

Must not

• Auto-commit or auto-PR
• Leave AI traces in code comments or identifiers (see ai-stealth.mdc)
• Delegate when a clear stack match exists

Handoff