tibursocampos STOP - Read before ANY tool call
- Read
E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/rules/guardrails.md - Read
_shared/sdd-artifacts/SESSION.md; load session-state for$Cwd - If the relevant gate is not approved: STOP - ask user (pt-BR) - do NOT Write/Shell
- SDD/develop skills: after ONE step/task, STOP session - handoff only
- This skill body is English; user-facing prompts may be (pt-BR)
Step -1 - Gate check (report in chat before continuing)
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 /javascript-developer, js fix, node fix, or a small isolated JavaScript/TypeScript implementation.
Outcome
Working JS/TS code and tests in the target workspace, validated with tests/build, with optional handoff to /commit.
When to escalate to SDD
Recommend sdd-spec -> sdd-plan -> sdd-develop for multi-service, large API surface, or 10+ file changes.
DESIGN-BRIEF acceptance
If docs/DESIGN-BRIEF.md or docs/design/DESIGN-BRIEF.md exists with target_stack: html-css, treat it as the acceptance source. Map to DOM/vanilla or light libs; do not reinterpret visual decisions.
If the task is net-new UI without a brief, recommend /impeccable shape in a new session before implementing.
Lazy-load references
| When | Path |
|---|---|
| Design brief | docs/DESIGN-BRIEF.md or docs/design/DESIGN-BRIEF.md |
| Branch / commit | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/rules/branch-validation.mdc, E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/developer-common/step-3-branching.md |
| JavaScript guidelines | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/javascript-guidelines/ |
Frontend core (html-css / DOM work) |
E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/frontend-guidelines/frontend-practices.md |
DOM patterns (html-css stack) |
E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/javascript-guidelines/dom-patterns.md |
Markup / styles (html-css stack) |
E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/html-css-guidelines/ |
| Principles | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/code-guidelines/principles/ |
| Context | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/rules/context-management.mdc |
| Caveman Mode (if active) | E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/caveman/CAVEMAN.md |
Do not preload unrelated guideline trees.
Process
Step -1b - Caveman Mode (Full cap)
- Read
E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/sdd/preferences.json(create{ "caveman_mode": false, "caveman_level": "full" }if missing). - If
caveman_modeis false: continue without compression. - If true: load
E:/Source/Repos/agent-dev-toolkit/scripts/validation/fixtures/install-root/skills/_shared/caveman/CAVEMAN.md; apply Full participation cap + prefscaveman_level(Lite skills never escalate); show once:[Caveman] Modo ativo (respostas compactas, level={effective}). Digite caveman off para desativar. - Honor
caveman on|off|status|lite|full|ultra(andstop caveman/normal mode) during the session. - Auto-Clarity + never-compress gates/drafts/paths per
CAVEMAN.md.
0. Workspace
Confirm Node/JS project (package.json). Summarize acceptance.
1. Guidelines
Load only required JavaScript/TypeScript guidelines for this task.
2. Branch
Use feature/<slug> or feat/<id>.
3. Micro-plan
Define 3-7 concrete tasks; checkpoint context at >= 40%.
4. Implement
Node.js/JS ecosystem best practices. Match existing patterns.
5. Tests
Jest/Mocha/Vitest per project configuration.
6. Validate
npm test
npm run build
7. Handoff
Offer /commit. Do not commit automatically.
Must not
- Auto-commit or auto-PR
- Leave AI traces in code or identifiers
Handoff
| Situation | Next |
|---|---|
| Commit | /commit |
| Review | /code-review |
| Scope grew | sdd-spec -> sdd-plan -> sdd-develop |
| Missing design brief | /impeccable shape (new session) |