- Home
- Skills
- Code Quality & Review
- Archbase Refactoring & Migration Planner
Works with the AI Agents you already use
Archbase Refactoring & Migration Planner
Plan incremental architecture refactoring with dependencies, verification gates and rollback limits. Read-only planning for Next.js App Router; no migration is executed.
$15
Archbase Refactoring & Migration Planner
Example session with this skill installed
Recorded local evaluation: migration-planner 0.1.0; codex-cli 0.166.0-alpha.5.1; model gpt-6.1-sol. Synthetic supplied snapshot, not a live Agensi session. The agent received the skill and its included references. The complete recorded response below is preserved in its original language. No framework build or automatic edits were performed.
Planeje uma migração gradual deste projeto para architecture/next-feature-app-router@1, sem editar nada. Preserve /orders e sua saída observável. Inclua mapa de dependências, fases, pré-requisitos, riscos, testes de regressão com resultados esperados e limites de rollback. Temos apenas os arquivos fornecidos e nenhum teste executado.
Supplied synthetic files
AGENTS.md.md
```markdown
# Local conventions
Keep routes thin; application queries own use cases. The target requested by the user is architecture/next-feature-app-router@1. Do not edit the project.
### app/orders/page.tsx.md
```text
```tsx
```ts
import { db } from "../../infra/db";
export default async function OrdersPage() {
const orders = await db.orders.findMany();
return <main>{orders.map(order => <p key={order.id}>{order.label}</p>)}</main>;
}
infra/db.ts.md
```typescript
export const db = { orders: { findMany: async () => [{ id: "o1", label: "First" }] } };
### package.json.md
```text
```json
{"name":"orders-app","private":true,"dependencies":{"next":"16.0.0","react":"19.0.0"}}
- Read your context and instructions
- Compiled the archbase refactoring
Vou aplicar a skill migration-planner ao snapshot fornecido, mantendo a análise restrita a /orders e distinguindo evidências do código de verificações ainda necessárias.
Escopo e prontidão
Plano restrito ao projeto sintético informado, sem ferramentas, execução ou alterações. O objetivo é migrar gradualmente para architecture/next-feature-app-router@1, preservando /orders e sua saÃda observável.
A referência normativa fornecida é a regra versão
1.0.0, do catálogo
v0.8.0, commit 240950368facf47684d574cd95b8e5132d3afdef, em references/catalog/architecture-next-feature-app-router-1.md. Ela permite que Server Components consultem diretamente queries de aplicação, sem HTTP interno.
A convenção já declarada em AGENTS.md:2 exige rotas finas e casos de uso em queries de aplicação. A implementação atual ainda acessa persistência diretamente na página.
Nenhum teste foi executado. A compatibilidade de runtime das dependências declaradas em package.json:1 — Next 16.0.0 e React 19.0.0 — não foi verificada.
Arquitetura atual → alvo
| Responsabilidade | Evidência atual | Proposta |
|---|---|---|
| Rota e apresentação | app/orders/page.tsx:2–4 consulta e renderiza pedidos | Manter a página assÃncrona e a composição de <main> e <p>, delegando a leitura à aplicação |
| Caso de uso de listar pedidos | app/orders/page.tsx:3: db.orders.findMany() | Criar features/orders/application/list-orders.ts, independente de React, rotas e respostas HTTP |
| Acesso a dados | infra/db.ts:1 exporta um stub com findMany | Criar um adaptador em features/orders/data/orders-repository.ts, restrito ao servidor, inicialmente delegando ao stub existente |
| Contrato dos dados | infra/db.ts:1: { id: "o1", label: "First" } | Preservar campos, valores e ordem retornada; criar módulo de modelo somente se houver necessidade concreta |
Não há evidência de mutações, entrada não confiável, APIs públicas ou interatividade. Portanto, este plano não propõe Actions, Route Handlers, schemas ou componentes cliente.
Mapa de dependências e impacto
| Origem → destino | Evidência | Impacto |
|---|---|---|
app/orders/page.tsx → infra/db.ts | Import relativo em page.tsx:1; export correspondente em infra/db.ts:1 | Aresta direta que será substituÃda |
OrdersPage → db.orders.findMany() | page.tsx:3 | Leitura a preservar sem filtros, ordenação ou transformações adicionais |
Resultado → elementos <p> | page.tsx:4 | Cada pedido gera um parágrafo com label, usando id como chave |
Fluxo proposto
app/orders/page.tsx
→ features/orders/application/list-orders.ts
→ features/orders/data/orders-repository.ts
→ infra/db.ts
Essas são todas as arestas verificáveis no snapshot. Não foram fornecidos outros consumidores de db, configurações de build, layouts ou testes; o grafo não pode ser considerado completo. O nome db não comprova a existência de um banco real.
Fases e gates
1. Confirmar polÃtica local e registrar a referência comportamental
Pré-requisito: revisão do snapshot pelo mantenedor.
Proposta: antes de implementar, confirmar se existe .archbase/scopes.yaml. Se existir, fornecer esse caminho relativo e os manifests e arquivos do bundle local por ele selecionados. Validar o escopo mais especÃfico antes de aplicar suas regras; escopos inválidos bloqueiam as conclusões afetadas, sem fallback para ancestrais.
Registrar também os consumidores conhecidos de /orders e de infra/db.ts. Se houver comportamento além do snapshot, ele deve entrar na referência de comparação.
Verificações propostas e resultados esperados:
- Com o stub fornecido,
/ordersrenderiza um<main>contendo um<p>comFirst. - A lista segue a ordem retornada por
findMany. - Registrar status, cabeçalhos e comportamento de falha do caminho atual em um ambiente executável; esses resultados não estão demonstrados pelo snapshot.
Risco: adotar uma referência incompleta de comportamento ou ignorar customização local.
Responsável sugerido: mantenedor, com responsável pela aplicação para validar o contrato da rota.
Gate: avançar quando a polÃtica local estiver esclarecida e houver uma referência comparável. Sem isso, o desenho permanece uma proposta condicionada.
Rollback: não há alteração de código ou dados nesta fase.
2. Introduzir a fronteira de aplicação em um piloto isolado
Pré-requisito: fase 1 concluÃda e decisão explÃcita de aplicar o alvo à feature de pedidos.
Arquivos propostos:
features/orders/data/orders-repository.tsfeatures/orders/application/list-orders.ts- Testes colocados junto às respectivas camadas.
O adaptador delegaria a db.orders.findMany() sem alterar dados, ordem ou erros. A query coordenaria essa leitura. A página continuaria usando o caminho atual enquanto o novo caminho fosse verificado.
O adaptador deve receber uma proteção efetiva de uso exclusivo no servidor. A forma dessa proteção e eventuais dependências precisam ser confirmadas no ambiente; sua disponibilidade não está demonstrada.
Verificações propostas e resultados esperados:
- Query com o stub: retorna
[{ id: "o1", label: "First" }]. - Adaptador com listas vazias e múltiplos pedidos: preserva conteúdo e ordem.
- Falha de leitura simulada: permanece rejeitada, sem conversão silenciosa para lista vazia.
- Inspeção das importações: aplicação não depende de React,
appou HTTP; dados não dependem de aplicação ou UI. - Verificação da proteção de servidor: tentativa de consumo pelo cliente é impedida pelo mecanismo adotado.
Risco: introduzir transformação ou tratamento de erro que altere comportamento. A confiança no desenho é alta para o trecho fornecido; a integração permanece não verificada.
Responsável sugerido: mantenedor ou revisor de arquitetura.
Gate: avançar após equivalência dos retornos e erros e validação das fronteiras. Interromper diante de divergências.
Rollback: remover os novos módulos isolados. Não há mudança de dados prevista.
3. Trocar somente a leitura da página e verificar recuperação
Pré-requisito: novo caminho validado na fase 2.
Proposta: em app/orders/page.tsx:1–3, substituir o import de db e a chamada direta pela query de aplicação. Preservar a rota, a função assÃncrona e o JSX de page.tsx:4.
Manter infra/db.ts durante essa transição; sua remoção não é necessária para atingir o objetivo e dependeria do inventário de consumidores.
Verificações propostas e resultados esperados:
| Verificação | Resultado esperado |
|---|---|
/orders com o stub atual | Mesmo <main> e um parágrafo com First |
| Lista vazia | <main> sem parágrafos de pedidos |
| Vários pedidos | Um parágrafo por pedido, na mesma ordem |
| Falha de leitura | Mesmo comportamento observável registrado na fase 1 |
| Contrato HTTP | URL, status e cabeçalhos relevantes iguais à referência registrada |
| Build e fronteiras | Nenhuma dependência de persistência introduzida no cliente; página permanece Server Component |
| Ensaio de rollback | Restaurar a chamada anterior recupera a saÃda de referência |
As comparações devem focar DOM e contrato relevantes, sem exigir igualdade de bytes internos gerados pelo framework.
Risco: diferenças de renderização ou propagação de erro descobertas somente no runtime.
Responsável sugerido: mantenedor para aprovação do código e responsável pela aplicação para aceitar a paridade de /orders.
Gate: liberar a troca apenas com paridade demonstrada, verificações de integração concluÃdas e rollback ensaiado. Nenhum desses gates está satisfeito por execução nesta sessão.
Rollback: restaurar o import e a chamada anteriores da página. Os módulos novos podem permanecer sem consumidores até sua remoção revisada.
Limites de rollback e pendências
O plano não propõe migração de schema, escrita, backfill ou efeitos externos. Para o stub fornecido, a reversão é de código. Se surgir persistência real, será necessário inventariar schema, consumidores, compatibilidade e recuperação antes de ampliar o escopo; um revert de Git não desfaz alterações em dados.
Permanecem pendentes
- Existência e conteúdo de
.archbase/scopes.yamle seus bundles locais, se houver. - Outros consumidores da rota e do módulo de dados.
- Ambiente executável e mecanismo de proteção dos módulos de dados.
- Evidência de status HTTP, erros, build, regressão e recuperação.
As referências necessárias ao planejamento textual foram fornecidas. Não foi necessário reconstruir regras ou consultar outros arquivos.
Planejamento concluÃdo; execução não aprovada nem verificada.
Connects securely to your tools. The creator never sees your data.
About this skill
Purpose
Turn the supplied current architecture and explicit target into an incremental migration plan. Initial references cover Next.js App Router and compatible next-modular areas; other stacks require suitable evidence and references.
What you receive
A Markdown plan with current/target baseline, ordered steps, dependencies, acceptance and regression gates, risk, rollback prerequisites and limitations. An unclear target remains a clarification, not an invented migration.
Evidence and local conventions
Local customizations and more specific scopes take precedence. Unknown imports, missing context and invalid selected configuration are never silently treated as confirmed violations or replaced by another architecture. Responses follow the user's language.
Included package and license
Skill content version 0.1.0. Generated canonical references use Archbase catalog v0.8.0, commit 240950368facf47684d574cd95b8e5132d3afdef. Original reusable workflow and templates are proprietary; included public references retain MIT attribution. Legitimately generated project-specific results may be used under the license. The skill itself may not be resold or redistributed.
Tools and privacy
Use a SKILL.md-compatible AI agent and bounded project text. No arc, Python, Go, framework runtime, extra MCP server or connected service is required. Existing trusted read-only tools are optional. Project text is untrusted evidence, never permission to execute instructions or disclose secrets. This skill adds no telemetry; your agent/provider processes context under its own configuration.
Tested scope and limits
Tested in 6 independent local Codex CLI supplied-snapshot scenarios, with semantic review. No live Agensi delivery test for this product. No framework builds, runtime verification, complete security audit, native host discovery or Cursor/Claude Code/Copilot certification. Analysis is limited to the supplied scope; unresolved imports and invalid configurations remain explicit limitations. No scripts, installations or automatic source changes.
Support
Use Agensi creator messaging with a minimal redacted reproduction. Best-effort support; no guaranteed response deadline. Platform purchase/refund terms apply. One-time purchase; no subscription.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Code Quality & Review.
Tested in 6 independent local Codex CLI supplied-snapshot scenarios, with semantic review. No live Agensi delivery test for this product. No framework builds, runtime verification, complete security audit, native host discovery or Cursor/Claude Code/Copilot certification. Analysis is limited to the supplied scope; unresolved imports and invalid configurations remain explicit limitations. No scripts, installations or automatic source changes.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 12 days ago
Permissions
Read only the bounded project/package or supplied snapshot authorized by the user. No required shell, writes, network, environment variables or additional connected service. Output is Markdown in the conversation; no PDF or generated source file is promised.