By vynazevedo
Compile a structured multi-layer project context (.first-plan/) that enables plan-first development with spec-code reconciliation, git intelligence, and reuse detection. Plan features, verify implementation fidelity, and navigate unfamiliar codebases with stack-aware discovery.
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 /fp: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 /fp: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 /fp:init and /fp: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 /fp: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 /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 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.
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Quick Start - How It Works - Commands - Stack Lenses - Philosophy - Configuration - Troubleshooting - License
Stop Claude Code from inventing new patterns. Make it follow your codebase's existing conventions, on cold session start, with absolute adherence.
first-plan compiles your project into a structured context layer (.first-plan/) - so Claude knows your stacks, conventions, idioms, hot files, and which features are real vs phantom before it writes a single line of code.
Install via the Claude Code plugin marketplace:
/plugin marketplace add vynazevedo/first-plan
/plugin install fp
/fp:quick/fp:quick
In ~1-5 seconds, generates .first-plan/quick/00-glance.md with:
main.*, index.*, server.*)That's the first impression - enough context for Claude to start helping immediately, without waiting.
/fp:init/fp:init
In ~3-8 minutes, generates the full 10-layer IR: stack lens analysis, reuse index, spec-code reconciliation, co-change graph, provenance tracking, living layer. This is what makes the difference between Claude inventing a new auth pattern vs Claude using your internal/auth/jwt.go as the template.
/plugin marketplace add /local/path/to/first-plan
/plugin install fp@first-plan
npx claudepluginhub vynazevedo/first-plan --plugin fpProject discovery, planning, and quality analysis system with parallel agents
Commands for loading context and priming Claude for specific tasks
AI Development Environment - Multi-agent orchestration for Claude Code
GSD Core is a meta-prompting, context engineering, and spec-driven development system for AI coding agents.
Context-Driven Development plugin that transforms Claude Code into a project management tool with structured workflow: Context → Spec & Plan → Implement
Comprehensive feature development workflow with specialized agents for codebase exploration, architecture design, and quality review