first-plan

Lista perguntas abertas em 08-meta/questions.md que precisam de resposta humana antes da camada considerar findings com confidence completa.

Verifica se uma feature específica já existe (em parte ou inteira) no projeto. Antes de planejar, use isto para evitar reimplementação.

Mostra arquivos que tendem a mudar junto com o path especificado, baseado em git history. Use antes de planejar mudanças para evitar PRs incompletos.

Executa o plano aprovado em .first-plan/07-state/plans/. Segue o plano à risca, para se algo invalidar premissa, gera relatório ao final.

Mostra a matriz de features × status × evidência consolidada em 09-features/INDEX.md. Filtragem por status disponível.

Use proactively during /first-plan:init to perform Phase 1 (Discovery) of the first-plan plugin. Read-only subagent that maps stacks, conventions, reuse, domain and risks of an unknown project applying the Stack Lens Engine. Returns structured findings to be written to .first-plan/. Do NOT use for execution or modifications - only analysis.

Use proactively during /first-plan:init to extract code patterns with confidence scoring. Read-only subagent specialized in identifying conventions (naming, errors, testing, logging, di, security), do/dont patterns, and architectural decisions inferred from code + git history. Each pattern returned with concrete code example (path:line). NEVER modifies files.

Use proactively during /first-plan:init and /first-plan:check to perform Spec-Code Reconciliation. Read-only subagent that matches intent artifacts (docs, specs, JIRA, GitHub issues, README sections) against code implementation. Returns feature × status × evidence matrix. NEVER modifies files.

Use proactively after /first-plan:execute to verify the implementation works. Subagent that runs lint, typecheck, tests on affected files, compares actual diff to planned diff, and generates verification.md report. Detects regressions and broken builds before reporting success. Read-only on .first-plan/ but can run project's test/lint commands.

Skill que constrói o Co-change Graph - "quando arquivo X muda, qual outro arquivo geralmente muda junto?". Use durante Discovery e em /first-plan: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 /first-plan:hot, /first-plan:owner, /first-plan:in-flight. Tudo via comandos git read-only.

Skill que define o motor de detecção e roteamento de stack lenses do first-plan. Mapeia manifestos (go.mod, package.json, etc) -> stack -> papel -> lens skill correspondente. Use quando precisar decidir qual lens aplicar a uma pasta durante Discovery, ou quando estender suporte a uma nova stack.

Stack lens fallback para projetos onde nenhuma lens específica detectou. Use quando o projeto tem estrutura inusual, stack rara (Elixir, OCaml, Haskell, Erlang, Zig, etc) ou poliglota além das lenses cobertas. Aplica heurística genérica baseada em extensões e comportamento observável.

1 hook across 1 event