0146 · A design skill owns the inbound GraphQL adapter, chosen per use case in the Trigger row, over the same input port a REST adapter calls
openbooklet.com/s/0146-a-design-skill-owns-the-inbound-graphql-adapter-chosen-per-use-case-in-the-trigger-row-over-the-same-input-port-a-rest-adapter-callsopenbooklet.com/s/0146-a-design-skill-owns-the-inbound-graphql-adapter-chosen-per-use-case-in-the-trigger-row-over-the-same-input-port-a-rest-adapter-calls@1.0.0GET /api/v1/skills/0146-a-design-skill-owns-the-inbound-graphql-adapter-chosen-per-use-case-in-the-trigger-row-over-the-same-input-port-a-rest-adapter-calls- **Date:** 2026-10-13 - **Scenario:** "Criar a skill de design graphql-api-architect: partial 31-graphql.md, par do 30-rest.md do rest-api-architect â o adapter de entrada GraphQL de um caso de uso já modelado, sobre Spring for GraphQL no stack servlet, schema-first, @Controller com @QueryMappin
`/spike <slug>` creates `../<project>-spike-<slug>` on branch `spike/<slug>` and reduces that worktree's `.claude/settings.json` to the hooks `spike.keep_modes` lists. The main checkout never relaxes, and this session stays enforced; the person opens `claude` in the worktree.
- **Date:** 2026-09-10 - **Scenario:** Criar skill responsável por dockerização/containerização. Docker e docker-compose básicos nascem no `project-bootstrap`; extensões (serviço de DB, config de Testcontainers) acontecem depois, disparadas por skills do `/new-feature` quando necessário. -
- **Date:** 2026-09-11 - **Scenario:** "Finalize the skill documented to be created (`messaging-adapter`) â messaging protocols are plural (Kafka, RabbitMQ, SNS, SQS, JMS); decide whether to build one generic skill dispatching to per-tech skills, or one skill per technology; and clarify how broker
- **Date:** 2026-09-11 - **Scenario:** at the end of a successful `/init-project` run, and at the end of a successful `java-spring-boot-developer` run, present the user the option to create a git repo, commit, and push the project. - **Decision:** Form 1 (auto-invocable skill, chained by name) â `
- **Date:** 2026-09-30 - **Scenario:** "quero adicionar uma nova skill para ser injetada no agent java-spring-boot-developer de boas praticas de codigos java baseado em regras do sonarqube" â revised mid-interview to: "na verdade nao há configuracao de sonarqube para avaliacao real. Ao invés de
- **Date:** 2026-09-30 - **Scenario:** "quero criar uma skill que é executada a partir do projeto gerado que: 1. rodar sonar 2. extrai relatorio de bugs, issues, duplicacao, cobertura de codigo 3. baseado nas regras do projeto descritas no .claude, gera um arquivo lessons-learning como foco em melh
- **Date:** 2026-10-02 - **Scenario:** "quero criar uma nova skill de conhecimento de codigo para aplicar quando pedido em uma new feature a parte de seguranca com apis rests (spring-security). Se durante entrevista de caso de uso for mencionado ou perguntado por seguranca da api, roles, apenas grup
- **Date:** 2026-10-05 - **Scenario:** "Criar o http-client-architect: skill de design do adapter HTTP de saÃda (cliente REST) de um caso de uso já modelado, no pipeline /new-feature depois de domain-modeling declarar o port de saÃda e antes de test-architect. Inclui as famÃlias de erro de infra
Pulls this architecture into the project the session is rooted at. One operation, two starting states: the project has no `.claude/` of this shape yet (install), or it has one and is behind (update). The difference is the provenance stamp, not a different command.
Keeps `docker-compose.yml` and `Dockerfile` in sync with what the project actually needs, **after** they're born. `project-bootstrap` writes the base pair â one `app` service, nothing else â at project creation. Every service added afterward (Postgres, MySQL, a broker) goes through this skill, s
Chooses and implements a design pattern in Java/Spring from the symptom that justifies it. Use when the request involves a design pattern, Strategy, Factory, Decorator, Builder, Specification, "how to structure this class", a growing if/switch chain, or refactoring a class with too many responsibilities.
Creates the complete initial structure of a Spring Boot project from a declarative architecture blueprint. Use when the user asks to create a project from scratch, start a new project, set up a project, scaffolding, "new Spring project", bootstrap, generate a module structure, create a multi-module Maven or Gradle project, build a hexagonal architecture, clean architecture, onion, layered, vertical slice or modular monolith, or when the /init-project command is run.
Designs **how the use case is exposed over HTTP**: what endpoints exist, what DTOs go in and out, what status each result returns, what error body arises from each domain exception, how the collection is paginated, and what OpenAPI has to document. What `domain-modeling` left as an inbound port, thi
Designs **who may call each endpoint and how the caller proves who it is**: the authentication mechanism of the project, the request rules and method-security annotations of each endpoint, the claims-to-authorities mapping, the ownership check a use case runs, and what the API answers when the proof
Runs this project's SonarQube analysis, extracts the quality gate, bugs, vulnerabilities, code smells, duplication and coverage through the SonarQube Web API, traces every group of findings to the norm, template or Checkstyle setting in `.claude/` that produced it, and writes `docs/lessons-learned/sonar-NNN.md` focused on fixing the cause so the next analysis has fewer issues or none. Ends with the `/report-issue` command that files it on the Nerviz repository, where the fix belongs. Explicit invocation only.
Two things, and the argument decides which:
Auto-indexed from nerviz-ai/nerviz
Are you the author? Claim this skill to take ownership and manage it.
Related Skills
graceful-error-recovery
Use this skill when a tool call, command, or API request fails. Diagnose the root cause systematically before retrying or changing approach. Do not retry the same failing call without first understanding why it failed.
audience-aware-communication
Use this skill when writing any explanation, documentation, or response that will be read by someone else. Match vocabulary, depth, and format to the audience's expertise level before writing.
Refactoring Expert
Expert in systematic code refactoring, code smell detection, and structural optimization. Use PROACTIVELY when encountering duplicated code, long methods, complex conditionals, or any code quality issues. Detects code smells and applies proven refactoring techniques without changing external behavior.
Research Expert
Specialized research expert for parallel information gathering. Use for focused research tasks with clear objectives and structured output requirements.
clarify-ambiguous-requests
Use this skill when the user's request is ambiguous, under-specified, or could be interpreted in multiple ways. If proceeding with a wrong assumption would waste significant work, always ask exactly one focused clarifying question before doing anything.
structured-step-by-step-reasoning
Use this skill for any problem that involves multiple steps, tradeoffs, or non-trivial logic. Think out loud before answering to improve accuracy and transparency. Apply whenever the answer is not immediately obvious.