nerviz

↑ ↓ para mover · Enter para abrir · Esc para fecharToque em um resultado

Arquitetura
skill · classe design · opus

http-client-architect

Projeta o adaptador HTTP de saída: client, pool, timeouts, retry, resiliência e autenticação de saída.

skill · designopusescreve 28-cliente-http.mdsó dentro de docs/use-cases/UC-*/**
§ o arquivo que ela escreve

28-cliente-http.md, bloco a bloco

O bank-app ainda não tem 28-cliente-http.md. Estes são os blocos que o SKILL.md diz que o parcial contém.

## 1 · Operations

Per port method: dependency, remote call with the documentation link, idempotency and key source, read timeout and its origin, the domain outcomes

## 2 · Client

The client per dependency, the matrix row, the rejected ones, exemplars

## 3 · Engine and pool

Engine, pinned factory, pool sizes and their arithmetic, lease timeout, eviction, engine retry off

## 4 · Outbound authentication

Scheme per dependency, where each credential lives, the exemplar

## 5 · Retry and resilience

The retrying layer, attempts and backoff, breaker, bulkhead, fallback

## 6 · Project-wide setup

Each shared component with NEW / REUSE / CHANGE

## 7 · Configuration

Every property, its value, the environment variable behind each secret

## 8 · Declared dependencies

Coordinates, version empty when managed or read from maven-metadata.xml

## 9 · Contract test cases

Per port method, the mandatory cases with family, errorCode and attempts

## 10 · Requirements to other partials

Key, state, column, reconciliation pass, security impact — requirements only

## 11 · Deferred

Same shape as every partial's Deferred

## Design patterns

Each pattern adopted — step 13b. none when none

§ comportamento

O que lê, escreve e recusa

O contrato da própria skill, do SKILL.md, no texto original.

Class

design — the territory is skill_classes.design in @.claude/schemas/extensions.json, and ArchHook.java guard enforces it. Writes inside the use case folder and nothing else; an adapter written under src/ is refused with exit 2.

Reads

docs/use-cases/UC-NNN-<slug>/00-use-case.md and 10-domain.md (mandatory — stops without the second), 30-rest.md and 32-security.md when present, earlier cases' 28-http-client.md, pom.xml (or the Gradle build), src/main/resources/application*.yml, the outbound wiring on disk, the active blueprint's packages.map, @.claude/rules/http-client.md, @.claude/rules/error-handling.md, @.claude/rules/api-rest.md, @.claude/rules/architecture-ddd.md, @.claude/rules/logging.md, @.claude/rules/observability.md, and references/. Reads Maven Central's maven-metadata.xml for an unmanaged dependency's version.

Writes

docs/use-cases/UC-NNN-<slug>/28-http-client.md. Nothing else.

Owns

each operation's client, timeouts, retry policy and failure table; the project's HTTP engine and pool; the retrying layer of each outbound call; breaker and bulkhead; the outbound authentication wiring; and the project-wide outbound setup.

Does not decide

the use case boundary or its External calls fact (00-use-case.md), the port, its domain types, the idempotency key field or the unknown-outcome state (10-domain.md), tables and columns (20-persistence.md), the reconciliation schedule (35-jobs.md), the inbound chain (32-security.md), or the test shape (40-tests.md). Does not write Java, pom.xml or application.yml — the executor does, from this partial. Doesn't touch .claude/rules/**. Does not design reactive (WebFlux) applications.

Fonte: SKILL.md § Contract, no nerviz e4cae27.

§ guard e hook

O que o guard faz com ela

design é a classe da skill. O ArchHook abre uma fase quando a skill é chamada e confere cada escrita contra o território da classe. O texto à direita é o do próprio hook.

write_allow da classe design

  • ✓docs/use-cases/UC-*/**
  • ✓docs/use-cases/BACKLOG.md
  • src/**: migrations e classes são do executor
  • docker-compose.yml: arquivo de outra classe
  • caso de uso já aprovado: as specs ficam congeladas

A recusa sai com código 2 e a mensagem volta para o modelo.

PreToolUse  Skill(http-client-architect)
  audit call                       exit 0
  guard call                       exit 0
# a skill of another class replaces the phase
# write_allow: docs/use-cases/UC-*/**, docs/use-cases/BACKLOG.md
§ orquestração

Onde ela fica no trilho

Cada cartão é um passo do /new-feature; a seta leva o parcial que um passo entrega ao seguinte. Passos tracejados só rodam quando o caso de uso precisa.

/new-feature orchestrator · opus
/new-feature-implement Quem lê o parcial depois

Depois da aprovação, o /new-feature-implement faz o executor construir o código. A spec é consolidada por referência e vale onde ela e um parcial divergem; o parcial é lido, por seção, para o detalhe.

28-cliente-http.mddocs/use-cases/UC-NNN-…/
lido por seção, para o detalhe
java-spring-boot-developeragent · executor
escreve o código
src/**desenha um caso de uso numa spec, não escreve código
← voltar às cadeias