菜单
Stack lens para Node/TypeScript. Use durante Discovery quando package.json for detectado. Cobre Next.js, NestJS, Vite SPA, Express, Astro, Remix, Nuxt, plain Node, monorepos pnpm/turbo/nx.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Skill que constrói o Co-change Graph - "quando arquivo X muda, qual outro arquivo geralmente muda junto?". Use durante Discovery e em /fp:cochange. Baseado em git history. Detecta arquivos co-dependentes que devem ser editados juntos para evitar PRs incompletos. v0.3.0+ usa engine nativo Rust quando disponível (10-100x mais rápido).
Skill que detecta e instala o binário nativo first-plan-engine (Rust) na primeira invocação. Use quando algum command (cochange, hash, futuramente ast/index/search) for invocado e o binário não estiver presente. Oferece download via GitHub Releases. Plugin funciona sem o engine (graceful fallback), mas com ele fica 10-100x mais rápido.
Skill que extrai inteligência do git history - heatmap de atividade, ownership, branches/PRs in-flight. Use durante Discovery e em /fp:hot, /fp:owner, /fp:in-flight. Tudo via comandos git read-only.
Skill que define como o comando /fp:plan emite um plano detalhado para uma feature. Use quando precisar gerar plano que respeite a camada compilada, verifique duplicidade contra 09-features, identifique reuse e siga template em meta-templates/plan.md. Sempre pausa pedindo aprovação ao final.
Esta skill DEVE ser carregada em qualquer comando do plugin first-plan. Define o protocolo PLAN-FIRST (Discovery -> Plan -> Approval -> Execution -> Report), as 7 regras invioláveis e o comportamento esperado em cada fase. Ative quando o usuário invocar /fp:* ou mencionar "first-plan", "context compilation", "discovery layer", "spec-code reconciliation".
Skill que define o schema de proveniência e o sistema de freshness tracking para findings em .first-plan/. Use durante Discovery e refresh para registrar source (file:line@SHA), TTL, confidence inicial e cadeia de supersedeção. Aplica decay de confidence baseado em idade.
| name | first-plan-lens-typescript |
| description | Stack lens para Node/TypeScript. Use durante Discovery quando package.json for detectado. Cobre Next.js, NestJS, Vite SPA, Express, Astro, Remix, Nuxt, plain Node, monorepos pnpm/turbo/nx. |
| version | 0.1.0 |
Pelo package.json + arquivos auxiliares:
| Sinal | Variante |
|---|---|
next.config.{js,ts,mjs} | Next.js |
nest-cli.json ou @nestjs/* em deps | NestJS |
vite.config.{js,ts} sem framework | SPA Vite |
vite.config.{js,ts} + @sveltejs/kit | SvelteKit |
astro.config.{js,ts,mjs} | Astro |
remix.config.{js,ts} | Remix |
@nuxt/kit ou nuxt.config.{js,ts} | Nuxt |
expo em deps | Expo (mobile) |
react-native em deps | React Native bare |
electron em deps | Electron |
bin field no package.json sem framework | CLI Node |
express ou fastify em deps | Backend tradicional |
pnpm-workspace.yaml | Monorepo pnpm |
turbo.json | Turborepo |
nx.json | Nx |
"type": "module" no package.json -> ESMtsconfig.json -> verificar strict, noImplicitAny, paths, target, modulezod em deps -> Zodyup em deps -> Yupio-ts -> io-tsclass-validator + class-transformer -> nestjs-stylevalibot, arktype -> opções modernasjoi -> Joi (legacy)Verificar onde validação acontece (boundary handlers? service layer?)
.then/.catch ou async/await?RxJS em deps -> reactive style (comum em Angular/NestJS)Effect library?Result<T, E> library (neverthrow, effect)vitest, jest, mocha, ava, tap?vitest.config.ts, jest.config.js)playwright, cypress, webdriverio)?vi.mock, jest.mock, sinon, nock (HTTP)?zustand, redux, jotai, recoil, pinia, mobx, Context apenas)@tanstack/react-query, swr, apollo, urql, server components)react-hook-form, formik, superforms)next-intl, i18next)@Injectable, @Inject)pino, winston, bunyan?console.log direto (smell).first-plan/Igual lens-go (stacks, architecture, boundaries, errors, testing, di, logging, reuse).
Adicional para frontend:
03-reuse/components.md - componentes UI (priorizar Server Components, hooks compartilhados, layout components)03-reuse/hooks.md - custom hooks reusáveisAumentar:
tsconfig.strict: true + projeto sem any -> alta confiança no padrão "evitar any"Reduzir:
any em projeto strict// @ts-ignore ou // @ts-expect-error sem comentário explicandoconsole.log em produçãoprocess.env.X sem schema (smell - deveria ter validação central)useEffect com lista de deps incorreta (React)