Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Archbase Refactoring & Migration Planner

    1

    Plan incremental architecture refactoring with dependencies, verification gates and rollback limits. Read-only planning for Next.js App Router; no migration is executed.

    $15

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    Archbase Refactoring & Migration Planner

    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

    ResponsabilidadeEvidência atualProposta
    Rota e apresentaçãoapp/orders/page.tsx:2–4 consulta e renderiza pedidosManter a página assíncrona e a composição de <main> e <p>, delegando a leitura à aplicação
    Caso de uso de listar pedidosapp/orders/page.tsx:3: db.orders.findMany()Criar features/orders/application/list-orders.ts, independente de React, rotas e respostas HTTP
    Acesso a dadosinfra/db.ts:1 exporta um stub com findManyCriar um adaptador em features/orders/data/orders-repository.ts, restrito ao servidor, inicialmente delegando ao stub existente
    Contrato dos dadosinfra/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 → destinoEvidênciaImpacto
    app/orders/page.tsx → infra/db.tsImport relativo em page.tsx:1; export correspondente em infra/db.ts:1Aresta direta que será substituída
    OrdersPage → db.orders.findMany()page.tsx:3Leitura a preservar sem filtros, ordenação ou transformações adicionais
    Resultado → elementos <p>page.tsx:4Cada 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, /orders renderiza um <main> contendo um <p> com First.
    • 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.ts
    • features/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, app ou 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çãoResultado esperado
    /orders com o stub atualMesmo <main> e um parágrafo com First
    Lista vazia<main> sem parágrafos de pedidos
    Vários pedidosUm parágrafo por pedido, na mesma ordem
    Falha de leituraMesmo comportamento observável registrado na fase 1
    Contrato HTTPURL, status e cabeçalhos relevantes iguais à referência registrada
    Build e fronteirasNenhuma dependência de persistência introduzida no cliente; página permanece Server Component
    Ensaio de rollbackRestaurar 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.yaml e 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.

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    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

    Requires

    SKILL.md-compatible AI agent

    Permissions

    Read Files

    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.

    Listed12 days ago

    What's inside

    Frequently Asked Questions

    No. It returns analysis and proposed next steps. Implementation, script execution and other actions require separate authorization.

    No. The bundled instructions and textual references work with a SKILL.md-compatible agent; no extra runtime, CLI or project MCP is required.

    6 real independent local Codex CLI supplied-snapshot scenarios. This does not certify framework builds, other agents or delivery through Agensi.

    No. It respects adopted local conventions, scoped overrides and configuration errors, distinguishing them from catalog recommendations.

    The reusable original workflow and templates. Public canonical references remain MIT; legitimately generated project-specific results are usable under the license. Do not resell or redistribute the skill.

    Message the creator on Agensi with a minimal redacted example. Support is best effort. Platform purchase and refund policies apply.

    New in Code Quality & Review